Closed warunawickramasingha closed 9 months ago
We should discuss this with SANS to confirm the expected behaviour before starting work on this.
We should discuss this with SANS to confirm the expected behaviour before starting work on this.
This issue was raised while following the test instructions for https://developer.mantidproject.org/Testing/SANSGUI/ISISSANSGUITests.html#id4
Note that it doesn't seem to be just selecting the RKH option that is the issue, but instead ticking and unticking any save file format option prevents the automatic selection of the default save file format. The current philosophy seems to be:
We have discussed this with SANS and the following approach is preferred in order to encourage users to take their data away in the most meaningful format:
The correct default file formats should be:
Select 1D: CanSAS1D & NXCanSAS Select 2D: NXcanSAS
After making these changes, we should update the manual testing instructions accordingly. I think that the existing instructions are actually quite open to interpretation (I would have assumed they were saying that ticking RKH meant that the correct behaviour was to stop automatic selection of the save file format), so we should be careful to ensure there isn't scope for confusion in the new instructions.
Additionally, we've been asked to update the documentation for the three save algorithms to help users select the correct one for their data. The following changes have been requested (suggestions highlighted using code markup):
SaveCanSAS1D
Summary: “Save a MatrixWorkspace to a file in the canSAS1D XML
format (for 1D data)
“
Description: “Saves the given Matrix Workspace to a file in the canSAS1D XML
format.
This format is only intended to save 1D workspaces.
If the workspace contains several spectra, two options are available:
• if OneSpectrumPerFile if false (default value), all spectra will be appended into the same file (into different The created file can be reloaded using the [LoadCanSAS1D v2](https://docs.mantidproject.org/nightly/algorithms/LoadCanSAS1D-v2.html#algm-loadcansas1d) algorithm.“
SaveNXcanSAS
Summary: “Save
a MatrixWorkspace to a file in the NXcanSAS format (for 1D/2D data)
”
Description: “Saves a workspace with momentum transfer units into a file adhering to the NXcanSAS format specified by NXcanSAS Data Formats Working Group schema. 1D or 2D workspaces may be saved.
If the input workspace is 2D then the vertical axis needs to be a numeric axis in momentum transfer units. The created file can be reloaded using the LoadNXcanSAS v1 algorithm.“
SaveRKH
Summary: “Save a Matrix Workspace to a
file in the ISIS
RKH format (for 1D/2D data)
“
Description: “Saves the given workspace to a file which will be formatted in one of the historic ISIS SANS (‘COLETTE’/‘FISH’) [data formats](https://www.isis.stfc.ac.uk/Pages/colette-ascii-file-format-descriptions.pdf) devised by Richard K Heenan
. 1D or 2D workspaces may be saved. If a 1D workspace is ‘horizontal’ (a single spectrum) then the first column in the three column output will contain the X values of the spectrum (giving the bin centre if histogram data). For a ‘vertical’ (single column) 1D workspace, the first column of the file will contain the spectrum number. The created file can be reloaded using the LoadRKH v1 algorithm.
“
We could also consider adding to the InputWorkspace parameter descriptions in the documentation to make it clear what type of data should be in the input workspace.
Describe the bug Please read this comment for the change required by this issue.
In ISIS SANS Reduction GUI, when switching the reduction options between 1D and 2D, the save options are expected to automatically switch between CanSAS and NXcanSAS. However after ticking and unticking RKH (1D/2D) option, the above behaviour is not observed
To Reproduce Steps to reproduce the behavior:
Expected behavior Switch between 1D and 2D, it should automatically switch between CanSAS and NXcanSAS
Platform/Version (please complete the following information):