Home    Reference Manuals    Return    Track Group Documentation



Users Manual for Program TRC_CONCAT  



Table of Contents

   Introduction
   Input data commands
   Examples



Program TRC_CONCAT writes separate ASCII-files into a file in TRAC-, TRAX-, TRAX_WDESIGN-, MAUZ- or PLAS-format. All input data files must have the same consecutive steps in their X-axle, but they must not start at the same longitudinal coordinate, because program trc_concat adjusts the longitudinal positions of all input files so all will be in the same phase in the output file.


Input data commands

Input data is read in free format, valid separators between the input values are <space>, <comma>, <tab>, <equal sign> or <carriage return>. The commands can be written both in lower and upper case letters. The operation of the program is controlled by the commands described below; some of the commands also need arguments.


DX
Equidistant step between the points written to RESFIL.
Declared= Real*4    Default= Same step as read from file LATFIL

FORMAT
Choose the format of the output data file.
The user can choose between the formats TRAC-, TRAX-, TRAX_WDESIGN-, MAUZ- or PLAS-format.
Declared= Character*12    Default= TRAX

Following input data is read if FORMAT equals TRAC, TRAX or TRAX_WDESIGN:

LATFIL
Data file containing lateral irregularities.
The file is read according to format FORMLAT.
Declared = Character*132    Default = Blank

VERTFIL
Data file containing vertical irregularities.
The file is read according to format FORMVERT.
Declared = Character*132    Default = Blank

SPVFIL
Data file containing gauge irregularities.
The file is read according to format FORMSPV.
Declared = Character*132    Default = Blank

TWISTFIL
Data file containing cant irregularities.
The file is read according to format FORMTWIST.
Declared = Character*132    Default = Blank

DESIGN_1R
Data file containing designed horizontal curvature.
The file is read according to format FORM_DESIGN_1R.
Declared = Character*132    Default = Blank

DESIGN_FI
Data file containing designed cant.
The file is read according to format FORM_DESIGN_FI.
Declared = Character*132    Default = Blank

DESIGN_Z
Data file containing designed vertical lift.
The file is read according to format FORM_DESIGN_Z.
Declared = Character*132    Default = Blank

FORMLAT
The format in which the lateral irregularities from file LATFIL should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. Or the format can be given one of the following values:
SNGL =  reads column 1 & 2 as if the variable was written in single precision
CMPLX =  reads column 1 & 3 as if the variable was written in complex precision
(a,a) =  reads column 1 & 2
(a,x,a) =  reads column 1 & 3
(a,x,x,a) =  reads column 1 & 4
(a,x,x,x,a) =  reads column 1 & 5
(a,x,x,x,x,a) =  reads column 1 & 6
(a,x,x,x,x,x,a) =  reads column 1 & 7
(a,x,x,x,x,x,x,a) =  reads column 1 & 8
(a,x,x,x,x,x,x,x,a) =  reads column 1 & 9
(a,x,x,x,x,x,x,x,x,a) =  reads column 1 & 10
Declared= Character*80    Default= CMPLX

FORMVERT
The format in which the vertical irregularities from file VERTFIL should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. Or the format can be given one of the following values:
SNGL =  reads column 1 & 2 as if the variable was written in single precision
CMPLX =  reads column 1 & 3 as if the variable was written in complex precision
(a,a) =  reads column 1 & 2
(a,x,a) =  reads column 1 & 3
(a,x,x,a) =  reads column 1 & 4
(a,x,x,x,a) =  reads column 1 & 5
(a,x,x,x,x,a) =  reads column 1 & 6
(a,x,x,x,x,x,a) =  reads column 1 & 7
(a,x,x,x,x,x,x,a) =  reads column 1 & 8
(a,x,x,x,x,x,x,x,a) =  reads column 1 & 9
(a,x,x,x,x,x,x,x,x,a) =  reads column 1 & 10
Declared= Character*80    Default= CMPLX

FORMSPV
The format in which the gauge irregularities from file SPVFIL should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. Or the format can be given one of the following values:
SNGL =  reads column 1 & 2 as if the variable was written in single precision
CMPLX =  reads column 1 & 3 as if the variable was written in complex precision
(a,a) =  reads column 1 & 2
(a,x,a) =  reads column 1 & 3
(a,x,x,a) =  reads column 1 & 4
(a,x,x,x,a) =  reads column 1 & 5
(a,x,x,x,x,a) =  reads column 1 & 6
(a,x,x,x,x,x,a) =  reads column 1 & 7
(a,x,x,x,x,x,x,a) =  reads column 1 & 8
(a,x,x,x,x,x,x,x,a) =  reads column 1 & 9
(a,x,x,x,x,x,x,x,x,a) =  reads column 1 & 10
Declared= Character*80    Default= CMPLX

FORMTWIST
The format in which the cant irregularities from file TWISTFIL should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. Or the format can be given one of the following values:
SNGL =  reads column 1 & 2 as if the variable was written in single precision
CMPLX =  reads column 1 & 3 as if the variable was written in complex precision
(a,a) =  reads column 1 & 2
(a,x,a) =  reads column 1 & 3
(a,x,x,a) =  reads column 1 & 4
(a,x,x,x,a) =  reads column 1 & 5
(a,x,x,x,x,a) =  reads column 1 & 6
(a,x,x,x,x,x,a) =  reads column 1 & 7
(a,x,x,x,x,x,x,a) =  reads column 1 & 8
(a,x,x,x,x,x,x,x,a) =  reads column 1 & 9
(a,x,x,x,x,x,x,x,x,a) =  reads column 1 & 10
Declared= Character*80    Default= CMPLX

FORM_DESIGN_1R
The format in which the designed horizontal curvature from file DESIGN_1R should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. Or the format can be given one of the following values:
SNGL =  reads column 1 & 2 as if the variable was written in single precision
CMPLX =  reads column 1 & 3 as if the variable was written in complex precision
(a,a) =  reads column 1 & 2
(a,x,a) =  reads column 1 & 3
(a,x,x,a) =  reads column 1 & 4
(a,x,x,x,a) =  reads column 1 & 5
(a,x,x,x,x,a) =  reads column 1 & 6
(a,x,x,x,x,x,a) =  reads column 1 & 7
(a,x,x,x,x,x,x,a) =  reads column 1 & 8
(a,x,x,x,x,x,x,x,a) =  reads column 1 & 9
(a,x,x,x,x,x,x,x,x,a) =  reads column 1 & 10
Declared= Character*80    Default= CMPLX

FORM_DESIGN_FI
The format in which the designed cant from file DESIGN_FI should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. Or the format can be given one of the following values:
SNGL =  reads column 1 & 2 as if the variable was written in single precision
CMPLX =  reads column 1 & 3 as if the variable was written in complex precision
(a,a) =  reads column 1 & 2
(a,x,a) =  reads column 1 & 3
(a,x,x,a) =  reads column 1 & 4
(a,x,x,x,a) =  reads column 1 & 5
(a,x,x,x,x,a) =  reads column 1 & 6
(a,x,x,x,x,x,a) =  reads column 1 & 7
(a,x,x,x,x,x,x,a) =  reads column 1 & 8
(a,x,x,x,x,x,x,x,a) =  reads column 1 & 9
(a,x,x,x,x,x,x,x,x,a) =  reads column 1 & 10
Declared= Character*80    Default= CMPLX

FORM_DESIGN_Z
The format in which the designed vertical lift from file DESIGN_Z should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. Or the format can be given one of the following values:
SNGL =  reads column 1 & 2 as if the variable was written in single precision
CMPLX =  reads column 1 & 3 as if the variable was written in complex precision
(a,a) =  reads column 1 & 2
(a,x,a) =  reads column 1 & 3
(a,x,x,a) =  reads column 1 & 4
(a,x,x,x,a) =  reads column 1 & 5
(a,x,x,x,x,a) =  reads column 1 & 6
(a,x,x,x,x,x,a) =  reads column 1 & 7
(a,x,x,x,x,x,x,a) =  reads column 1 & 8
(a,x,x,x,x,x,x,x,a) =  reads column 1 & 9
(a,x,x,x,x,x,x,x,x,a) =  reads column 1 & 10
Declared= Character*80    Default= CMPLX

Following input data is read if FORMAT equals MAUZ or PLAS:

LINE_1
Pen 1, Vertical level right wheel.
Declared= Character*132    Default= Blank

LINE_2
Pen 2, Vertical level left wheel.
Declared = Character*132    Default = Blank

LINE_3
Pen 3, Cant unevenness.
Declared = Character*132    Default = Blank

LINE_4
Pen 4, Twist.
Declared = Character*132    Default = Blank

LINE_5
Pen 5, Lateral versine right wheel.
Declared = Character*132    Default = Blank

LINE_6
Pen 6, Lateral versine left wheel.
Declared = Character*132    Default = Blank

LINE_7
Pen 7, Gauge.
Declared = Character*132    Default = Blank

FORML1
The format in which the file LINE_1 should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. In order to read file LINE_1 in free format, FORML1 can be given one of the following values:
SNGL = reads column 1 & 2 as if the variable was written in single precision
CMPLX = reads column 1 & 3 as if the variable was written in complex precision
Declared= Character*80    Default= CMPLX

FORML2
The format in which the file LINE_2 should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. In order to read file LINE_2 in free format, FORML2 can be given one of the following values:
SNGL = reads column 1 & 2 as if the variable was written in single precision
CMPLX = reads column 1 & 3 as if the variable was written in complex precision
Declared= Character*80    Default= CMPLX

FORML3
The format in which the file LINE_3 should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. In order to read file LINE_3 in free format, FORML3 can be given one of the following values:
SNGL = reads column 1 & 2 as if the variable was written in single precision
CMPLX = reads column 1 & 3 as if the variable was written in complex precision
Declared= Character*80    Default= CMPLX

FORML4
The format in which the file LINE_4 should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. In order to read file LINE_4 in free format, FORML4 can be given one of the following values:
SNGL = reads column 1 & 2 as if the variable was written in single precision
CMPLX = reads column 1 & 3 as if the variable was written in complex precision
Declared= Character*80    Default= CMPLX

FORML5
The format in which the file LINE_5 should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. In order to read file LINE_5 in free format, FORML5 can be given one of the following values:
SNGL = reads column 1 & 2 as if the variable was written in single precision
CMPLX = reads column 1 & 3 as if the variable was written in complex precision
Declared= Character*80    Default= CMPLX

FORML6
The format in which the file LINE_6 should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. In order to read file LINE_6 in free format, FORML6 can be given one of the following values:
SNGL = reads column 1 & 2 as if the variable was written in single precision
CMPLX = reads column 1 & 3 as if the variable was written in complex precision
Declared= Character*80    Default= CMPLX

FORML7
The format in which the file LINE_7 should be read. The format specification must be written in a way that it can be used in a FORTRAN read statement. In order to read file LINE_7 in free format, FORML7 can be given one of the following values:
SNGL = reads column 1 & 2 as if the variable was written in single precision
CMPLX = reads column 1 & 3 as if the variable was written in complex precision
Declared= Character*80    Default= CMPLX
RESFIL
Output data file.
Declared= Character*132    Default= Blank


Example of an input data file

Following example: Master.trc_concatf can be used as a master file: 

                                                          
 ##                                                       
 ##    Input data for program TRC_CONCAT                  
 ##                                                       
                                                          
 ##                                                       
 ##    Write track data in format TRAX_WDESIGN            
 ##                                                       
   FORMAT   = TRAX_WDESIGN                                
   FORMLAT  = CMPLX   LATFIL  = lat_file                  
   FORMVERT = CMPLX   VERTFIL = vert_file                 
   FORMTWIST= CMPLX   TWISTFIL= twist_file                
   FORMSPV  = CMPLX   SPVFIL  = spv_file                  
   DX = 0.5                                               
                                                          
   RESFIL= test/resfile.trax_wdesign                      
                                                          
 ##                                                       
 ##    Write track data in format MAUZ                    
 ##                                                       
 # FORMAT= MAUZ                                           
 # FORML1= sngl  LINE_1= test/cos_f5.sngl                 
 # FORML2= sngl  LINE_2= test/cos_f5.sngl                 
 # FORML3= sngl  LINE_3= test/cos_f5.sngl                 
 # FORML4= sngl  LINE_4= test/cos_f5.sngl                 
 # FORML5= sngl  LINE_5= test/cos_f5.sngl                 
 # FORML6= sngl  LINE_6= test/cos_f5.sngl                 
 # FORML7= sngl  LINE_7= test/cos_f5.sngl                 
 # DX = 1.0                                               
 #                                                        
 # RESFIL= test/resfile.mauz