Project

General

Profile

Workshop 2018 Setup » History » Version 4

Ole Hansen, 06/18/2019 10:27 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 4 Ole Hansen
# *Recommended:* Use our pre-configured "Virtual Machine Image":http://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. See "Instructions.txt" in the download directory for details.
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
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":http://hallaweb.jlab.org/data_reduc/AnaWork2018/VirtualBox since the environment is completely set up and configured for the workshop exercises. Please see the linked page for detailed instructions.
28
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.