Differences

This shows you the differences between two versions of the page.

--- fcs:eic:track_optimization [2017/08/23 02:59]
dblyth [prototypeStrategy.xml]
+++ fcs:eic:track_optimization [2017/08/23 03:08] (current)
dblyth [trainingSample.slcio]
@@ Line 1: / Line 1: @@
 ====== Track strategy tuning ======
-The LCSim Java package used for track reconstruction in the FPaDSim software chain relies on a list of "tracking strategies," which is a list of tracking layer collections for seeding, confirming, and extending tracks.  These collections must be optimized for a particular geometry configuration and can be tuned for minimum number of hits, max chi^2, etc.  In order to optimize the strategies list, a representative data set must be simulated, containing a significant number of tracks that span the phase space and particle species to be tracked.  This then serves as an input to the strategy list builder built into the LCSim package.  Additionally, a set of configuration files specify the requirements of the track fit, and the parameters used for the seeding algorithm.
+The LCSim Java package (nameley the SeedTracker driver) used for track reconstruction in the FPaDSim software chain relies on a list of "tracking strategies," which is a list of tracking layer collections for seeding, confirming, and extending tracks.  These collections must be optimized for a particular geometry configuration and can be tuned for minimum number of hits, max chi^2, etc.  In order to optimize the strategies list, a representative data set must be simulated, containing a significant number of tracks that span the phase space and particle species to be tracked.  This then serves as an input to the strategy list builder built into the LCSim package.  Additionally, a set of configuration files specify the requirements of the track fit, and the parameters used for the seeding algorithm.
 The ingredients for building the strategy list are...
@@ Line 9: / Line 9: @@
 ===== trainingSample.slcio =====
-Generated in FPaDSim with SLIC, this file serves as a broad representation of tracks to be fitted.  A reasonable approach is to fill this file with various species of particles, each flatly distributed in pseudorapidity and an appropriate range of transverse momenta.
+Generated in FPaDSim with SLIC, this file serves as a broad representation of tracks to be fitted.  A reasonable approach is to fill this file with various species of particles, each flatly distributed in pseudorapidity and an appropriate range of transverse momenta.  It is possible to simulate the different particle species separately, and then concatenate the slcio files.
 ===== strategyBuilder.xml =====
-An example file is found below.  In this file, seed parameters like minimum number of hit layers, and the number of layers used for seeding are specified.
+An example file is found below.  This file tells LCSim to run the StrategyBuilder driver, and gives seed parameters like minimum number of hit layers, and the number of layers used for seeding are specified.
   <lcsim xmlns:lcsim="http://www.lcsim.org/schemas/lcsim/1.0"
@@ Line 129: / Line 129: @@
     </Layers>
   </LayerWeight>
+===== Running the strategy builder =====
+The strategies list can then be built by running the following command...
+  java -jar <lcsim distribution jar path> \
+    -DprototypeStrategyFile=prototypeStrategy.xml \
+    -DlayerWeightsFile=layerWeights.xml \
+    -DtrainingSampleFile=trainingSample.slcio \
+    -DoutputStrategyFile=trackingStrategies.xml \
+    strategyBuilder.xml
+The trackingStrategies.xml file is the output of the StrategyBuilder driver, which can then be passed to the SeedTracker driver during reconstruction.