Revision as of 18:03, 19 March 2016

(in testing stage, simulation part is with GMEC 2.x)

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.2 (as in 2016/01)

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/01)

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