Gui release notes

From GOSIA

Jump to: navigation, search
 
Line 2: Line 2:
=Versions 1.x=
=Versions 1.x=
 +
 +
==Version 1.3.3==
 +
 +
This is the most recent version, which can be found on the  [https://github.com/adamhayes/Rachel/archive/stable_versions.zip stable-versions branch on github]
 +
 +
==Version 1.3.1==
 +
 +
===Description===
 +
 +
New features: Thick-target calculations are now fully-automated.  The user is prompted if the thick target requires extra consideration, whereas, in older versions, the user would get error messages and have to fix it herself.
 +
 +
===Changes===
 +
 +
* Auto-complete has been added for filenames, so it is easier to load detector arrays, for example.
 +
* Notices are displayed automatically when a new version of Rachel is available.
 +
* The simulation table output contains all of the relevant data about each experiment.
 +
 +
====Bug-fixes====
 +
 +
Fixed a bug that prevented proper storage of calculated errors in the matrix elements.  The output of the error calculation was correct, but those error bars could not be retrieved later.
 +
 +
This version properly flushes the input buffer (stdin) before prompts, so that accidental keystrokes are ignored.
 +
 +
===Known bugs and issues===
 +
 +
The plots of collision functions are still not available for all multipoles.
 +
 +
In all versions, it is possible to save an empty session over an existing session.  Frequent backups of the working directory should be made.
 +
 +
This version is not backward-compatible with the beta versions; users must re-define the experimental
 +
definitions.  Level and matrix data CAN be exported from beta versions and imported to this version.  All
 +
later versions are expected to preserve backward compatibility with this version.
 +
Plots of collision functions cannot be generated for all states.
 +
 +
===Recommendations===
 +
 +
 +
==Version 1.3.0==
 +
 +
===Description===
 +
 +
New features: Thick-target calculations are now fully-automated.  The user is prompted if the thick target requires extra consideration, whereas, in older versions, the user would get error messages and have to fix it herself.
 +
 +
===Changes===
 +
 +
* Thick target calculations are now fully-automated
 +
* Lifetime calculations are now fully-automated (one-click)
 +
* Vacuum deorientation calculations are now fully-automated and can be run at any time when the experimental setup is complete.
 +
* Two logs have been added: a procedure log with timestamps and a user log that can be edited inside the GUI.
 +
* Tab-completion of filenames and paths
 +
* Improved reading of AGS level schemes that are missing spin/parity assignments
 +
* The assumed Q-value is lowered automatically when the projectile energy is too low
 +
 +
====Bug-fixes====
 +
 +
Fixed a bug that used the wrong kinematic solution for inverse kinematics in some fits.  This caused inaccuracy in finding the minimum in some cases.
 +
 +
Errors are more graceful if the user tries to perform an operation before setup is complete.
 +
 +
The splash screen now renders properly.
 +
 +
===Known bugs and issues===
 +
 +
In all versions, it is possible to save an empty session over an existing session.  Frequent backups of the working directory should be made.
 +
 +
This version is not backward-compatible with the beta versions; users must re-define the experimental
 +
definitions.  Level and matrix data CAN be exported from beta versions and imported to this version.  All
 +
later versions are expected to preserve backward compatibility with version 1.2.0
 +
Plots of collision functions cannot be generated for all states.
 +
 +
===Recommendations===
 +
 +
To migrate from a beta version to this version, export the level scheme and matrix, then import them into a
 +
new session in this version.
 +
 +
==Version 1.2.0==
 +
 +
===Description===
 +
 +
===Changes===
 +
 +
The normalization of calculated yields to experimental yields in the GUI now matches the normalization used by Gosia.  The previous Rachel versions weighted yields by their fractional errors when calculating the normalizations.  This can make plotting and understanding the chi-squared values confusing.  For example, when low-intensity gamma-ray yields are poorly reproduced, the high-intensity yields can appear to be poorly reproduced.
 +
 +
The new method in version 1.2.0 weights the individual yields' contributions to the normalization factor by their intensity only.
 +
 +
This version is backward-compatible with all versions 1.0 and later.
 +
 +
See version 1.0.
 +
 +
====Bug-fixes====
 +
 +
===Known bugs and issues===
 +
 +
In all versions, it is possible to save an empty session over an existing session.  Frequent backups of the working directory should be made.
 +
 +
This version is not backward-compatible with the beta versions; users must re-define the experimental
 +
definitions.  Level and matrix data CAN be exported from beta versions and imported to this version.  All
 +
later versions are expected to preserve backward compatibility with this version.
 +
Plots of collision functions cannot be generated for all states.
 +
 +
===Recommendations===
 +
 +
To migrate from a beta version to version 1.2.0, export the level scheme and matrix, then import them into a
 +
new session in this version.
 +
 +
 +
==Version 1.1.5==
 +
 +
===Description===
 +
 +
This version is backward-compatible with all versions 1.0 and later.
 +
 +
See version 1.0.
 +
 +
===Changes===
 +
 +
None
 +
 +
====Bug-fixes====
 +
 +
A bug that affected only the fitting and corrected yield calculations has been fixed.  Occasionally, but not always, this bug resulted in incorrect yield data being passed to Gosia using the "Write Gosia yld file" button, which would affect fitting.  It did not affect integrated yield calculations, simulations or plotting, and the integrated yield function still gave the correct chi-squared value. 
 +
 +
See the recommendations section below.
 +
 +
===Known bugs and issues===
 +
 +
In all versions to date, the sensitivity map (OP,MAP) is calculated in the same Gosia call that does a fit (OP,MINI).  This works in most cases, but it may cause errors occasionally in inverse-kinematics calculations.  (This is not confirmed, but the error will be reported if it occurs.)  The sensitivity map will be calculated in a separate call in the next bug-fix version.
 +
 +
Level schemes that do not have spins in order of increasing energy within a band, e.g. 1-, 0-, 3-, 2-..., will cause errors in generating the Gosia input, and the full yield data set may not be passed to Gosia for fitting matrix elements.  The expected date for the bug fix is not known.  In the meantime, separate each state to a separate band.  (It may be sufficient to separate the ground state and put it in band #1, then put all remaining states in another band.)  Be sure to check the K values that the GUI has assumed and normalization constants for the Alaga rule compared to the in-band rotor model.
 +
 +
In all versions, it is possible to save an empty session over an existing session.  Frequent backups of the working directory should be made.
 +
 +
This version is not backward-compatible with the beta versions; users must re-define the experimental
 +
definitions.  Level and matrix data CAN be exported from beta versions and imported to this version.  All
 +
later versions are expected to preserve backward compatibility with this version.
 +
Plots of collision functions cannot be generated for all states.
 +
 +
===Recommendations===
 +
 +
Refer to the bug-fix above.  To correct possible errors in prior fits, do the following 'if a fit has been performed'.
 +
No corrections are needed if a fit has not been performed with an earlier version.
 +
 +
# Rewrite the Gosia yield file using the button "Write Gosia yld file."
 +
# Re-run the "Make corrected yields" calculation.
 +
# Re-run the "Fit" calculation.
 +
# Re-run any error calculations that have been done.
 +
# Before comparing experimental yields to calculated yields (plotting, etc.), re-run "Integrated yields" to update the calculated yields for the new matrix elements.
 +
# Save the session.
 +
 +
The new fitted matrix elements can be compared to previous calculations to see if the bug had affected fits.
 +
 +
To migrate from a beta version to this version, export the level scheme and matrix, then import them into a
 +
new session in this version.
 +
 +
==Version 1.1.4==
 +
 +
===Description===
 +
 +
This version is backward-compatible with all versions 1.0 and later.
 +
 +
See version 1.0.
 +
 +
===Changes===
 +
 +
The user must now answer "y" or "n" when asked whether to save the session upon exiting.  This helps to prevent accidentally overwriting the session file.
 +
 +
====Bug-fixes====
 +
 +
All yield data are properly displayed when plotting yields for merged bands.
 +
 +
Some previous versions did not parse comments properly in detector array files has been fixed.  This bug had made it impossible to import a few of the array files that come with the Rachel package.
 +
 +
===Known bugs and issues===
 +
 +
In all versions, it is possible to save an empty session over an existing session.  Frequent backups of the working directory should be made.
 +
 +
This version is not backward-compatible with the beta versions; users must re-define the experimental
 +
definitions.  Level and matrix data CAN be exported from beta versions and imported to this version.  All
 +
later versions are expected to preserve backward compatibility with version 1.1.4.
 +
Plots of collision functions cannot be generated for all states.
 +
 +
===Recommendations===
 +
 +
To migrate from a beta version to version 1.1.4, export the level scheme and matrix, then import them into a
 +
new session in this version.
==Version 1.1.3==
==Version 1.1.3==

Latest revision as of 20:13, 10 April 2013

Personal tools