Project

General

Profile

Workshop 2018 Setup » History » Version 5

Ole Hansen, 06/18/2019 11:15 AM

1 1 Ole Hansen
h1. Software Setup Instructions for 2018 Hall A & C Data Analysis Workshop
2
3 4 Ole Hansen
In order to run the interactive tutorials, certain software should be available to you:
4 2 Ole Hansen
5
* @bash@ (shell)
6
* @git@ (version control)
7
* ROOT with Python bindings
8
* Hall C analyzer (@hcana@)
9 4 Ole Hansen
* Python 2.7 and/or 3.4+
10 2 Ole Hansen
* Various Python packages, all available via pip:
11
** numpy
12
** scipy
13
** matplotlib
14
** pandas
15
** uproot
16
** ipython
17
** notebook
18
19
Scripts and data files can be downloaded/accessed over the network during the workshop.
20
21
There are essentially three approaches to get a usable software environment, in order of preference:
22
23 5 Ole Hansen
# *Recommended:* Use our pre-configured "Virtual Machine Image":https://hallaweb.jlab.org/data_reduc/AnaWork2018/VirtualBox/ for "VirtualBox":https://www.virtualbox.org/. This will yield consistent results on all supported platforms (Windows, macOS, recent Linuxes), but will consume significantly more system resources than a native installation. The installation of VirtualBox may be challenging on some Linux systems. 
24 2 Ole Hansen
# Install all required software locally on your machine. This will yield the fastest performance, but may be time-consuming and error-prone. Installation on Windows can be challenging since much of the software and scripts is designed for a Unix-like environment. Recommended for advanced users.
25
# Access a machine with a suitable environment remotely, _e.g._ the JLab @ifarm@ systems. This is a last resort since performance will be lower and there may still be compatibility problems. For graphics, your system requires an X server installed locally.
26
27 5 Ole Hansen
If your machine is reasonably powerful (_e.g._ i5 CPU, 4+ GB RAM, 30-40 GB free disk space) and runs a recent OS, your best bet is probably our "Virtual machine":https://hallaweb.jlab.org/data_reduc/AnaWork2018/VirtualBox/ since the environment is completely set up and configured for the workshop exercises. See "Instructions.txt":https://hallaweb.jlab.org/data_reduc/AnaWork2018/VirtualBox/Instructions.txt in the download directory for detailed instructions.
28 2 Ole Hansen
29
If you feel comfortable installing software on your system and/or you already have much of the required software available, option 2. may be for you. You can find some guidance here:
30
* "JLab 2018 Software Carpentry Workshop Setup Instructions":https://kevin-vilbig.github.io/2018-05-21-JLAB/ (covers @bash@, @git@ and @Python@, even for Windows)
31
* [[ROOT Installation Guide|Hall A ROOT Installation Guide]]
32
* "Hall C Analyzer Installation Guide":https://hallcweb.jlab.org/wiki/index.php/ROOT_Analyzer/Git
33
34
Please start well in advance of the workshop.
35
36 3 Ole Hansen
Connecting to @ifarm@ or some other remote system (_e.g._ your office desktop) requires an @ssh@ client with X forwarding and an X server. On @ifarm@, do
37
<pre>
38
ifarm> source /apps/root/6.12.06/setroot_CUE
39
</pre>
40
to set up ROOT as well as a Python3 environment that has all the required packages. Unfortuantely, performance will be slow because @ifarm@ is a busy system that you share with many other users. As mentioned, do this as a last resort.
41 2 Ole Hansen
42
Please contact Ole Hansen (ole@jlab.org) with questions.