"Motor" container

Revision as of 16:38, 8 September 2025 (view source) Pw3r (Talk | contribs) ← Older edit		Latest revision as of 20:01, 9 September 2025 (view source) Pw3r (Talk | contribs) (→‎throttle-notches)
Line 53:		Line 53:
	==== throttle-notches ====		==== throttle-notches ====
	:Type: Integer		:Type: Integer
−	:Description: Number of throttle notches.	+	: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.
	====axle-count====		====axle-count====

---

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 1 Supported Tags 1.1 resistance 1.2 adhesion 1.3 maxvoltage 1.4 maxspeed 1.5 brakeratio 1.6 max-accel 1.7 max-decel 1.8 throttle-notches 1.9 axle-count 1.10 surface-area 1.11 moving-friction-coefficient 1.12 air-drag-coefficient 1.13 full-throttle-speed 1.14 driving-wheel-weight-ratio 2 Resistance calculations

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