Page History

...

Prerequisites

To build the org.lcsim software, you first need to should have the following installed.

• Java JDK 1.5.x (aka 5.0) (from http://java.sun.com/j2se/1.5.0/download.jsp)
• Maven (from http://maven.apache.org)
• cvs (normally preinstalled on linux, for windows you can download from here)

...

• Netbeans IDE 4.1 (optional but recommended)
  • install the Netbeans with JDK 5.0 bundle if you don't already have a suitable Java SDK installed
• Maven
  • Follow the instructions at Installing Maven with Netbeans Support to setup Maven.
• CVS client

SLAC Unix Tools

The tools above , with the exception of Netbeans, are all
pre-installed on SLAC Unix.

...

Just issue the command:

setenv JAVAVER 1.5

to make sure you get

...

the correct Java version.

Building org.lcsim software

The lcsim software consists of two packages, the a geometry package,
and the analysis and reconstruction package. You must obtain and
build the geometry package first, since the analysis package
depends on it.

Here are condensed instructions:, which you can execute from
the Linux or Cygwin bash shell.

setenvexport CVSROOT =:pserver:anonymous@cvs.freehep.org:/cvs/lcd
cvs login (just hit enter when prompted for password)
cvs co GeomConverter
cvs co lcsim
cd GeomConverter
maven
cd ../lcsim
maven

Keeping the

...

Release Current

Oftentimes new directories are added in a new release. In order
to make sure that cvs adds those, please use the command

cvs update -PdA

which will

P: prune empty directories
d: create directories
A: reset sticky tags

man cvs

knows more will give more information on the cvs program.

Installing Custom JARs into JAS3

Developers of org.lcsim may want to use a version in JAS3 that is more up-to-date
than the distributed plugin.

Execute the following from the lcsim checkout directory to install the lcsim target
JAR into the JAS3 extensions directory, overwriting the JAR that was automatically
downloaded.

maven jas:install

...

If you wish to build without testing, issue the following command, but do this at your own risk:

maven -Dmaven.test.skip=true

To execute a single test case (, e.g. that for org.lcsim.recon.cluster.fixedcone.FixedConeClusterer):

maven test:single -Dtestcase=org.lcsim.recon.cluster.fixedcone.FixedConeClustererTest

ant -f ctest.xml

Running Classes from the

...

Command Line

We have defined a maven Maven goal to allow that allows users to run a java class using maven Java class in the project from the command line.

...

using the freehep-run-plugin.

For example:

 maven run -Drun.class="org.lcsim.geometry.compact.converter.heprep.Main" -Dargs="test/org/lcsim/geometry/compact/sdjan03_compact.xml tst.heprep"

The documentation for the plugin is in:

http://java.freehep.org/freehep-run-plugin/index.html^{Image Removed}

Building org.lcsim with NetBeans

In addition to the above you will need:

• NetBeans 4.1 (from http://www.netbeans.org/community/releases/41/index.html)
• Mevenide plugin for Netbeans (from http://mevenide.codehaus.org/download.html).

Once these are installed you can open the project folders in NetBeans and build using maven from inside netbeansabove command run the Main class to convert the given compact description to a HepRep.

Building org.lcsim with Eclipse

Instead of NetBeans, you can also use the Eclipse IDE to build org.lcsim and write your applications.

Download Eclipse: http://eclipse.org/downloads/index.php

The Mevenide plugin can be installed as follows:

Help->Software Updates->Find and Install...

Select "Search for new features to install", click 'Finish'

Select "New Remote Site"; for Name enter "Mevenide", for Location enter http://mevenide.codehaus.org/release/eclipse/update/site.xml

Select the latest versions of both Maven and the Mevenide plugins, click 'Next'

You will have to agree to a license agreement.

The plugin will then be downloaded.

Confirm the installation with 'Install All'

When finished, you will be asked to restart the workbench.

Click 'Yes'.

...