Gui release notes

==Version 2.0.8.beta==

===Known bugs and issues===

None

===Description===

This version uses a more accurate estimate of a typical Ge detector's ''intrinsic'' efficiency (based on Gammasphere's efficiency) to give approximate "raw" count rates.  The total counts (for 100% efficienct detectors) were found to agree with perturbation calculations for weakly-coupled two-state systems, where the perturbation method is accurate.

Refer to the recommendations section if you are working with simulated yield data.

This version preserves the same backward compatibility with older session files as did version 2.0.6.beta.

This is expected to be the last beta release before a significantly upgraded release version expected in July.

===Recommendations===

If you are working with simulated data, refer to the page [[Rachel_simulated_yield_output | Rachel simulated yield output]] for a description of the new output format and the meaning of terms.


==Version 2.0.7.beta==

===Known bugs and issues===

None

===Description===

This is a bug-fix version relative to 2.0.6.beta.  

# The simulated yield data are now updated properly.  
# The simulated data now include the proper Ge detector solid angle factor.  Simulated yield data are corrected by dividing the simulated raw counts by a factor of <math>\epsilon \Delta\Omega_\gamma</math>, where <math>\epsilon</math> is the approximate intrinsic efficiency (<math>0<\epsilon <1</math>) and <math>\Delta\Omega_\gamma</math> is the solid angle subtended by the Ge detector.  In previous Rachel versions, the absence of the solid angle factor would cause a systematic disagreement between Ge detectors only if they subtended different solid angles.

Refer to the recommendations section if you are working with simulated yield data.

This version preserves the same backward compatibility with older session files as did version 2.0.6.beta.

This is expected to be the last beta release before a significantly upgraded release version expected in July.

===Recommendations===

If you are not working with simulated data, no corrections are needed.

ONLY if simulated data are in use, re-run the simulated data calculation.  Answer "yes" to the prompt to re-integrate the yield data.


==Version 2.0.6.beta==

===Known bugs and issues===

When calculating simulated yields, the new simulated yield data in session (and saved session file) will not be updated unless the user answers "y" to the prompt "Re-integrate the predicted yields? [Y/n]:"  This may or may not affect subsequent fits to the simulated data, depending on the changes to the matrix, experimental parameters, detector arrangements, etc.  The new simulated data are written correctly to the terminal and to the gosia yield file, so fits would not be affected, but a large disagreement between simulated data and calculated yields could appear on plots.  ''Remedy:  always choose to re-integrated the yields when calculating simulated yield data.''

===Description===

This is a bug-fix version relative to 2.0.5.beta.  

Refer to the notes for "Version 2.0.5.beta" below for the details of the bug fix and the recommended solution to update your session files.

This version preserves the same backward compatibility with older session files as did version 2.0.5.beta.

This is expected to be the last beta release before a significantly upgraded release version expected in July.

===Recommendations===

After replacing an older version of Rachel with this version, re-integrate the calculated yields in memory by selecting "Integrated yields" and "Run gosia input" and clicking "Go."  This will update the calculated yields and overwrite any erroneous calculated yields that may be in memory from the bug.

==Version 2.0.5.beta==

===Known bugs and issues===

The bug in version 2.0.4.beta is still not completely fixed.  See below.  A new version will be released probably in mid-June 2011.  Refer to this post in the Gosia forum to see how to correct for the bug:

[http://www-user.pas.rochester.edu/~gosia/phpBB3/viewtopic.php?f=9&t=9 Forum post on correcting for the bug]

===Description===

This is a bug-fix version relative to 2.0.4.beta, and some user prompts and output information is clarified.  

The GUI now correctly informs you of the choices of kinematic solutions for inverse kinematics cases.  The safe energy is reported before asking for the initial beam energy.

Refer to the notes for "Version 2.0.4.beta" below for the details of the bug fix and the recommended solution to update your session files.

This version preserves the same backward compatibility with older session files as did version 2.0.4.beta.

This is expected to be the last beta release before a significantly upgraded release version expected in July.

==Version 2.0.4.beta==

===Known bugs and issues===

This version has one known bug:  if the user selects "View gosia input" or "Save gosia input" for some types of calculations, such as "Integrated yields," inaccurate point yields would be stored in memory after the operation.  This could be more or less apparent, depending on how accurate the point-scattering approximation is for the experiments defined.  The absolute cross sections then reported on plots could then be extremely inaccurate.

After running "Integrated yields" with "Run gosia input" selected, the calculated yields and absolute cross sections on plots would (again) be accurate.

This bug does not affect real yield data or simulated yield data.  This bug would not affect fitting of matrix elements, since the ''corrected'' yields used by Gosia are stored in an external file only.

====Remedies====

# Upgrade to version 2.0.5.beta.
# Re-run the "Integrated yields" calculation to store accurately-calculated yields in memory.  (Save the session.)  This will update all calculated data in memory and on plots.