Newbie Material¶
- Table of contents
- Newbie Material
All of SBND's material can be found on the docDB. It requires a password to access everything, just ask for it!
To be part of the SBND-software mailing list send an email to: listserv@fnal.gov with the following information: SUBSCRIBE SBND-SOFTWARE YOUR NAME. Here is a list of all the mailing lists available: https://listserv.fnal.gov/scripts/wa.exe?INDEX. For more information see: http://listserv.fnal.gov/users.asp#subscribe
Computing Access¶
See the Computing resources page to see a discussion about the computing privileges that SBND has.
To get a Fermilab computing account follow the instructions at this site. Our experiment number is T1053
Write down the initial Kerberos and Services Account password before submitting. This will be necessary once your accounts have been created.
You will receive an email once this is complete which gives you your Fermilab email account and username (you will need this for service now).
Once your computer is ssh ready and kerberized, you should be able to log on by typing:
kinit [yourusername]@FNAL.GOV ssh -Y [yourusername]@sbndgpvm01.fnal.gov
Note that you need to have the right configurations, add the following to your machine's ~/.ssh/config
Host *.fnal.gov ForwardAgent yes ForwardX11 yes ForwardX11Trusted yes GSSAPIAuthentication yes GSSAPIDelegateCredentials yes
Create the file if it's not there. In some systems you might need to reload the ssh agent. You also want to have this file in the gpvm machine.
If this does not work, please submit a service desk ticket to request a SBND project account (I believe someone has to authorise this so it will probably fail)
ServiceNow-> Request Something -> Experiment/Project/Collaboration Computing Account
Enter your name, then select T-1053 (SBND)
Verify that the correct Fermilab principal is displayed when you enter your name
Enter your home institution, then click Submit.
You can reset your Fermilab passwords for service-now here.
If you can't remember your password because you didn't write it down then you will have contact the service desk.
Communication and Asking for Help¶
We use different technology to communicate, depending on the purpose and type of communication.
- Emails are used to send announcements, call for meetings or other events and, in general all important communication that shouldn't be missed goes through emails. Sign in to SBND mailing lists by sending an email to listserv@fnal.gov with no subject and in the body put:
SUBSCRIBE NAME-OF-MAILING-LIST Name Lastname
, for example I would write:SUBSCRIBE SBND-SOFTWARE Iker de Icaza
.
- Slack is used for day to day communication, particularly useful if more than one could answer --remember SBND collaborators span several time zones-- or if the answer could benefit more people than just you. Once you have a FNAL account sign-in to SBND Slack with you FNAL account.
- Zoom is used for meetings, you will need to have it installed on your computer. You don't need to make an account to use it, however if you open it with your FNAL email you can see Fermilab's rooms listed. Pro Tip: configure it to start meetings with no video and muted, also but less important, put your name as you would like it to appear to others.
New to Liquid Argon Technology/ Neutrino physics and SBND?¶
If you are new to Liquid Argon technology then here as some links you might find useful:
Stolen straight from the 35 tonne page:
- Intro to LArTPCs - Stephen Pordes, 2009
- Intro to LArTPC Reconstruction - Herb Greenlee, 2013
- LArTPCs in the US - Tingjun Yang, 2013
The SBN Proposal: A Proposal for a Three Detector Short-Baseline Neutrino Oscillation Program in the Fermilab Booster Neutrino Beam
The MicroBooNE- Public notes: http://www-microboone.fnal.gov/publications/publicnotes/
- Publications: http://www-microboone.fnal.gov/publications/index.html
The ICARUS publications: http://icarus.lngs.infn.it/publications.php
Here is a list of publications/books that people have found useful. Please add to the list!- The Liquid Argon Time Projection Chamber: A New Concept for Neutrino Detectors (This is a historical paper where the idea of LArTPCs were first considered)
- Studies with a Liquid Argon Time Projection Chamber (By Michael Schenk. It gives a nice overview of the theoretical/Design concepts of the technology)
- Light Sterile Neutrinos: A White Paper (It gives a good overview of the current status of eV sterile neutrinos. Also look at the references within)
- Combined νμ → νe & ν ̄μ → ν ̄e Oscillation Analysis of the MiniBooNE Excesses (The miniBooNE anomaly paper)
- Evidence for Neutrino Oscillations from the Observation of ν ̄e Appearance in a ν ̄μ Beam (The LSND anomaly paper)
New to the Software Surrounding SBND?¶
To get started you need to have a basic knowledge of c++ and you need to learn LArsoft. Root and Git are also useful.
Art and LArsoft¶
Here is a few places to look at more information about Art and LArsoft.
- LArsoft: The SBND Guide to using LArSoft (A useful page of links and examples)
- LArsoft: How to setup your directory and launch your first job (This is an SBND wiki page to help set up your first job, it is the first thing you should try at )
- LArsoft: Training sessions (This a link to some useful presentations introducing LArsoft).
- LArsoft: Helpful tips for LArsoft (This is a useful list of tips to help you along when editing your build)
- LArsoft doxygen: http://nusoft.fnal.gov/larsoft/doxsvn/html/ (This is the go to place to find out about the code. Some functions\algorithms\classes are better documented than others)
- LArsoft redmine wiki: https://cdcvs.fnal.gov/redmine/projects/larsoft/wiki/LArSoftWiki (Gives a nice overview)
- Basic Concepts: https://cdcvs.fnal.gov/redmine/projects/larsoft/wiki/Using_art_in_LArSoft (A Good link to start off with. It introduces some common features.)
- The Art Workbook: http://art.fnal.gov/art-workbook/ (It is big, and explains things fairly well. Don't do the examples last time I tried they didn't work)
- The Analysis Examples: This is a package that can be downloaded into your local library. Follow the same procedure as in: How to setup your directory and launch your first job but instead of mrb g sbndcode do mrs g larexamples . You can download the package with these steps:
mrb g sbndcode
Do
mrb g larexamples
The g is short for gitCheckout.
- The mrb reference guide: https://cdcvs.fnal.gov/redmine/projects/mrb/wiki/MrbRefereceGuide
- The LArsoft coding codeines: https://cdcvs.fnal.gov/redmine/projects/larsoft/wiki/The_rules_and_guidelines
- The Art Wiki: https://cdcvs.fnal.gov/redmine/projects/art/wiki
C++¶
There are a multitude of resources for c++. There are several books. The one I learnt form was Accelerated C++ .
For online resources Stack Exchange is useful so is cppreference. If you have a good c++ tutorial/documentation add it to the list!
- Accelerated C++: http://irpp.org/wp-content/uploads/sites/2/2014/04/Andrew-Koening-and-Barbara-E.-Moo-Accelerated-C++.pdf
- Stack Exchange: https://stackoverflow.com/questions/tagged/c%2B%2B
- cppreference: http://en.cppreference.com/w/cpp/container/vector
ROOT¶
ROOT is also useful to know and it can be used within LArsoft. If you are new to ROOT and you have a bit of time to learn it I recommend the Nevis tutorials. Given, is an estimated time to complete each section so you have a good idea how much time the whole tutorial takes. The ROOT pages are powered by doxygen and are useful for finding information about specific functions or finding a function you need. Below is a few more places that are useful when learning ROOT. Feel free to add to the list!
- The Root Tutorials: https://root.cern.ch/root/html/tutorials/ (A very good list of different example macros in root, there is less explanation of how things are working but it gives you something to work off)
- The Root Tutorials: https://root.cern.ch/doc/master/group__Tutorials.html (Same Principle as above, slightly different selection)
- The Root Userguide: https://root.cern.ch/root/htmldoc/guides/users-guide/ROOTUsersGuide.html (Big, detailed, good explanations, reading all of it is probably too much)
- The Root Primer: https://root.cern.ch/root/htmldoc/guides/primer/ROOTPrimer.pdf (Quicker, detailed, jumps straight into it, another useful thing to go through at the beginning, a little bit less friendly than the Nevis Tutorials.
- Nevis Root Tutorials: https://www.nevis.columbia.edu/~seligman/root-class/ (Good Beginners guide, easy to work through for a complete beginner. A good variety of tasks but doesn't go into as much detail as some of the other links)
Git¶
New to Git? if so do the quick tutorial to get an idea of how it works. To see how it used in SBND see the Working on a feature branch (to easily share code).
Pro Tip: Log into a gpvm node and do the following commands to setup your git account:
git config --global user.name "Name Lastname" git config --global user.email "user@fnal.gov"
With this you will have your commits signed by you and listed neatly on your Redmine account. You CAN list another email other than your FNAL one, but you need to change it accordingly on your Redmine account.