DF DCTrackVisualizer Install and Run Instruction

From New IAC Wiki
Revision as of 22:03, 22 December 2018 by Friadavi (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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:
  • 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

Put new error messages here:

Main Page

User:Friadavi