DF DCTrackVisualizer Install and Run Instruction

These instruction are specifically for installing and running the DCTrackVisualizer program.

Install

• If you intend to work on the code, install NetBeans if you haven't already. See here for details.
• Move to or create you're preferred directory. I would suggest NetBeansProjects as a default.
• Clone the following Github repository:
  • friadavi/clas12-offline-software
  • git clone https://github.com/friadavi/clas12-offline-software.git
• Checkout the dcVisualizer branch
  • git checkout dcVisualizer
• Execute build-coatjava.sh
  • I recommend appending --nounittests and --nospotbugs so that the build doesn't take forever.
• The software should now be installed.

Running

Simply run <install directory>/clas12-offline-software/coatjava/bin/dctrackviz. Note that it may be necessary to use bash instead of ./ as the script may not source env.sh otherwise.

Install within Netbeans

To open the project in NetBeans:

• Open NetBeans
• Click on File > Open Project
• Go to the install directory
• Open the project clas-viz under clas12-offline-software > common-tools.
• Edit to your heart's delight.

You may need to change the default run directory:

• In the projects pane, right click on clas-viz
• Click on properties
• Click on "Run" in the Categories pane
• Change the working directory to point to your clas12-offline-software directory.

Also Ensure that the following environmental variables are set within NetBeans:

• Open the Project Properties window.
• Click on "Actions"
• Select "Run project" from the "Actions sub-menu"
• Set the following properties:
  • Env.CLAS12DIR=path/to/clas12-offline-software/coatjava
    • This can be either an absolute path or a path relative to the working directory you've set.
  • Env.SOLENOIDMAP=<name of the solenoid map file you want to use>.dat
  • Env.TORUSMAP=<name of the torus map file you want to use>.dat

Error Messages

TORUS map not found

java.io.FileNotFoundException:TORUS map not found at [null/etc/data/magfield/null]

ls clas12-offline-software/etc/data/magfield$ ls

Symm_solenoid_r601_phi1_z1201_13June2018.dat  Symm_torus_r2501_phi16_z251_24Apr2018.dat

Main Page

User:Friadavi