<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-size: 16px; font-family: Times, sans-serif;">
<div>We have defined the stokes parameters for NXmx, but I missed porting that back into NXbeam. </div>
<div><br>
</div>
<div>The manual says:</div>
<div><br>
</div>
<div><strong style="font-family: 'Lucida Grande', 'Lucida Sans Unicode', Geneva, Verdana, sans-serif; font-size: 14px; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal; letter-spacing: -0.14px; line-height: 21px; widows: 1; background-color: rgb(255, 255, 255);">incident_polarisation_stokes[np,
 4]</strong><span style="font-family: 'Lucida Grande', 'Lucida Sans Unicode', Geneva, Verdana, sans-serif; font-size: 14px; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal; letter-spacing: -0.14px; line-height: 21px; widows: 1; background-color: rgb(255, 255, 255);">: </span><em style="color: rgb(202, 121, 0); font-family: 'Lucida Grande', 'Lucida Sans Unicode', Geneva, Verdana, sans-serif; font-size: 14px; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal; letter-spacing: -0.14px; line-height: 21px; widows: 1; background-color: rgb(255, 255, 255);"><a class="reference internal" href="http://download.nexusformat.org/sphinx/nxdl-types.html#nx-char" style="color: rgb(202, 121, 0); font-family: 'Lucida Grande', 'Lucida Sans Unicode', Geneva, Verdana, sans-serif; font-size: 14px; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal; letter-spacing: -0.14px; line-height: 21px; widows: 1; background-color: rgb(255, 255, 255);">NX_CHAR</a></em></div>
<div><br>
</div>
<div>If there are not np values for each of the np images, it’s either an average or a one-off number. I’m not sure we need two fields.</div>
<div><br>
</div>
<div>But getting that into NXbeam was the plan after the acceptance of NXmx. But tracking that is a manual thing and it got dropped.</div>
<div><br>
</div>
<div>Tobias</div>
<div><br>
</div>
<div>P.S. I “invented” the use of NXbeam in NXsample for NXmx, so my side in that discussion should be obvious.</div>
<div><br>
</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<div style="font-family:Calibri; font-size:11pt; text-align:left; color:black; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; PADDING-BOTTOM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0in; BORDER-TOP: #b5c4df 1pt solid; BORDER-RIGHT: medium none; PADDING-TOP: 3pt">
<span style="font-weight:bold">From: </span>NeXus-committee <<a href="mailto:nexus-committee-bounces@nexusformat.org">nexus-committee-bounces@nexusformat.org</a>> on behalf of Herbert Bernstein <<a href="mailto:yayahjb@gmail.com">yayahjb@gmail.com</a>><br>
<span style="font-weight:bold">Date: </span>Wednesday, 11 May 2016 at 16:31<br>
<span style="font-weight:bold">To: </span>Benjamin Watts <<a href="mailto:Benjamin.Watts@psi.ch">Benjamin.Watts@psi.ch</a>><br>
<span style="font-weight:bold">Cc: </span>"<a href="mailto:nexus-committee@nexusformat.org">nexus-committee@nexusformat.org</a>" <<a href="mailto:nexus-committee@nexusformat.org">nexus-committee@nexusformat.org</a>><br>
<span style="font-weight:bold">Subject: </span>Re: [NeXus-committee] Additions to NeXus<br>
</div>
<div><br>
</div>
<blockquote id="MAC_OUTLOOK_ATTRIBUTION_BLOCKQUOTE" style="BORDER-LEFT: #b5c4df 5 solid; PADDING:0 0 0 5; MARGIN:0 0 0 5;">
<div>
<div>
<div dir="ltr">
<div>Dear Ben,<br>
<br>
</div>
  The two-component polarization has been customary in MX work for many years, but you are absolutely right that a full Stokes vector would make the most sense.  I would suggest two versions:<br>
<span style="font-family:arial,helvetica,sans-serif"><br>
</span><font color="#000000">
<pre><span style="font-family:arial,helvetica,sans-serif">/incident_polarisation_stokes_average=[SVECI,SVECQ,SVECU,SVECV]</span><span style="font-family:arial,helvetica,sans-serif"><font color="#000000"><pre><font face="arial,helvetica,sans-serif">     </font>@units="Watts/meter^2"</pre></font></span><span style="font-family:arial,helvetica,sans-serif"></span><span style="font-family:arial,helvetica,sans-serif"></span><span style="font-family:arial,helvetica,sans-serif"> /incident_polarisation_stokes=[STOKESI,STOKESQ,STOKESU,STOKESV]
</span><font color="#000000"><pre><span style="font-family:arial,helvetica,sans-serif">       @units="Watts/meter^2"<br><br></span></pre><pre><span style="font-family:arial,helvetica,sans-serif">So that we can carry frame-by-frame polarization if we have it, or just <br>the average if we don't.</span><br></pre></font></pre>
</font></div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On Wed, May 11, 2016 at 9:09 AM, Benjamin Watts <span dir="ltr">
<<a href="mailto:benjamin.watts@psi.ch" target="_blank">benjamin.watts@psi.ch</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div text="#000000" bgcolor="#FFFFFF">Hi Everyone,<br>
   I'm going to agree with Eugen that it makes sense for NXbeam to be a child of NXsample as it implies that the beam is described at the position of the sample. If there are multiple sources as Pete described, then they can be differentiated by the name of
 the NXbeam group being "pump" and "probe". <br>
<br>
* It would also be useful to better specify the "polarisation vector" for 'incident_polarization' and 'final_polarization' - I don't understand what this 2-component vector is supposed to be. I would suggest we use a Stokes vector.<br>
* The 'i' and 'j' symbols seems inconsistent on <a href="http://download.nexusformat.org/sphinx/classes/base_classes/NXbeam.html" target="_blank">
http://download.nexusformat.org/sphinx/classes/base_classes/NXbeam.html</a> Perhaps it is supposed to allow multiple incoming and outgoing beams, but it got messed up along the way.<br>
<br>
Cheers,<br>
Ben
<div>
<div class="h5"><br>
<br>
<br>
<div>On 11/05/16 14:50, Eugen Wintersberger wrote:<br>
</div>
<blockquote type="cite">Hi Pete<br>
<br>
<div>On 05/11/16 13:33, Pete Jemian wrote:<br>
</div>
<blockquote type="cite">
<pre>The source is definitely a part of the instrument, not something at the top
level of the experiment (NXentry). Consider the case of a synchrotron X-ray
experiment with a laser pump.  There are two sources to be documented.
They both belong under the description of the pump/probe instrument.

Why should the beam be part of the sample? Makes no sense at all.  The
sample has no beam.  The beam does not describe the sample in any useful
way.  NXbeam documents the state of the beam at some position along the
path from source to detector.  It could go in many places along the optical
path.</pre>
</blockquote>
Besides the fact that NXbeam is mentioned as a possible child for NXsample<br>
it makes perfect sense there too. <br>
If you have many optical components in your beam path and one is mainly interested in the
<br>
beam paramters in front of the sample NXbeam within NXsample would be my <br>
first approach to document these parameters.<br>
<br>
regards<br>
  Eugen<br>
<br>
<br>
<blockquote type="cite">
<pre>Pete
On May 11, 2016 6:17 AM, "Andreas Förster" <a href="mailto:andreas.foerster@dectris.com" target="_blank"><andreas.foerster@dectris.com></a>
wrote:

</pre>
<blockquote type="cite">
<pre>Dear NeXus folks,

there was a little discussion last week about possible additions to the
NeXus standard (and NXmx) to record beam information relevant for the
estimation of dose.  Herbert proposed a good solution, but the outcome of
this discussion is still pending.

At DECTRIS, we're keen to tell our customers how to record additional
metadata in a NeXus-compliant way.  That's why I'd like to have official
word on the fields below:

Information on the synchrotron should be recorded in an NX_Source group.
Is /entry/source the right place for that?

     /entry/source *NX_SOURCE*
<a href="http://download.nexusformat.org/sphinx/classes/base_classes/NXsource.html" target="_blank"><http://download.nexusformat.org/sphinx/classes/base_classes/NXsource.html></a>

o   *name*: *NX_CHAR*
<a href="http://download.nexusformat.org/sphinx/nxdl-types.html#nx-char" target="_blank"><http://download.nexusformat.org/sphinx/nxdl-types.html#nx-char></a>

§  Name of synchrotron

o   *@short_name*: *NX_CHAR*
<a href="http://download.nexusformat.org/sphinx/nxdl-types.html#nx-char" target="_blank"><http://download.nexusformat.org/sphinx/nxdl-types.html#nx-char></a>

§  short name for source, perhaps the acronym
Data describing the beam as it hits the sample should probably go the
NX_Beam group in /entry/sample/beam.  None of the fields below are
currently defined.  Could these definitions be adopted?

·      /entry/sample/beam *NX_BEAM*
<a href="http://download.nexusformat.org/sphinx/classes/base_classes/NXbeam.html" target="_blank"><http://download.nexusformat.org/sphinx/classes/base_classes/NXbeam.html></a>

o   *name*: *NX_CHAR*
<a href="http://download.nexusformat.org/sphinx/nxdl-types.html#nx-char" target="_blank"><http://download.nexusformat.org/sphinx/nxdl-types.html#nx-char></a>

§  Name of beamline

o   *total_flux/xray_flux*: *NX_FLOAT*
<a href="http://download.nexusformat.org/sphinx/nxdl-types.html#nx-float" target="_blank"><http://download.nexusformat.org/sphinx/nxdl-types.html#nx-float></a> {units=
*NX_RATE* <a href="http://download.nexusformat.org/sphinx/nxdl-types.html#nx-rate" target="_blank"><http://download.nexusformat.org/sphinx/nxdl-types.html#nx-rate></a>
}

§  Beam intensity (example: s-1)

o   *incident_beam_size: **NX_FLOAT*
<a href="http://download.nexusformat.org/sphinx/nxdl-types.html#nx-float" target="_blank"><http://download.nexusformat.org/sphinx/nxdl-types.html#nx-float></a>*[2]*

§  Two-dimensional array of FWHM (if Gaussian) or diameters (if top hat)
of beam

o   *profile*: *NX_CHAR*
<a href="http://download.nexusformat.org/sphinx/nxdl-types.html#nx-char" target="_blank"><http://download.nexusformat.org/sphinx/nxdl-types.html#nx-char></a>

§  Gaussian or top hat

Should the name of the beamline be recorded in beam or in source?  For the
flux (as a rate - in contrast to the already existing flux density field
"flux"), either name is fine by me.

I'm happy to discuss these points during the next NeXus meeting.

Thank you and all best


Andreas



--
<a href="https://www.dectris.com" target="_blank"><https://www.dectris.com></a>
Andreas Förster, Ph.D.
MX Application Scientist, Scientific Sales
Phone: <a href="tel:%2B41%2056%20500%202100" value="+41565002100" target="_blank">+41 56 500 2100</a> | Direct: <a href="tel:%2B41%2056%20500%202176" value="+41565002176" target="_blank">+41 56 500 2176</a> | Email:
<a href="mailto:andreas.foerster@dectris.com" target="_blank">andreas.foerster@dectris.com</a>
DECTRIS Ltd. | Taefernweg 1 | 5405 Baden-Daettwil | Switzerland |
<a href="http://www.dectris.com" target="_blank">www.dectris.com</a>

[image: LinkedIn] <a href="https://www.linkedin.com/company/5067919" target="_blank"><https://www.linkedin.com/company/5067919></a>
 [image: facebook]
<a href="https://www.facebook.com/pages/Dectris-Ltd/623855944369304" target="_blank"><https://www.facebook.com/pages/Dectris-Ltd/623855944369304></a><a href="https://twitter.com/DECTRIS_News" target="_blank"><https://twitter.com/DECTRIS_News></a>





Confidentiality Note: This message is intended only for the use of the
named
recipient(s) and may contain confidential and/or privileged information. If
you
are not the intended recipient, please contact the sender and delete the
message.
Any unauthorized use of the information contained in this message is
prohibited.



_______________________________________________
NeXus-committee mailing list
<a href="mailto:NeXus-committee@nexusformat.org" target="_blank">NeXus-committee@nexusformat.org</a><a href="http://lists.nexusformat.org/mailman/listinfo/nexus-committee" target="_blank">http://lists.nexusformat.org/mailman/listinfo/nexus-committee</a></pre>
</blockquote>
<br>
<fieldset></fieldset> <br>
<pre>_______________________________________________
NeXus-committee mailing list
<a href="mailto:NeXus-committee@nexusformat.org" target="_blank">NeXus-committee@nexusformat.org</a><a href="http://lists.nexusformat.org/mailman/listinfo/nexus-committee" target="_blank">http://lists.nexusformat.org/mailman/listinfo/nexus-committee</a></pre>
</blockquote>
<br>
<br>
<fieldset></fieldset> <br>
<pre>_______________________________________________
NeXus-committee mailing list
<a href="mailto:NeXus-committee@nexusformat.org" target="_blank">NeXus-committee@nexusformat.org</a><a href="http://lists.nexusformat.org/mailman/listinfo/nexus-committee" target="_blank">http://lists.nexusformat.org/mailman/listinfo/nexus-committee</a></pre>
</blockquote>
<br>
</div>
</div>
</div>
<br>
_______________________________________________<br>
NeXus-committee mailing list<br>
<a href="mailto:NeXus-committee@nexusformat.org">NeXus-committee@nexusformat.org</a><br>
<a href="http://lists.nexusformat.org/mailman/listinfo/nexus-committee" rel="noreferrer" target="_blank">http://lists.nexusformat.org/mailman/listinfo/nexus-committee</a><br>
<br>
</blockquote>
</div>
<br>
</div>
</div>
</div>
</blockquote>
</span>
</body>
</html>