Revision as of 13:46, 17 August 2016

introduction

Here is the information hub for SoLID software.

The software is based on GEMC framework for detector simulation, The physics event generation is independent.

The instruction for installation and how to use do event generation, simulation and reconstruction are listed below.

quick start

This is a step by step guide to setup things to run SoLID software including simulation, reconstruction etc.

All env variables required are setup by source file "set_solid"

make sure you meet the requirement here

The example below demonstrates how to setup in various cases.

(demonstration) on ifarm with official installation of framework and SoLID repository

The fastest way to see what the simulation look like. You don't need to install any thing, but you can't modify anything either.

login into ifarm65.jlab.org with your jlab account (if you can't, ask jlab computer center help@jlab.org to make sure your account is allowed on ifarm machines)
source /home/zwzhao/solid/solid_svn/solid/set_solid
follow "compile and run" to run simulation (skip compiling)

(recommended) on ifarm with official installation of framework and your SoLID repository

You don't need to install the framework, you can modify simulation configuration. This is the best way to run simulation on ifarm and farm nodes. This is recommend way to compare result and produce results.

login into ifarm65.jlab.org with your jlab account (if you can't, ask jlab computer center help@jlab.org to make sure your account is allowed on ifarm machines)
cd your_choice_of_solid_repo_path
svn co https://jlabsvn.jlab.org/svnroot/solid (if you haven't done so already)
cd solid
edit file set_solid by following the instruction within, you only need to change SoLID_GEMC
source set_solid
follow "compile and run" to compile and run simulation 

(expert) on any machine with your installation of framework and your SoLID repository

This gives you maximum freedom to use any version of framework and ability to work on your local machine, And allow you to modify anything. This is the way to run on your local machine.

install the framework by following installation instruction
cd your_choice_of_solid_repo_path
svn co https://jlabsvn.jlab.org/svnroot/solid (if you haven't done so already)
cd solid
edit file set_solid by following the instruction within
source set_solid
follow "compile and run" to compile and run simulation

Installation

introduction

Physics event generation is a collection of independent software packages.

Detector simulation is based on Geant4 based simulation framework GEMC http://gemc.jlab.org

SoLID repository https://jlabsvn.jlab.org/svnroot/solid is for all of SoLID software

You need both the framework and SoLID repository to use the software

installation of framework

The framework use environmental variable JLAB_VERSION to control version

The current default version is 1.3 (as in 2016/06)

The framework was tested on many platforms, but for our use, it's only fully tested on jlab farm system

The current default system is CentOS6.5 (as in 2016/06)

Other similar systems like RHEL, SL and Fedora may work too.

See detailed instruction at installation of framework

installation of SoLID repository

It's the central repository, everyone has read right, only jlab account within "12gev_solid" group can write to it

checkout by "svn co https://jlabsvn.jlab.org/svnroot/solid"

access its WebSVN interface at https://jlabsvn.jlab.org/solid

two ways to get auto notification about any change to SVN
use a graphic SVN client, for example "kdesvn"
use RSS feed on the Websvn interface

• directory structure
  • "evgen", some event generators, (the others are in other repositories, see event generation section for details)
  • "solid_gemc", GEMC 1.x related files for SoLID simulation
  • "solid_gemc2", GEMC 2.x related files for SoLID simulation
  • "subsystem" for individual subsystems
  • "study" for studies involving different subsystems

A personal copy of EIC repository at /home/zwzhao/solid/solid_svn/solid/ on ifarm

You should download your own copy on ifarm or you local machine so you can tweak the code

Coordinate System

SoLID uses the coordinate system below in lab frame for event generator output, detector arrangement and reconstruction

The solenoid coil central and electron beam crosses at the origin (x=0,y=0,z=0).
electron beam goes along +z axis and at x=0,y=0
y axis is vertical and +y pointing up relative to the ground
x axis is horizontal and +x pointing left relative to the electron beam
+x axis has phi angle 0 deg,  +y axis has phi angle 90 deg

Physics Event Generation

Detector Simulation

Event Reconstruction

Study

Info

emaillist

• mailing list solid_software@jlab.org (registration and archive)

linux group

SoLID Linux group is "12gev_solid"

check your account groups by command "groups" or "id user_name"

Please ask Ole <ole at jlab.org> to add your jlab account to the group if you want to use SoLID related computing resource at jlab.

Batch Farm Project

jobs should go to the 'solid' project

Disk Space

We have disk space on the CUE

The volatile guaranteed reservation is 500GB and files there are expected to have an expiration date of six months. Please use /volatile for larger data sets and /work for sources and reduced datasets you need to keep. You must belong to the group 12gev_solid for access, ask "Ole at jlab.org" to add you.

To avoid disk quota problems, please make sure that all files that you place in the SoLID directories are owned by Linux group 12gev_solid. If you've already created files that have the wrong group, just change the group ID of your directory and all its files and subdirectories to the correct one. You only should have to do this once:

chgrp -R 12gev_solid your-directory

To make this happen automatically for all newly created files in this directory, set the sgid bit on it:

chmod g+s your-directory

Better yet, set this bit for all subdirectories as well:

find your-directory -type d -exec chmod g+s {} \;

Again, you should only have to do this once.

Additionally, to reduce the chance of file access problems, every time you log in and before starting work in SoLID disk areas, switch your effective group ID to 12gev_solid:

newgrp 12gev_solid

Exit from the shell when done; that will return you to where you were before issuing the newgrp command.

old simulation software (for record keeping only, don't use it!)

• SoLID GEMC (simulation in GEANT4 with GEMC 1.x, used for later proposals and pCDR)

• SoLID Comgeant (simulation in GEANT3 used for the early proposals)