Skip to content

Rhs chopper#1610

Open
ggoneiESS wants to merge 3 commits into
nexusformat:mainfrom
ggoneiESS:RHS-chopper
Open

Rhs chopper#1610
ggoneiESS wants to merge 3 commits into
nexusformat:mainfrom
ggoneiESS:RHS-chopper

Conversation

@ggoneiESS
Copy link
Copy Markdown

The handedness of the NeXus coordinate system implies that chopper rotation should be positive when rotating clockwise facing away from the source, but the documentation states it is the exact opposite.

This cannot be corrected easily historically, as many systems should have this in place, but it is not correct to describe NeXus as using a right-handed coordinate system with this discrepancy. It also leads to an unintuitive and ugly exception when describing an instrument.

This PR proposes a fix by including a new field, handedness, that defaults to Left unless otherwise specified, thus not breaking any existing setups or data files, but allows for another value, Right, which agrees with the standard NeXus coordinate basis and which arises naturally when defining a RHS with a z-axis that runs in a positive direction from source to sample.

@phyy-nx
Copy link
Copy Markdown
Contributor

phyy-nx commented Apr 29, 2026

From Telco Apr 29, this looks fine. Is there a way in NeXus to specify a default for an enumeration? Right now, the description says the default is 'Left' but this isn't in the XML itself.

<field name="handedness">
<doc>
Direction of measurement for rotation and positions in the disk-chopper.
Left is the default for historical reasons and implies positive rotation and angles in an anticlockwise
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Left is the default for historical reasons and implies positive rotation and angles in an anticlockwise
Left was assumed in the past and implies positive rotation and angles in an anticlockwise

direciton when facing away from the source.
Right matches the default NeXus coordinate system and implies positive rotation and angles in an anticlockwise
direction when looking towards the source - positive rotation matches the positive roll of the system.
Only one from the enumerated list (match text exactly).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Only one from the enumerated list (match text exactly).
Only one from the enumerated list (match text exactly). If `handness` is not specified, it's likely that downstream consuming applications will assume left-handed.

<doc>
Direction of measurement for rotation and positions in the disk-chopper.
Left is the default for historical reasons and implies positive rotation and angles in an anticlockwise
direciton when facing away from the source.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
direciton when facing away from the source.
direction when facing away from the source.

@phyy-nx
Copy link
Copy Markdown
Contributor

phyy-nx commented May 27, 2026

@ggoneiESS after the above comments are addressed, from Telco May 27 we can move this to a 2-week online vote. Thanks!

@tacaswell tacaswell closed this May 27, 2026
@tacaswell tacaswell reopened this May 27, 2026
@tacaswell
Copy link
Copy Markdown
Contributor

"power cycled" to try and get the CI to run correctly.

<doc>
Chopper rotation speed. Positive for anticlockwise rotation when
facing away from the source, negative otherwise.
Chopper rotation speed.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Chopper rotation speed.
Chopper rotation speed, in the convention of the handedness of the chopper.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note, it's a bit odd that the user can specify a negative rotation speed to bypass the handedness. Is that the convention in neutrons?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants