"Motor" container

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
(→‎throttle-notches: expand, clarify, link to dependent container)
(→‎throttle-notches)
 
(5 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
{{TOCright}}
 
 
The Motor container is a top-level [[config.txt file]] entry used by [[KIND Engine|Enginespec]] and [[KIND Steam-engine|Steam Enginespec]] assets.
 
The Motor container is a top-level [[config.txt file]] entry used by [[KIND Engine|Enginespec]] and [[KIND Steam-engine|Steam Enginespec]] assets.
  
Line 8: 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 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 33.0<big>*</big>
+
     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<!-- or where and whenever the software installed it. Someone add a build number of one or the other kind --->{{Tech question}}
 
  
 
====resistance====
 
====resistance====
Line 54: 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 in the cabin. In the vast majority of cases this will be 8, but limited support does exists for other values.
−
:'''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 [http://online.ts2009.com/mediaWiki/index.php5/%22Motor%22_container#Resistance_calculations 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 [http://online.ts2009.com/mediaWiki/index.php5/%22Motor%22_container#Resistance_calculations 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 [http://online.ts2009.com/mediaWiki/index.php5/%22Motor%22_container#Resistance_calculations resistance calculations].
+
:Desc: Used in rolling [[#Resistance_calculations |resistance calculations]].
  
 
====air-drag-coefficient====
 
====air-drag-coefficient====
 
:Type: Decimal
 
:Type: Decimal
−
:Desc: Used in air [http://online.ts2009.com/mediaWiki/index.php5/%22Motor%22_container#Resistance_calculations resistance calculations].
+
:Desc: Used in air [[#Resistance_calculations |resistance calculations]].
  
 
====full-throttle-speed====
 
====full-throttle-speed====
 
:Type: Decimal
 
:Type: Decimal
−
:Desc:
+
: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====
 
: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.
−
 
−
==Example motor container==
 
−
 
−
''TBD''
 
−
 
−
[[Category:Config Container]]
 
  
 
==Resistance calculations==
 
==Resistance calculations==
Line 98: Line 83:
 
These calculations occur according to Davis formula:
 
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 = (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 89:
 
m = weight of the vehicle (tons)<br>
 
m = weight of the vehicle (tons)<br>
 
G = % grade (upgrade +, downgrade -)<br>
 
G = % grade (upgrade +, downgrade -)<br>
 +
 +
 +
[[Category:Config Container|motor-container]]
 +
{{cont-Engine|motor-container}}
 +
{{ORP-bot|motor-container}}<div>{{FUN-bot|motor-container}}

Latest revision as of 20:01, 9 September 2025

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

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
}

[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
Description: Number of throttle notches in the cabin. In the vast majority of cases this will be 8, but limited support does exists for other values.

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

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

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