Project

General

Profile

Workshop 2018 Setup » History » Version 2

Ole Hansen, 06/18/2018 02:25 PM

1 1 Ole Hansen
h1. Software Setup Instructions for 2018 Hall A & C Data Analysis Workshop
2
3 2 Ole Hansen
In order to run the interactive tutorials, certain software must be available to you:
4
5
* @bash@ (shell)
6
* @git@ (version control)
7
* ROOT with Python bindings
8
* Hall C analyzer (@hcana@)
9
* Python 2.7 and/or 3.4+, ideally both
10
* 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
# *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.
24
# 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
Connecting to @ifarm@ or some other remote system (_e.g._ your office desktop) requires an @ssh@ client with X forwarding and an X server. For using ROOT on @ifarm@, see the "CUE ROOT documentation":https://data.jlab.org/drupal/?q=node/43.  @ifarm@ is missing @ipython@ and @notebook@, however, and @pip@ is not available to perform user-level package installation, so some exercises will not work. As mentioned, do this as a last resort.
37
38
Please contact Ole Hansen (ole@jlab.org) with questions.