Difference between revisions of "Getting Started At GlueX"

From GlueXWiki
Jump to: navigation, search
(Data Analysis)
(Software)
Line 21: Line 21:
 
** If you have trouble accessing the wiki or other services, you may not be part of the "halld" group - contact Mark Ito.
 
** If you have trouble accessing the wiki or other services, you may not be part of the "halld" group - contact Mark Ito.
 
** Also make an account on [https://github.com/ GitHub] and ask Mark Ito to be added to the JeffersonLab organization.
 
** Also make an account on [https://github.com/ GitHub] and ask Mark Ito to be added to the JeffersonLab organization.
** [https://scicomp.jlab.org/docs/FarmUsersGuide Here is some documentation] about the computing resources available at JLab.
+
** [https://scicomp.jlab.org/docs/FarmUsersGuide Here is some documentation] about the computing resources available at JLab.  Some other general information can be found [https://halldweb.jlab.org/doc-public/DocDB/ShowDocument?docid=4015 here].  A summary of running on the batch farm can be found [https://halldweb.jlab.org/doc-private/DocDB/ShowDocument?docid=4011 here].
 
* If you are working on the JLab ifarm, you will need to configure the GlueX computing environment. Follow these instructions:
 
* If you are working on the JLab ifarm, you will need to configure the GlueX computing environment. Follow these instructions:
 
** Run the command <code>source /group/halld/Software/build_scripts/gluex_env_boot_jlab.csh</code> to configure the <code>gxenv</code> and <code>gxclean</code> commands (assuming your shell is tcsh.  If you are using bash, run <code>gluex_env_boot.sh</code>).
 
** Run the command <code>source /group/halld/Software/build_scripts/gluex_env_boot_jlab.csh</code> to configure the <code>gxenv</code> and <code>gxclean</code> commands (assuming your shell is tcsh.  If you are using bash, run <code>gluex_env_boot.sh</code>).

Revision as of 09:32, 23 July 2020

Welcome new collaborator! The following is a collection of links and suggestions in order to get you oriented and on the way to analyzing GlueX data.

Communication

GlueX is a multi-purpose experiment with many subsystems. Many people work on this experiment, and their efforts are organized into different subgroups, so communication is an important aspect of collaboration.

  • Meetings: GlueX has many meetings that meet on a regular basis (usually every other week). Important meetings are that of the Physics Working Group and the overall Collaboration Biweekly Meeting. You will also want to attend the appropriate topical working group for your analysis topic. These meetings can be accessed online via BlueJeans
  • Email: GlueX has several email lists used for discussion and annoucements. You will be added to the GlueX Collaboration email list when you become an official Collaboration member. Another good list to subscribe to is the halld-physics list. You can get extra help at the Software Help List.
  • Slack is a text chat service used for more informal communication. Many experts and other collaborators hang out there and are available to answer your questions. Sign up here.
  • There is a grad students and postdocs group group, which has an email list - gluex_grad_postdoc@jlab.org - and hosts an online "coffee break" every Tuesday and Thursday at 10 am - https://bluejeans.com/572904255
  • How to find people and contact info:

Software

  • You will need to get a JLab computing account. Find more information on this page.
    • If you have trouble accessing the wiki or other services, you may not be part of the "halld" group - contact Mark Ito.
    • Also make an account on GitHub and ask Mark Ito to be added to the JeffersonLab organization.
    • Here is some documentation about the computing resources available at JLab. Some other general information can be found here. A summary of running on the batch farm can be found here.
  • If you are working on the JLab ifarm, you will need to configure the GlueX computing environment. Follow these instructions:
    • Run the command source /group/halld/Software/build_scripts/gluex_env_boot_jlab.csh to configure the gxenv and gxclean commands (assuming your shell is tcsh. If you are using bash, run gluex_env_boot.sh).
      • If you want these commands to be run automatically when you log in, please put them into your .cshrc (tcsh) or .profile (bash) files in your home directory.
    • gxenv (GlueXENVironment) sets up the environment. Without an input file, it uses the most recent GlueX build. It can also be provided with an XML file to setup a particular environment. The current builds are found in $HALLD_VERSIONS
    • gxclean will remove any GlueX environment configuration from your current environment.
    • The above info is referenced from here.
    • If you are mostly working at another institution, please contact your local software experts. You can also try building your own version of this software, but this will take a lot of time and disk space!
  • GlueX software consists of several packages, the most important are described below. For physics analysis, you will likely be mostly working with gluex_root_analysis
    • halld_recon - reconstruction of raw and simulated data, high-level analysis and ROOT skim generation
    • halld_sim - generation of simulated data, amplitude analysis
    • HDGeant4 - next-gen simulation of particles interacting with the detector
    • gluex_root_analysis - Analysis of ROOT skims
  • Simple examples (no more than a few lines)
    • Running hd_root to reconstruct data
    • Generating simulated data
    • Running the ReactionFilter plugin
    • Running a DSelector over ReactionFilter output

Data Analysis

  • The GlueX data set is really huge, so instead of analyzing the reconstructed data directly, you should make a request to have a skim for a particular reaction (or reactions) generated. Please do so at this page.
    • You can find more detailed instructions on this process here.
  • To analyze the ROOT trees, you'll want to use the GlueX ROOT Analysis software
    • Here is some information on making and using a DSelector: slides, pdf (draft)
  • When trying to separate signal from background, there are various variables you can try to look at. These include: [examples will be needed]
    • Time-of-flight particle ID
    • Kinematic fit χ2
    • Flight significance of long-lived particles
    • Kinematic selections
  • References

Simulations

  • The easiest way to generate samples of simulated data is using the MC sample submission page
  • Common generators and their uses:
    • gen_amp - sophisticated generator which handles correct angular distributions for many models and for reactions with broad resonances
    • genEtaRegge - are you looking at eta/eta' decays? Then this is a good place to start
    • genr8 - simple phase space generation for many reactions
    • bggen - generates generic photoproduction events, good for looking at backgrounds
    • Would be good to have some simple examples here?

Other Useful Information

Here is some general advice about analyzing data and presenting your results! Every analysis is different, but there are some time-tested general rules to keep in mind.

  • If you're analyzing a channel for the first time, try making some tight selections to isolate your signal. Then you can try relaxing them and understanding what each of them does.
  • When you are trying new things out, to working on building understanding, try just varying one selection and understanding it before moving on to the next. If you vary multiple things at once, it's tough to tell which one is causing whatever effect you are seeing.
  • Many times, less is more! Be careful about applying too many different event selections, and know what effect each one of them has. Slicing and dicing your data too much can lead to unexpected problems, whether it's difficulties in simulating their effects or accidentally creating a signal.
  • If you get stuck, ask someone! Often someone else will have faced a similar problem to you, and will be happy to share their experience. The Tuesday afternoon Open Analysis Meeting is a good place to start.
  • You should try presenting your results at a topical physics group meeting, to get some feedback and let other people in the Collaboration know what you are doing. If you don't know what meeting to present at, ask your advisor or the Physics Analysis Coordinator (sdobbs@fsu.edu). But don't feel like you have to present at every meeting!
  • It's a good idea to get your advisor or someone else from your local group to look over your results/slides before you present them. Sometimes a fresh set of eyes sees something obvious that you've missed.