"Motor" container

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
(→‎Resistance calculations)
Line 1: Line 1:
−
{{FUN-beg}}
+
The Motor container is a top-level [[config.txt file]] entry used by [[KIND Engine|Enginespec]] and [[KIND Steam-engine|Steam Enginespec]] assets.
−
{{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 9: Line 7:
 
  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<big>**</big>                      8
+
     throttle-notches               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<big>*</big>        33.0
+
     full-throttle-speed           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 56: Line 52:
  
 
==== throttle-notches ====
 
==== 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) &mdash;the dependent '''[["Throttle-power" container]]'''.
+
:Type: Integer
−
:* 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: Number of throttle notches.
−
:'''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====
Line 83: Line 73:
 
====full-throttle-speed====
 
====full-throttle-speed====
 
:Type: Decimal
 
:Type: Decimal
−
:Desc: Maximum speed with DCC throttle at 100%
+
:Desc: Obsolete- no longer used. (Previously: 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====
Line 101: Line 90:
 
G = % grade (upgrade +, downgrade -)<br>
 
G = % grade (upgrade +, downgrade -)<br>
  
−
==Example motor container==
 
−
 
−
''TBD''
 
  
 
[[Category:Config Container|motor-container]]
 
[[Category:Config Container|motor-container]]
 
{{cont-Engine|motor-container}}
 
{{cont-Engine|motor-container}}
 
{{ORP-bot|motor-container}}<div>{{FUN-bot|motor-container}}
 
{{ORP-bot|motor-container}}<div>{{FUN-bot|motor-container}}

Revision as of 16:28, 8 September 2025

The Motor container is a top-level config.txt file entry used by Enginespec and Steam Enginespec assets.

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
}

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
Description: Number of throttle notches.

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: Obsolete- no longer used. (Previously: maximum speed with DCC throttle at 100%)

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 -)

Retrieved from "https://game.ts2009.com/mediaWiki/index.php?title=%22Motor%22_container&oldid=45015"
Personal tools