Software

 

FTPC Software

  • Overview of the FTPC software
  • List of the FTPC software location and contact people

Calibration Software

Simulation and Reconstruction Software

  •  SEE FTPC in ITTF for information on Maria Mora's integration of the FTPC into ITTF

 

How to

 

 

 

 

 

 

 

 

 

 

 

 

List

 

Group

Task Description/Problems

Location of Source Code

Contact

DAQ

 

 

 

 

Map FTPC electonics to DAQ

$CVSROOT/online/ftpc/MapFtpcElectronicsToDaq

Janet

 

FTPC "gain table" for DAQ

 

Frank

Online

 

 

 

 

FTPC Detector Control
     Documentation
     Interactive control panels running under
     ftpccrew@cassini.starp

/afs/rhic.bnl.gov/star/doc_public/www/ftpc/Operations

Terry

 

Slow Control

 

Terry

 

FTPC Slow Control Monitoring Facility
Plots and lists contents of slow control archives
(On January 23 the FTPC Y2004 slow control archive was split into 2 parts.)

 

Terry

 

Pad Monitor

$CVSROOT/online/ftpc/FtpcPadMonitor

Janet

 

Online Tools:
     1) Event Pool Reader - read and histogram events from /evp
     2) FTPC Display - evp event->*.ps file which contains 2-D
         pad vs. timebin plots and 3-D plots of deposited charge
     3) Noise Finder - evp event -> *.ps file which shows dead
         and/or noisy pads (see page 23 !!)

 

Terry

Janet

 

Online histograms ("Panitkin plots")

 

Janet

Drift Velocity Monitor

OBSOLETE

 

 

 

LabView program running on bond.starp

 

 

 

bond.starp -> virgo.starp samba connection

 

 

 

virgo.starp cron job - copies files from /DV2/Today to /DV2/Store

 

 

 

Conversion of DVM data files to root format

 

 

 

StFtpcDVMMaker - DVM data analysis programs

$CVSROOT/offline/StFtpcDVMMaker

 

Calibration

 

 

 

 

Noise Finder:
     GetGain,FindNoise,WriteAmpSlope

 

Terry

 

Drift Maps:
     Magboltz1

 

 

     Magboltz2

 

 

$CVSROOT/StRoot/StFtpcDriftMapMaker
$CVSROOT/StRoot/macros/examples/FtpcDriftMapMaker.C

$CVSROOT/online/ftpc/Magboltz2

Janet

 

Laser Analysis:
     1) Convert st_laser*.daq files to *.root files
     2) StFtpcLaserMaker

 

Terry

Databases

 

 

 

 

Slow Control -> Online database -> Offline database

 

Terry

 

Offline database:
     Geometry_ftpc/
                               ftpcAsicMap
                               ftpcClusterGeometry
                               ftpcDimensions
                               ftpcInnerCathode
                               ftpcPadrowZ
     Calibrations_ftpc/
                               ftpcAmpOffset
                               ftpcAmpSlope
                               ftpcCoordTrans
                               ftpcDeflection
                               ftpcDriftField
                               ftpcEField
                               ftpcElectronics
                               ftpcGas
                               ftpcGasOut
                               ftpcGasSystem
                               ftpcTimeOffset
                               ftpcVDrift
                               ftpcVoltage
                               ftpcdDeflectiondP
                               ftpcdVDriftdP

 

Terry

 

StDb/idl - idl definition files for FTPC database tables

$CVSROOT/StDb/idl

Janet

Simulation/ Reconstruction

 

 

 

 

StFtpcSlowSimMaker

$CVSROOT/StRoot/StFtpcSlowSimMaker

Frank

 

StFtpcClusterMaker

$CVSROOT/StRoot/StFtpcClusterMaker

Joern

 

StFtpcTrackMaker

$CVSROOT/StRoot/StFtpcTrackMaker

Markus

 

pams/ftpc/idl
     FTPC idl files used in FTPC Slow Simulator

$CVSROOT/pams/ftpc/idl

Janet

QA

 

 

 

 

St_QA_Maker

$CVSROOT/StRoot/St_QA_Maker

Gene

Janet

Embedding

 

 

 

 

StFtpcMixerMaker

$CVSROOT/StRoot/StFtpcMixerMaker

Frank

Analysis

 

 

 

 

StFtpcMcAnalysisMaker
     creates the NTuples used for efficiency, momentum
     resolution and so on by a wide variety of tools.
     (Code works but not yet ready to pass a CVS code
     review)

 

Frank

ITTF

 

 

 

 

StiFtpc

$CVSROOT/StRoot/StiFtpc

Maria Mora-Corall

Documentation

 

 

 

 

Web pages

/afs/rhic.bnl.gov/star/doc_public/www/ftpc
/afs/rhic.bnl.gov/star/doc_private/www/ftpc

Janet

 
This page was written by Janet Seyboth on Febuary 10, 2004

 

 

Online

 

FTPC "Online" Calibration Software

The FTPC "online" calibration software is a collection of programs and macros which run on the FTPC
online machines (virgo-run09.starp,cassini-run09.starp) processing either data directly from the event pool or from
a *.daq file.


All the FTPC calibration software is committed to the online/ftpc branch of the STAR CVS reposititory.
Each committed module contains a README file and a doc subdirectory which contain all the pertinent
information regarding the purpose and use of the program and/or macros contained in the module.

The FTPC "online" calibration program library is located on virgo-run09.starp in /data/FtpcOnlineLibrary
and can be used from the ftpccrew account on virgo-run09.starp.



Attention: The FTPC 3-D display software does not run with ROOT_LEVEL 4.04.02


                                                      Programs in the FtpcOnlineLibrary
Calib_Tool:
                     
calib_tool creates a graphical user interface which allows the user to interactively analyze
                      the *.root files produced when the daq files from an FTPC laser run are processed
                     with the FTPC "private chain". The FTPC "private chain" produces a special output
                     file when DEBUGFILE is defined in StFtpcClusterMaker and StFtpcTrackMaker.

CardFinder:
                    The
CardFinder utilities,PadAnalysisCreate and PadAnalysisWrite, analyze the pads, locate
                    the bad and/or noisy chips and produce lists of the bad electronics.

EvpPoolReader:
                     Reads, processes and displays event(s) from the event pool: /evp/a, /evp/b or
                     the "live" stream (the event which is currently being input into the event pool).
                     Due to firewall restrictions you can only access the event pool and the live stream from the  starp sub-net .
                    Click
here for running instructions.
FtpcPadMonitor:
                   
padmon is a software program designed for monitoring the FTPC hardware performance.

NoiseFinder:
                  
NoiseFinder contains the programs and macros which produce the FTPC online and offline
                  gain tables.
                 Run the NoiseFinder programs GetGain and FindNoise from the FtpcOnlineLibrary
                 on virgo.starp.bnl.gov to create a gain table. The gain table flags out dead
                 and/or noisy pads. The NoiseFinder utility, WriteAmpSlope_cc.so, converts the
                 gain table into an ftpcAmpSlope.C file which is added to the offline data base
                 in the Calibrations_ftpc/ftpcAmpSlope table.

Online_Tool:
                 Online_Tool contains the shell script ftpc_display and the L3 display
                 macros. The ftpc_display shell script provides an interface to FTPC online
                 event processing. An event from the event pool or from a daq file is read in
                and the cluster finding and tracking results are displayed with the 3-D viewer.
                Click
here for running instructions.

 

calib_tool

FTPC Calib_Tool

calib_tool creates a graphical user interface which allows the user to interactively analyze
the *.root files produced when the daq files from an FTPC laser run are processed with
the FTPC "private chain"
           "ftpc db globT detDb tpcDb dbutil in dst event"

The FTPC "private chain" produces a special output file when DEBUGFILE is defined in
StFtpcClusterMaker and StFtpcTrackMaker.

For information on calib_tool, type

     calib_tool -h

Which will print the following

Usage: calib_tool [-l] [-b] [-n] [-q] [dir] [file1.root]
Options:
        -b : run in batch mode without graphics
        -n : do not execute logon and logoff macros as specified in .rootrc
        -q : exit after processing command line macro files
        -l : do not show splash screen
       dir : if dir is a valid directory cd to it before executing

    ?        : print usage
   -h        : print usage
  --help    : print usage
  -config  : print ./configure options

Choose [dir] and [file] via panel. There is a sample *.root file in the examples
sub-directory.

 

This page was created by Janet Seyboth on March 7, 2006

Overview

This page was updated by Janet Seyboth on January 25, 2001

 

Reconstruction

 

FTPC Reconstruction

 

 

 

Hit Finding

                               StFtpcClusterMaker Documentation

If raw data already exists, either produced by the FTPC slow simulator (StFtpcSlowSimMaker) or from a daq data import, StFtpcClusterMaker will immediately invoke the cluster finder StFtpcClusterFinder . Otherwise, the FTPC fast simulator StFtpcFastSimu will be invoked to generate hits from geant data.


 

Tracking

 

StFtpcTrackMaker - FTPC Conformal Mapping Tracker

The StFtpcTrackMaker replaces St_fpt_Maker in the FTPC reconstruction chain.

 

StFtpcTrackMaker uses the clusters from StFtpcClusterMaker to reconstruct the tracks in the FTPC using conformal mapping. A list of all the "found" hits along with the number actually found and the maximum number of hits possible are saved for each track.

Then these "found" hits are fit using a 2x2-D track fitter. The impact parameter at the pre-vertex is calculated. All tracks with an impact parameter less than max_Dca are flagged as primary track candidates whose vertex is the pre-vertex. The momentum fit results for the unconstrained fit are saved in the track table.

 

  • Software documentation
  • FTPC Tracking Algorithms
  • Efficiency and contamination plots
  • Contamination study
  • Some nice pictures
  •  

     

     

     

     

     

     

     
     
     
     

     14553 Geant hits (about 1000 tracks per Ftpc) after being tracked with the new Conformal Mapping Algorithm.


    Markus Oldenburg

     

    Last modified: Apr 20 2005

     

     

     

     

    Simulation

     

    FTPC geometry

    • ftpcgeo  - FTPC geant geometry definitions

     

    Momentum Resolution

     

    Mock Data challenges

     

    FTPC Fast Simulator

     

    FTPC Slow Simulator

     

     

     

     

     

    HF Momentum Resolution Study

     

    FTPC Half Field Momentum Resolution Study

    This page shows results of some tests done in Munich to estimate the effect running at half the normal magnetic field strength would have on the FTPCs' momentum resolution.

    The tests were done comparing the momentum resolution of two venus runs produced for mock data challenge 2. MDC 2 data is not very suitable for FTPC testing as it was calculated at extremely high geant resolution, so that each track caused several hits in each padrow. However, all the available data at half field is from MDC 2.

    One event of each run was processed through the fast simulation chain, assuming that the quality of ExB corrections will not change with the field strength. Fast simulation makes it possible to compare reconstructed tracks to geant tracks by simply comparing the constituent points.

    The plots show the reconstructed momentum divided by the geant momentum and are in good agreement with earlier studies done with realistic simulation parameters and the measured magnet field. (Earlier simulations done by Michael Konrad assuming a perfectly uniform field looked somewhat better.) Only perfectly reconstructed tracks with 10 hits that actually belonged to the same geant track are used in the plot.

    The first plot shows the resolution at full magnetic field, the second at half field. Both peaks are nicely centered around one, showing essentially correct momentum resolution, but the RMS of the distribution increases from 15 to 20 percent when going to half the magnetic field. This is in contradiction with the obvious assumption of a linear increase of the errors, which, however, is not really to be expected at closer inspection. Also, the number of properly reconstructed tracks is smaller in the second plot, but it is yet unclear if this is due to a larger range of delta spirals in the smaller field, to some other effect or just statistics.

    Full field:

    Half field:

     


     

     

    MDC1

    FTPC and MDC1

    The FTPC slow simulator chain:

    • fss --- The FTPC Slow Simulator
    • fcl --- The FTPC CLuster finder
    • fpt --- The FTPC tracker
    • fte - track evaluator

       

    was included in the bfc.kumac for MDC1. NO dst information was written out.

    Results:

    We were able to find and correct programming errors which caused NaN's.

    This page was written by Janet Seyboth on February 6, 1999

     

     

    MDC2

    FTPC and MDC2

     

    In MDC2, the GEANT step size in the FTPC acceptance was reduced, so that every passing particle left a series of geant hits in every padrow. This became a serious challenge for the FTPC software and, even after optimization, increased the calculation time significantly. To get high-statistics for strangeness studies in the TPC, the planned schedule was changed in favor of more TPC fast simulator runs. Therefore, only a small number of events was run through the FTPC chain in MDC2, both with and without the slow simulator.

    The complete FTPC slow simulator chain was run in the ROOT chain macro (bfc.C):

    • St_fss_Maker --- The FTPC Slow Simulator
    • St_fcl_Maker --- The FTPC CLuster finder
      In runs when no raw_data from the FTPC slow simulator exists, St_fcl_Maker ran the FTPC fast simulator module
      ffs.

       

    • St_fpt_Maker --- ran the following FTPC modules:

      fpt - track finder

      fte - track evaluator

      fde - dE/dx calculator

    The FTPC track, point and dE/dx information was written out to the dst by St_glb_Maker.

    This page was written by Janet Seyboth on February 6, 1999

     

     

    MDC4

    FTPC and MDC4

    BNL, April 26 - May 10, 2001

    Status History for FTPC in MDC4

    Reconstruction

    Purpose - MDC4 gave us the opportunity to test the performance and stability of our reconstruction chain with a large amount of simulated data before real data taking begins. It was the first large scale test of our slow simulator and cluster finder.

    MDC4 Datasets - Dataset A (20,000 Au+Au MEVSIM events), DataSet B (100,000 pp PYTHIA events) and Dataset C (Au+Au peripheral STARLIGHT events) were processed in MDC4

    BFC Chains - The FTPC ran only in the Au+Au BFC chain since our simulators can not handle pile-up

    starnew new->SL00d

    ROOT 3.00.06

    bfc.C(#events,"MDC4","input dataset")

    Identified Reconstruction Tasks

    Implement StAssociationMaker

    Pileup - we have to add pileup to our simulators in order to process pp simulation data (Contact: Akio,Jan)

    Chisq - determine the correct values for the $STAR/StarDb/ftpc/ftpcClusterPars.C parameters 
                       timeDiffusionErrors[1]
                       timeDiffusionErrors[2] 
    

    Reconstructed Datasets on FTPC BNL Cluster

    There are 80 MEVSIM events in /cassini/data1/MDC4/Gstar/rcf0181_01_80evts.fzd

    A complete set of output *.root files for these 80 events is available in /cassini/data1/MDC4

    Analysis

    Status - The analysis half of MDC4 was held for Friday, May 4 - Thursday, May 10

    PWGs Expectations - The analysis focused on the new detectors and their physics capabilities

    Spectra PWG - larger acceptance with FTPC

    EbyE PWG - flow with FTPC

    Strangeness PWG - first attempts to find v0's in FTPC

    MDC4 Status Meetings

    There was a telephone conference each Tuesday and Thursday at 3pm EST in the White Pit in Bldg. 118 (dial in x8261)

    MDC4 Wrap-up Meeting

     

    On Thursday, May 10 starting around 1:30pm EST there was a wrap-up meeting. Each sub-system was requested to summarize their experiences gained in MDC4 regarding efficiencies,problems encountered, etc. This summary should also contain a short summary on the new physics capabilities

    JPWG Meeting

    A PWG Workshop was held for Thursday, May 10 - Monday, May 14


    This page was written by Janet Seyboth on April 27, 2001

     

    Sim vs. Real Data - dAu

    Comparison Slow Simulator and Real data dAu Min Bias


    The Distribution of the number of hits-on-global-track is NOT the same for Real Data and Simulation with Hijing through the Slow Simulator (?) What happens with all this 10-hit-on-track ? The used Gain Table is not good enough to reproduce the holes?
     
     

    FTPC West FTPC East
    AuAu minbias with low multiplicity in comparison with dAu min bias REAL DATA and SIMULATION AuAu minbias with low multiplicity in comparison with dAu min bias REAL DATA and SIMULATION
    REAL DATA SIMULATION

     

    The residuals are much better for Simulation than for Real data. We still need to do something here )-:

     

     

    Sim vs. Real Data - AuAu

    Comparison Slow Simulator and Real data for AuAu minbias events

    The trend with the variation of the number of hits on track with the multiplicity is the same for Real Data and Simulation with Hijing through the Slow Simulator
     
     

    FTPC East
      AuAu minbias REAL DATA from Low Multiplicity (red) to High multiplicity (blue) AuAu minbias SIMULATION from Low Multiplicity (red) to High multiplicity (blue)
    FTPC West
      AuAu minbias REAL DATA from Low Multiplicity (red) to High multiplicity (blue) AuAu minbias SIMULATION from Low Multiplicity (red) to High multiplicity (blue)

     

    The residuals are much better for Simulation than for Real data. We still need to do something here )-:

     

     

    StFtpcFastSimu

    StFtpcFastSimu - FTPC Fast Simulator

    The FTPC fast simulator is implemented in C++ (as a part of StFtpcClusterMaker).

    It was converted from Fortran (pam/ffs) to C++ by Holm Hümmler and is supported by Janet Seyboth.

    StFtpcFastSimu simply takes the hit points registered by geant and turns them into FTPC points. Some cuts are applied to remove points that are outside the sensitive volume of the FTPC sectors and to account for the loss of hits due to cluster merging. Some of the geant information is kept in the gepoint table to be used in efficiency studies.

     

    ftpcgeo

    ftpcgeo.g

    ftpcgeo.g defines the geometry for the FTPC in geant simulations. It contains information about the main aluminum cylinder, its support structures, the fieldcage and a rather detailed description of the readout chambers, and it defines the sensitive volumes.

    Other geometry files of interest for the FTPC simulation are pipegeo.g for the beampipe and svttgeo.g with a description of the SVT, its support cone, the beampipe support and the shield layers.

    This page was updated by Holm Hümmler on September 16, 1999