"Motor" container
From TrainzOnline
(Difference between revisions)
(+{{ORP-top}}+{{ORP-bot}}+{{cont-Engine}}, clarify) |
(→Resistance calculations) |
||
| (One intermediate revision by one user not shown) | |||
| Line 83: | Line 83: | ||
====full-throttle-speed==== | ====full-throttle-speed==== | ||
:Type: Decimal | :Type: Decimal | ||
| − | :Desc: | + | :Desc: Maximum speed with DCC throttle at 100% |
Notes: TRS2006-SP0 reports this tag as an error in a "container-type 'motor'" | Notes: TRS2006-SP0 reports this tag as an error in a "container-type 'motor'" | ||
| Line 94: | Line 94: | ||
These calculations occur according to Davis formula: | These calculations occur according to Davis formula: | ||
| − | R = (1. | + | R = (1.3·m + 29·axle-count) + moving-friction-coefficient·m·V + air-drag-coefficient·surface-area·V^2 + 20·m·G<br><br> |
R = total resistance in lb. including grade resistance<br> | R = total resistance in lb. including grade resistance<br> | ||
| Line 100: | Line 100: | ||
m = weight of the vehicle (tons)<br> | m = weight of the vehicle (tons)<br> | ||
G = % grade (upgrade +, downgrade -)<br> | G = % grade (upgrade +, downgrade -)<br> | ||
| − | |||
==Example motor container== | ==Example motor container== | ||
Latest revision as of 05:55, 14 January 2014
The Motor container is a top-level config.txt file entry used to define gross physics performance factors for a powered vehicle defined within the Trainz game engine. The container is used by config.txt files for KIND Engine (internal combustion Enginespecs) and KIND Steam-engine (Steam Enginespecs, external combustion engines) containing vehicular assets, including drivable boats, planes and automobile based vehicles inside the virtual reality of a route.
Contents |
[edit] Supported Tags
The Motor container supports the following tags. Each tag is show here with its default value.
motor
{
resistance 1.7
adhesion 5.0
maxvoltage 600.0
maxspeed 33.3
brakeratio 55000
max-accel 3500
max-decel 9000
throttle-notches** 8
axle-count 6
surface-area 80.0
moving-friction-coefficient 0.03
air-drag-coefficient 0.00017
full-throttle-speed* 33.0
driving-wheel-weight-ratio 1.0
}
* - Omit/delete as an illegal value in TRS2006 and versions before.∅ ** - Omit/delete as an illegal value in versions before TRS2004.∅
[edit] resistance
- Type: Decimal
- Desc: Not used
[edit] adhesion
- Type: Decimal
- Desc: Not used
[edit] maxvoltage
- Type: Decimal
- Desc: Voltage to traction motors. This is used to scale the ammeter displayed in the cab. (Power is volts times amps - increasing the voltage means reducing the ammeter...)
[edit] maxspeed
- Type: Decimal
- Desc: Maximum speed in DCC mode.
[edit] brakeratio
- Type: Decimal
- Desc: Coefficient between the pressure in brake cylinder and the brake force.
[edit] max-accel
- Type: Decimal
- Desc: Accelerative force available in DCC mode. Note - this is a force, not a rate of acceleration. The rate of acceleration will depend on the mass of the train as well.
[edit] max-decel
- Type: Decimal
- Desc: Decelerative force available in DCC mode. Note - this is a force, not a rate of deceleration. The rate of deceleration will depend on the mass of the train as well.
[edit] throttle-notches
- Type: Integer, defined as the index of the last array-element with non-zero values in an array of arrays (container of sub-containers) —the dependent "Throttle-power" container.
- the contained arrays are the arrays-listing-paired-values (steps-of max speed and acceleration thrust force)— so the throttle-notches value is the last index# of an (nn+1)th element array listing elements made of other subcontainers (arrays of paired numbers which define points on a speed-power graph; and which has no fixed number of paired datum requirements; one engine spec might list 14, another 12 or 20).
- Description: Can be viewed as the Number of "Power-is-applied" throttle-notches listed in the "Throttle-power" arrays of paired values (container) with power applied—not counting 'OFF' or zero power applied.
- Not an total-elements or count-of-elements value, but the last legal index of the last element (nn) in an 1+nn-element array where the first element is idexed by 0 (zero).
- The first or Zeroth-indexed element has a value of zero, corresponding to Zero power applied, or Neutral.
- Value indicated must correspond to the number of NON-ZERO data arrays listed in the throttle-power container (a table of entries).
- Each table element takes one index number in an array, so eight throttle notches (Diesel, no dynamic brakes) has nine array elements corresponding to a correct throttle-notches value of 8 (eight)—No Power, and eight Power Applied steps.
- Dynamic brakes creates a doubling of elements and indexes, so a diesel with dynamic brakes will list 16 as the throttle-notches tag value, whilst the 'throttle-power' arrays will have 18 total elements —in this case: two zero power states, dynamic brakes engaged or not (normal) engaged states.
[edit] axle-count
- Type: Integer
- Desc: Number of axles on this vehicle. Used in rolling resistance calculations.
[edit] surface-area
- Type: Decimal
- Desc: frontal surface area (sq ft) of vehicle. Used in air resistance calculations.
[edit] moving-friction-coefficient
- Type: Decimal
- Desc: Used in rolling resistance calculations.
[edit] air-drag-coefficient
- Type: Decimal
- Desc: Used in air resistance calculations.
[edit] full-throttle-speed
- Type: Decimal
- Desc: Maximum speed with DCC throttle at 100%
Notes: TRS2006-SP0 reports this tag as an error in a "container-type 'motor'"
[edit] driving-wheel-weight-ratio
- Type: Decimal
- Desc: Ratio (between 0.0 and 1.0) of the weight of this vehicle bearing down on driven wheels. Used by steam locos only.
[edit] Resistance calculations
These calculations occur according to Davis formula:
R = (1.3·m + 29·axle-count) + moving-friction-coefficient·m·V + air-drag-coefficient·surface-area·V^2 + 20·m·G
R = total resistance in lb. including grade resistance
V = speed - mph
m = weight of the vehicle (tons)
G = % grade (upgrade +, downgrade -)
[edit] Example motor container
TBD
