Open Rails

Axle Members

Axle overview

Public Static Methods

Friction Optional Friction computation function - Computes Davis formula for given parameters: Fo = Weight / 9810 * (A + B * V + C * V^2)

Public Instance Constructors

Axle Overloaded. Initializes a new instance of the Axle class.

Public Instance Fields

AxleRevolutionsInt Integrator used for axle dynamic solving
FilterMovingAverage
ResetTime

Public Instance Properties

Adhesion2 Read/Write Adhesion2 parameter from the ENG/WAG file, used to correct the adhesion Should not be zero
AdhesionConditions Read/Write adhesion conditions parameter Should be set within the range of 0.3 to 1.2 but there is no restriction - Set 1.0 for dry weather (standard) - Set 0.7 for wet, rainy weather
AdhesionK Read/Write correction parameter of adhesion, it has proportional impact on adhesion limit Should be set to 1.0 for most cases
AxleDiameterM Read/Write nonzero positive axle diameter parameter, in metric meters Throws exception when zero or negative value is passed
AxleForceN Read only axle force value, in Newtons
AxleSpeedMpS Read only axle speed value, in metric meters per second
AxleWeightN Read/Write axle weight parameter in Newtons
BrakeForceN Read/Write positive only brake force to the axle, in Newtons
CurtiusKnifflerA Curtius-Kniffler equation A parameter
CurtiusKnifflerB Curtius-Kniffler equation B parameter
CurtiusKnifflerC Curtius-Kniffler equation C parameter
DampingNs Read/Write positive only damping force to the axle, in Newton-second
DriveForceN Read/Write drive force used to pass the force directly to the axle without gearbox, in Newtons
DriveType Read/Write Axle drive type flag
FrictionN
InertiaKgm2 Read/Write positive non zero only axle inertia, in kg.m^2 By setting this parameter the totalInertiaKgm2 is updated Throws exception when zero or negative value is passed
IsWheelSlip Read only wheel slip indicator - is true when absolute value of SlipSpeedMpS is greater than WheelSlipThresholdMpS, otherwise is false
IsWheelSlipWarning Read only wheelslip warning indication - is true when SlipSpeedMpS is greater than zero and SlipSpeedPercent is greater than SlipWarningThresholdPercent in both directions, otherwise is false
Motor Read/Write Motor drive parameter. With setting a value the totalInertiaKgm2 is updated
SlipDerivationMpSS Read only slip speed rate of change, in metric (meters per second) per second
SlipDerivationPercentpS Read only relative slip speed rate of change, in percent per second
SlipSpeedMpS Read only slip speed value in metric meters per second - computed as a substraction of axle speed and train speed
SlipSpeedPercent Read only relative slip speed value, in percent - the value is relative to WheelSlipThreshold value
SlipWarningTresholdPercent Read/Write relative slip speed warning threshold value, in percent of maximal effective slip
StabilityCorrection Read/Write flag to enable/disable stability correction. If enabled, AdhesionK is increased by 0.05 each time the slipSpeedDerivationPercent reaches 1000%/s This causes the slip characteristics to be more flat what reduces oscilations.
TrainSpeedMpS Read/Write train speed parameter in metric meters per second
TransmissionEfficiency Read/Write transmission efficiency, relative to 1.0, within range of 0.0 to 1.0 (1.0 means 100%, 0.5 means 50%) Throws an exception when out of range value is passed When 0.0 is set the value of 0.99 is used instead
TransmissionRatio Read/Write positive nonzero transmission ratio, given by n1:n2 ratio Throws an exception when negative or zero value is passed
WheelSlipThresholdMpS Read only wheelslip threshold value used to indicate maximal effective slip - its value si computed as a maximum of slip function: 2*K*umax^2 * dV f(dV) = u = --------------------- umax^2*dV^2 + K^2 maximum can be found as a derivation f'(dV) = 0

Public Instance Methods

Equals (inherited from Object)Determines whether the specified Object is equal to the current Object.
GetHashCode (inherited from Object)Serves as a hash function for a particular type.
GetType (inherited from Object)Gets the type of the current instance.
ResetOverloaded. Resets all integral values (set to zero)
SlipCharacteristics Slip characteristics computation - Computes adhesion limit using Curtius-Kniffler formula: 7.5 umax = --------------------- + 0.161 speed * 3.6 + 44.0 - Computes slip speed - Computes relative adhesion force as a result of slip characteristics: 2*K*umax^2*dV u = --------------------- umax^2*dv^2 + K^2
ToString (inherited from Object)Returns a string that represents the current object.
Update Main Update method - computes slip characteristics to get new axle force - computes axle dynamic model according to its driveType - computes wheelslip indicators

Protected Instance Fields

brakeForceN Brake force covered by BrakeForceN interface
dampingNs Damping force covered by DampingForceN interface
driveForceN Drive force covered by DriveForceN interface, in Newtons
driveType Axle drive type covered by DriveType interface
frictionN
previousSlipPercent Relativ slip speed from previous iteration
previousSlipSpeedMpS Slip speed memorized from previous iteration
slipDerivationMpSS Slip speed rate of change value, in metric (meters per second) per second
slipDerivationPercentpS Relative slip rate of change
totalForceN Total force to store sum of all functions

Protected Instance Methods

Finalize (inherited from Object)Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
MemberwiseClone (inherited from Object)Creates a shallow copy of the current Object.

See Also

Axle Class | ORTS Namespace