"Motor" container

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
 
(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|Enginespec]] and [[KIND Steam-engine|Steam Enginespec]] assets.
+
{{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) &mdash;the dependent '''[["Throttle-power" container]]'''.
:Desc: Number of throttle notches
+
:* the contained arrays are the arrays-listing-paired-values (steps-of max speed and acceleration thrust force)&mdash; 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&mdash;'''''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)&mdash;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'' &mdash;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.
  1. 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).
    1. The first or Zeroth-indexed element has a value of zero, corresponding to Zero power applied, or Neutral.
    2. Value indicated must correspond to the number of NON-ZERO data arrays listed in the throttle-power container (a table of entries).
  2. 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.
  3. 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

Personal tools