"Motor" container
From TrainzOnline
(Difference between revisions)
(→Resistance calculations) |
|||
| (22 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
| − | The Motor container is a top-level [[config.txt file]] entry used by [[KIND Engine | + | {{FUN-beg}} |
| + | {{ORP-top}} | ||
| + | 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 [[KIND Map|route]]. | ||
==Supported Tags== | ==Supported Tags== | ||
| Line 7: | Line 9: | ||
motor | motor | ||
{ | { | ||
| − | resistance 1.7 | + | resistance 1.7 |
| − | adhesion 5.0 | + | adhesion 5.0 |
| − | maxvoltage 600.0 | + | maxvoltage 600.0 |
| − | maxspeed 33.3 | + | maxspeed 33.3 |
| − | brakeratio 55000 | + | brakeratio 55000 |
| − | max-accel 3500 | + | max-accel 3500 |
| − | max-decel 9000 | + | max-decel 9000 |
| − | throttle-notches 8 | + | throttle-notches<big>**</big> 8 |
| − | axle-count 6 | + | axle-count 6 |
| − | surface-area 80.0 | + | surface-area 80.0 |
| − | moving-friction-coefficient 0.03 | + | moving-friction-coefficient 0.03 |
| − | air-drag-coefficient 0.00017 | + | air-drag-coefficient 0.00017 |
| − | full-throttle-speed 33.0 | + | full-throttle-speed<big>*</big> 33.0 |
| − | driving-wheel-weight-ratio 1.0 | + | driving-wheel-weight-ratio 1.0 |
} | } | ||
| + | '''* ''' - Omit/delete as an illegal value in TRS2006 and versions before.<!-- or where and whenever the software installed it. Someone add a build number of one or the other kind ---> {{Tech question}} | ||
| + | '''** - Omit/delete as an illegal value in versions before TRS2004.<!-- or where and whenever the software installed it. Someone add a build number of one or the other kind ---> {{Tech question}} | ||
====resistance==== | ====resistance==== | ||
| Line 41: | Line 45: | ||
====brakeratio==== | ====brakeratio==== | ||
:Type: Decimal | :Type: Decimal | ||
| − | :Desc: | + | :Desc: Coefficient between the pressure in brake cylinder and the brake force. |
====max-accel==== | ====max-accel==== | ||
| Line 51: | Line 55: | ||
: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. | :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. | ||
| − | ====throttle-notches==== | + | ==== throttle-notches ==== |
| − | :Type: Integer | + | :'''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" container|"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|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. | ||
====axle-count==== | ====axle-count==== | ||
:Type: Integer | :Type: Integer | ||
| − | :Desc: Number of axles on this vehicle. Used in rolling resistance calculations. | + | :Desc: Number of axles on this vehicle. Used in rolling [[#Resistance_calculations |resistance calculations]]. |
====surface-area==== | ====surface-area==== | ||
:Type: Decimal | :Type: Decimal | ||
| − | :Desc: frontal surface area (sq ft) of vehicle. Used in air resistance calculations. | + | :Desc: frontal surface area (sq ft) of vehicle. Used in air [[#Resistance_calculations |resistance calculations]]. |
====moving-friction-coefficient==== | ====moving-friction-coefficient==== | ||
:Type: Decimal | :Type: Decimal | ||
| − | :Desc: Used in rolling resistance calculations. | + | :Desc: Used in rolling [[#Resistance_calculations |resistance calculations]]. |
====air-drag-coefficient==== | ====air-drag-coefficient==== | ||
:Type: Decimal | :Type: Decimal | ||
| − | :Desc: Used in air resistance calculations. | + | :Desc: Used in air [[#Resistance_calculations |resistance calculations]]. |
====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'" | ||
====driving-wheel-weight-ratio==== | ====driving-wheel-weight-ratio==== | ||
:Type: Decimal | :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. | :Desc: Ratio (between 0.0 and 1.0) of the weight of this vehicle bearing down on driven wheels. Used by steam locos only. | ||
| + | |||
| + | ==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<br><br> | ||
| + | |||
| + | R = total resistance in lb. including grade resistance<br> | ||
| + | V = speed - mph<br> | ||
| + | m = weight of the vehicle (tons)<br> | ||
| + | G = % grade (upgrade +, downgrade -)<br> | ||
==Example motor container== | ==Example motor container== | ||
| Line 83: | Line 105: | ||
''TBD'' | ''TBD'' | ||
| − | [[Category:Config Container]] | + | [[Category:Config Container|motor-container]] |
| + | {{cont-Engine|motor-container}} | ||
| + | {{ORP-bot|motor-container}}<div>{{FUN-bot|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
