Rachel GUI

==Rachel, a GUI for Gosia==

[[Image:~/Gui/guisnapshot.png|thumb|right|A snapshot of the alpha version]]

There is a GUI (Graphical User Interface) for Gosia version 20081208.10, which is currently undergoing beta-testing.  The latest beta-test version can be [http://www.pas.rochester.edu/~hayes/beta_rachel/rachel.1.3.0.beta.tar downloaded here].  Rachel is written in Python 2.6 and is expected to be Python 2.7 compliant.  It will run on Linux or Unix (OS X) machines.  A 64-bit processor is desirable, because Gosia runs fastest and most accurately on a 64-bit machine.  This original version of the GUI was written as a time-saving tool for analysis of one particular data set, so the final release version, expected in 2011 will have many structural changes in the code, allowing more automation, more general particle detector options and fewer user prompts.

===Beta version capabilities===

* Azimuthally symmetric particle detection
* Partitioning particle-detector data by azimuthal angle
* Graphical definition of rectilinear or irregular-shaped particle detectors (in version 2 beta, release TBA)
* 4pi experiments (e.g. experiments with no particle detection)
* Normal or inverse kinematics experiments
* A user-expandable library of standard Ge crystals e.g. Gammasphere
* Data from summed 4pi arrays
* Efficiency-corrected gamma-ray data only
* Experiment planning aids
** Generation of simulated data based on a proposed beam run
** Optional quasi-Gaussian random scatter in simulated data
** Estimated precision of the proposed measurement
* Accuracy testing to determine if Gosia will be appropriate for a planned experiment
* Fitting and correlated error estimations
* Reading level schemes and gamma-ray data from Radware AGS files and Rachel format text files
* Importing branching ratio data
* Instantly generating plots of experimental vs. predicted yields via gnuplot  [[Image:Gui/plotting_example.png|thumb|right|Instant plots can be made following calculations]]
* Automated generation of stopping power and internal conversion input for Gosia
* Push-button controls
* A searchable help function
* Saving the entire session to a file
* Undo/Redo of most functions
* As of version 2 beta, automatic conversion of users' session files to upgraded formats

Using Rachel, the user will be able to build a level scheme from either a hand-written text file and/or a Radware AGS file, define the experimental setup and import relative-efficiency-corrected gamma-ray data from Rachel-format text and/or AGS files.  The matrix and fit parameters can be defined by push-buttons and prompts or imported from a Rachel-format matrix file.  Gosia will then be run by push-button GUI controls.  Most prompts will be preceded by help information, suggestions, or warnings.  

For experiments that fit the capabilities above, the user can view the Gosia inputs to learn the format, but will not be required to type any input code.  Experienced Gosia users can export a GUI-generated input skeleton file and abandon the GUI to use the more advanced capabilities of Gosia.

===Rachel manual and tutorial videos=== 

Download the [http://www.pas.rochester.edu/~hayes/beta_rachel/rachel_manual.pdf draft manual here]

====The basics====

# To install Rachel and get it running for the first time, watch [http://www.pas.rochester.edu/~hayes/beta_rachel/rachel_installation.html Rachel Installation].
# A short video on [http://www.pas.rochester.edu/~hayes/beta_rachel/undo_redo.html the undo/redo buttons].
# How to [http://www.pas.rochester.edu/~hayes/beta_rachel/crash_recovery.html recover data from a crashed session].
# First steps: [http://www.pas.rochester.edu/~hayes/beta_rachel/reading_level_schemes.html Reading level schemes.]
# How to [http://www.pas.rochester.edu/~hayes/beta_rachel/add_matrix_non_collective.html add individual matrix elements].  This is most applicable to small, non-collective systems, such as the one in the sample file example2levels.txt file distributed with Rachel. 
# How to [http://www.pas.rochester.edu/~hayes/beta_rachel/add_matrix_collective.html add matrix elements systematically], i.e., for collective nuclei with rotational bands.
# How to [http://www.pas.rochester.edu/~hayes/beta_rachel/setting_up_calculations.html define experiments, Ge detectors and calculate predicted yields]. This video will show how to define experimental detector setup, data partitions and make instant plots as well.
# A [http://www.pas.rochester.edu/~hayes/beta_rachel/basic_fit_example.html very basic example of fitting] including a correlated error calculation. The entire video is about 30 minutes long. You can follow along using the GUI on your system and the example files shown in the video, which are included with your Rachel distribution in the .../example_files/ subdirectory.
# More advanced selection of fit parameters are shown in this video on [http://www.pas.rochester.edu/~hayes/beta_rachel/experiment_planning_2.html experiment planning].

====Experiment planning and accuracy testing tools====

# [http://www.pas.rochester.edu/~hayes/beta_rachel/accuracy_testing.html Testing the accuracy] of your Gosia calculations and the applicability of Gosia to a planned experiment.
# Semiclassical Coulomb excitation codes have inherent adiabaticity and eccentricity limits. [http://www.pas.rochester.edu/~hayes/beta_rachel/adiabaticity_limit.html This video] shows how to test for these limits with an experiment that would ''not'' be appropriate for Gosia.
# [http://www.pas.rochester.edu/~hayes/beta_rachel/experiment_planning.html Generating simulated data]. The errors in the simulated data are based on Poisson statistics and the expected number of days, beam current, etc. to estimate your ability to observe desired gamma-ray yields and to fit matrix elements to the observed yields. The present beta version applies ''optionally'' a quasi-gaussian random scatter of the predicted yield data [http://www.pas.rochester.edu/~hayes/beta_rachel/experiment_planning_2.html as demonstrated in this video] to better aid in predicting expected precision of fitted matrix elements. Watch this supplemental video to see how this works. You should also watch the [http://www.pas.rochester.edu/~hayes/beta_rachel/accuracy_testing.html accuracy testing video] to see if Gosia would be an appropriate analysis tool for your planned experiment.