Open Rails - Standard Load Animation Parameters

Aim - this section describes the basic standard physics parameters required to correctly define Load Animation physics in Open Rails Train Simulator.

If you wish to provide any feedback on this page, please use the contact page. It would be great to have some feedback as this helps to ensure the accuracy of the information and models.

Index

Load Animation - Dynamic - General

Load Animation - Dynamic - Empty

Load Animation - Dynamic - Full


Notes: The default unit of measure (UoM) shown in the "Recommended Input Units" column is the UoM value that OR assumes if no UoM is included in the parameter statement.

Make sure that the various parameters are inserted into the correct locations in the INCLUDE file. See the previous page for guidance.

ParameterENG or WAGDescriptionRecommended Input UnitsSuggested settingsNew or ExistingTypical Examples
Load Animation - Dynamic - General
This section describe the general (common) parameters used to define the operation of load animation for dynamic loads.
MSTSFreightAnimEnabled ( x )WAG (INC File)Enables or disables existing MSTS freight animations.NumericAs per wagon specifications:
0 = Not Gondola
1 = Gondola.
NewMSTSFreightAnimEnabled ( 0 )
IsGondola ( x )WAG (INC File)Specifies whether the wagon is to be rotated to be unloaded, such is the case for a Gondola wagon.NumericAs per wagon specifications:
0 = Not Gondola
1 = Gondola.
NewIsGondola ( 0 )
UnloadingStartDelay ( x )WAG (INC File)Specifies the delay once the T key is pressed, and how long before unloading begins.TimeAs per wagon specifications.NewUnloadingStartDelay ( 2s )
FullAtStart ( x )WAG (INC File)Indicates whether the wagon is full or empty when OR starts.NumericAs per wagon specifications:
0 = Empty
1 = Full.
NewFullAtStart ( 0 )
IntakePoint ( Offset Width Type )WAG (INC File)Provides details on the intake point used by the wagon for loading and unloading.TimeAs per wagon specifications:
Offset = Distance from wagon centre axis.
Width = Size of fill opening.
Type = Type of freight load (from table on previous page).
NewIntakePoint ( 0.0 6.0 FreightCoal )
Shape ( x )WAG (INC File)Provides details on the shape file used by the wagon for loading and unloading animation. Not required if no visible animation is used.File NameAs per wagon specifications.NewShape ( H_Coal.s )
MaxHeight ( x )WAG (INC File)Indicates the height of the animation shape over the "zero" height axis of the shape when the wagon is full.Distance - m, cm, mm, km, in, ft, in/2
Default - m
As per wagon specifications.NewMaxHeight ( 0.1m )
MinHeight ( x )WAG (INC File)Indicates the height of the animation shape over the "zero" height axis of the shape when the wagon is empty.Distance - m, cm, mm, km, in, ft, in/2
Default - m
As per wagon specifications.NewMinHeight ( -0.85m )
ORTSWaterScoopFillElevation ( x )ENGIndicates the height of water scoop above the water surface of the trough.Distance - m, cm, mm, km, in, ft, in/2
Default - m
As per wagon specifications.NewORTSWaterScoopFillElevation ( 9.0m )
ORTSWaterScoopDepth ( x )ENGIndicates the depth that the water scoop is dipped into the trough.Distance - m, cm, mm, km, in, ft, in/2
Default - m
As per wagon specifications.NewORTSWaterScoopDepth ( 0.1m )
ORTSWaterScoopWidth ( x )ENGIndicates the width of the water sccop at the point where it is dipped into the trough.Distance - m, cm, mm, km, in, ft, in/2
Default - m
As per wagon specifications.NewORTSWaterScoopWidth ( 0.3m )
FreightAnim ( x y z )WAGIndicates the load animation shape file to be used for varying the visual height effects of the load.Text
or
Distance - m, cm, mm, km, in, ft, in/2
Default - m
As per wagon specifications.ExistingFreightAnim ( coal.s 0.01 -1.25 )
Load Animation - Dynamic - Empty
This section describe the parameters used to define the operation of load animation for dynamic loads, and set the wagon to its empty state.
WagonEmptyWeight ( x )WAG (INC File)Describes the empty weight of the wagon.Mass - lbs, kg, t, t-uk, t-us
Default - kg
As per wagon specificationsNewWagonEmptyWeight ( 10.0kt-uk )
EmptyMaxBrakeForce ( x )WAG (INC File)Describes the empty max brake force of the wagon.Force - N, kN, lbf
Default - Newtons
As per wagon specificationsNewEmptyMaxBrakeForce ( 29.892kN )
EmptyMaxHandbrakeForce ( x )WAG (INC File)Describes the empty max handbrake force of the wagon.Force - N, kN, lbf
Default - Newtons
As per wagon specificationsNewEmptyMaxHandbrakeForce ( 9.964kN )
EmptyORTSDavis_A ( x )WAG (INC File)Describes the empty Davis A constant of the wagon.Force - N, kN, lbf
Default - Newtons
As per wagon specifications.
(FCalc is used to calculate standard resistance values.)
NewEmptyORTSDavis_A ( 580.71 )
EmptyORTSDavis_B ( x )WAG (INC File)Describes the empty Davis B constant of the wagon.Resistance - N/m/s, lbf/mph
Default - N/m/s
As per wagon specifications.
(FCalc is used to calculate standard resistance values.)
NewEmptyORTSDavis_B ( 5.0148 )
EmptyORTSDavis_C ( x )WAG (INC File)Describes the empty Davis C constant of the wagon.ResistanceDavisC - Nm/s^2, lbf/mph^2
Default - Nm/s^2
As per wagon specifications.
(FCalc is used to calculate standard resistance values.)
NewEmptyORTSDavis_C ( 0.694782 )
EmptyCentreOfGravity_Y ( x )WAG (INC File)Describes the empty centre of gravity for the wagon.Distance - m, cm, mm, km, in, ft, in/2
Default - m
As per wagon specifications.NewEmptyCentreOfGravity_Y ( 1.41m )
EmptyORTSWagonFrontalArea ( x )WAG (INC File)Describes the empty centre of gravity for the wagon.AreaDefaultFT2 - ft^2, m^2
Default - ft^2
As per wagon specifications.NewEmptyORTSWagonFrontalArea ( 60.0ft^2 )
EmptyORTSDavisDragConstant ( x )WAG (INC File)Describes the empty centre of gravity for the wagon.Numeric - should be the imperial constant.As per wagon specifications.NewEmptyORTSDavisDragConstant ( 0.005 )
Load Animation - Dynamic - Full
This section describe the parameters used to define the operation of load animation for dynamic loads, and set the wagon to its full state.
FreightWeightWhenFull ( x )WAG (INC File)Describes the weight of freight or goods loaded onto the wagon.Mass - lbs, kg, t, t-uk, t-us
Default - kg
As per wagon specificationsNew FreightWeightWhenFull ( 10.0kt-uk )
FullMaxBrakeForce ( x )WAG (INC File)Describes the full max brake force of the wagon.Force - N, kN, lbf
Default - Newtons
As per wagon specificationsNewFullMaxBrakeForce ( 29.892kN )
FullMaxHandbrakeForce ( x )WAG (INC File)Describes the full max handbrake force of the wagon.Force - N, kN, lbf
Default - Newtons
As per wagon specificationsNewFullMaxHandbrakeForce ( 9.964kN )
FullORTSDavis_A ( x )WAG (INC File)Describes the full Davis A constant of the wagon.Force - N, kN, lbf
Default - Newtons
As per wagon specifications.
(FCalc is used to calculate standard resistance values.)
NewFullORTSDavis_A ( 580.71 )
FullORTSDavis_B ( x )WAG (INC File)Describes the full Davis B constant of the wagon.Resistance - N/m/s, lbf/mph
Default - N/m/s
As per wagon specifications.
(FCalc is used to calculate standard resistance values.)
NewFullORTSDavis_B ( 5.0148 )
FullORTSDavis_C ( x )WAG (INC File)Describes the full Davis C constant of the wagon.ResistanceDavisC - Nm/s^2, lbf/mph^2
Default - Nm/s^2
As per wagon specifications.
(FCalc is used to calculate standard resistance values.)
NewFullORTSDavis_C ( 0.694782 )
FullCentreOfGravity_Y ( x )WAG (INC File)Describes the full centre of gravity for the wagon.Distance - m, cm, mm, km, in, ft, in/2
Default - m
As per wagon specifications.NewFullCentreOfGravity_Y ( 1.41m )
FullORTSWagonFrontalArea ( x )WAG (INC File)Describes the full centre of gravity for the wagon.AreaDefaultFT2 - ft^2, m^2
Default - ft^2
As per wagon specifications.NewFullORTSWagonFrontalArea ( 60.0ft^2 )
FullORTSDavisDragConstant ( x )WAG (INC File)Describes the full centre of gravity for the wagon.Numeric - should be the imperial constant.As per wagon specifications.NewFullORTSDavisDragConstant ( 0.005 )

top