"Motor" container
From TrainzOnline
(Difference between revisions)
(→throttle-notches: expand, clarify, link to dependent container) |
(+{{ORP-top}}+{{ORP-bot}}+{{cont-Engine}}, clarify) |
||
| Line 1: | Line 1: | ||
| − | {{ | + | {{FUN-beg}} |
| − | The Motor container is a top-level [[config.txt file]] entry used by [[KIND Engine | + | {{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 8: | 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 | + | 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<!-- 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 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 65: | Line 67: | ||
====axle-count==== | ====axle-count==== | ||
:Type: Integer | :Type: Integer | ||
| − | :Desc: Number of axles on this vehicle. Used in rolling [ | + | :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 [ | + | :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 [ | + | :Desc: Used in rolling [[#Resistance_calculations |resistance calculations]]. |
====air-drag-coefficient==== | ====air-drag-coefficient==== | ||
:Type: Decimal | :Type: Decimal | ||
| − | :Desc: Used in air [ | + | :Desc: Used in air [[#Resistance_calculations |resistance calculations]]. |
====full-throttle-speed==== | ====full-throttle-speed==== | ||
| Line 87: | Line 89: | ||
: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== | ==Resistance calculations== | ||
| Line 98: | 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 104: | 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== | ||
| + | |||
| + | ''TBD'' | ||
| + | |||
| + | [[Category:Config Container|motor-container]] | ||
| + | {{cont-Engine|motor-container}} | ||
| + | {{ORP-bot|motor-container}}<div>{{FUN-bot|motor-container}} | ||
Revision as of 05:56, 24 September 2013
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 |
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.∅
resistance
- Type: Decimal
- Desc: Not used
adhesion
- Type: Decimal
- Desc: Not used
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...)
maxspeed
- Type: Decimal
- Desc: Maximum speed in DCC mode.
brakeratio
- Type: Decimal
- Desc: Coefficient between the pressure in brake cylinder and the brake force.
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.
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.
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.
axle-count
- Type: Integer
- Desc: Number of axles on this vehicle. Used in rolling resistance calculations.
surface-area
- Type: Decimal
- Desc: frontal surface area (sq ft) of vehicle. Used in air resistance calculations.
moving-friction-coefficient
- Type: Decimal
- Desc: Used in rolling resistance calculations.
air-drag-coefficient
- Type: Decimal
- Desc: Used in air resistance calculations.
full-throttle-speed
- Type: Decimal
- Desc:
Notes: TRS2006-SP0 reports this tag as an error in a "container-type 'motor'"
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.
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 -)
Example motor container
TBD
