Users Manual for Program KPF_ROT

The program reads a table from file and rotates the point cluster an angle LUT or translates the point cluster the distance YH. NOTE BENE only one command of LUT or YH can be given in the input data file in the same run. If neither LUT and YH are defined in input data, program KPF_ROT will just orient INFIL according to YAXIS and ZAXIS, and write the result to UTFIL. No zero adjustments will be made. The calculation of the new point cluster is carried out in the following way:

Read X-, Y- values from INFIL.
Orient axis according to YAXIS and ZAXIS.
If YH has been given do the following:
Translate the point cluster laterally a distance YH.
Adjust the point cluster vertically so that z(y=0)=0.
If LUT has been given do the following:
Calculate polar co-ordinates of each point relative origin (0,0).
Add angle LUT to the polar co-ordinates of each point.
Calculate the Cartesian co-ordinates of each point.
Adjust the point cluster vertically so the flange contact point is 14 mm from top of rail.
Finally, independently of YH or LUT:
Write the result to UTFIL.

INPUT DATA

Input data are written in free format:

ADJUST_ZERO

Adjustment of origin after rotating or translating the profile. ADJUST_ZERO may have the following values:

yes	=>	Origin of a wheel profile will be located at the tread, 70[mm] laterally spaced from the inside of the wheel. Origin of the rail head will be located on top of rail GAUGE_TO_ORIGO [mm] laterally spaced from the gauge measuring point.
no	=>	No zero adjustments will take place after translating or rotating the profile.

Declared = Character*4 Default = 'yes'

INFIL

Input data file.
Declared = Character*132 Default = Blank

UTFIL

Output data file.
Declared = Character*132 Default = Blank

LUT

Rotational angle, positive value gives a right handed rotation.
Declared = Real*4 Default = 0.[rad]

YH

Lateral translation of the point cluster, positive value gives larger gauge.
Declared = Real*4 Default = 0.

GAUGE_TO_ORIGO

Defines the lateral distance between the origin of the rail (nominal running circle) and the gauge measuring point. As default, GAUGE_TO_ORIGO is set to 32.5 mm which is the case for normal gauge track.
Declared = Real*4 Default = 32.5

YAXIS

Orientation of the Y-axis. YAXIS may have the following values:

1	=>	Read Y-axis is used as is.
-1	=>	Read Y-axis is used with reversed sign.
2	=>	Read Z-axis is used as Y-axis.
-2	=>	Read Z-axis is used as Y-axis but with reversed sign.

Declared = Real*4 Default = 1

ZAXIS

Orientation of the Z-axis. ZAXIS may have the following values:

1	=>	Read Y-axis is used as Z-axis.
-1	=>	Read Y-axis is used as Z-axis but with reversed sign.
2	=>	Read Z-axis is used as is.
-2	=>	Read Z-axis is used with reversed sign.

Declared = Real*4 Default = 1

Example of an input data file

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

                                                                                 
 #                                                                               
 #      Input data for program KPF_ROT                                           
 #                                                                               
                                                                                 
  INFIL= $genkpf/../r_prof/uic60/uic60i00.rail # Reading rail profile            
  UTFIL= uic60i40.kpf_rotr                                                       
 #                                                                               
 #INFIL= $genkpf/../w_prof/S1002/S1002.wheel   # Reading wheel profile           
 #UTFIL= S1002.kpf_rotr                                                          
                                                                                 
  YAXIS = 1  # Use the first column on INFIL as Y-axis                           
 #YAXIS =-1  # Use the first column on INFIL as Y-axis, but with reversed sign.  
  ZAXIS = 2  # Use the second column on INFIL as Z-axis                          
 #ZAXIS =-2  # Use the second column on INFIL as Z-axis, but with reversed sign. 
                                                                                 
                                                                                 
  ADJUST_ZERO = yes      # After rotation or translation adjust the origin        
                         # of the profile.                                       
  GAUGE_TO_ORIGO= 32.5   # Define the distance between origin of the rail         
                         # and the gauge measuring point.                        
                                                                                 
 ##                                                                              
 ##                                                                              
 ##      Define operation to be applied to the profile                           
 ##      Nota Bene: only one of YH and LUT can be given.                         
 ##      ----------------------------------------------                          
                                                                                 
 #YH  =-10.0     # Translate the profile 10 mm toward smaller gauge.             
 #                                                                               
  LUT= .025      # Rotate the rail profile angle LUT.                            
                 # LUT is given in radians.