"Motor" container - Revision history

Pw3r: /* throttle-notches */

2026-09-30T23:29:43Z

throttle-notches

← Older revision		Revision as of 23:29, 30 September 2026
Line 53:		Line 53:
	==== throttle-notches ====		==== throttle-notches ====
	:Type: Integer		: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~~.		:Description: Specifies the number of throttle notches in the cabin. By default, all (non-steam) locos have 8 throttle notches, but this may be overridden with this tag. Note that this has no impact on train power output, unless the engine also enables the [[KIND_Engine#throttle-power-extended-notch-range\|throttle-power-extended-notch-range]] or [[KIND_Engine#dynamic-brake-extended-notch-range\|dynamic-brake-extended-notch-range]] options, and provides the relevant data in the power output graphs.

	====axle-count====		====axle-count====

Pw3r: /* throttle-notches */

2025-09-09T10:01:44Z

throttle-notches

← Older revision		Revision as of 10:01, 9 September 2025
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====

Pw3r at 06:38, 8 September 2025

2025-09-08T06:38:54Z

← Older revision		Revision as of 06:38, 8 September 2025
Line 61:		Line 61:
	====surface-area====		====surface-area====
	:Type: Decimal		:Type: Decimal
	:Desc: ~~frontal~~ surface area (sq ft) of vehicle. Used in air [[#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====

Pw3r at 06:28, 8 September 2025

2025-09-08T06:28:40Z

← Older revision		Revision as of 06:28, 8 September 2025
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) —the dependent '''[["Throttle-power" container]]'''.~~		:Type: Integer
	:* 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: 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—'''''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)—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====		====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}}

Scottbe8: /* Resistance calculations */

2014-01-13T19:55:48Z

Resistance calculations

← Older revision		Revision as of 19:55, 13 January 2014
Line 94:		Line 94:
	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 100:		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==		==Example motor container==

Frogpipe: /* full-throttle-speed */

2013-10-27T05:53:26Z

full-throttle-speed

← Older revision		Revision as of 05:53, 27 October 2013
Line 83:		Line 83:
	====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'"		Notes: TRS2006-SP0 reports this tag as an error in a "container-type 'motor'"

Fabartus: +{{ORP-top}}+{{ORP-bot}}+{{cont-Engine}}, clarify

2013-09-23T19:56:24Z

+{{ORP-top}}+{{ORP-bot}}+{{cont-Engine}}, clarify

← Older revision		Revision as of 19:56, 23 September 2013
Line 1:		Line 1:
	{{~~TOCright~~}}		{{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 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 ~~33.0~~<big>*</big>		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 [~~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====
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.

	~~==Example motor container==~~

	~~''TBD''~~

	~~[[Category:Config Container]]~~

	==Resistance calculations==		==Resistance calculations==
Line 98:		Line 94:
	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 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}}

Fabartus: /* throttle-notches */ expand, clarify, link to dependent container

2013-09-21T19:13:05Z

throttle-notches: expand, clarify, link to dependent container

← Older revision		Revision as of 19:13, 21 September 2013
Line 53:		Line 53:
	: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) —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)— 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—'''''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)—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====		====axle-count====

Fabartus: /* full-throttle-speed */ note error in TRS2006

2013-07-08T11:40:48Z

full-throttle-speed: note error in TRS2006

← Older revision		Revision as of 11:40, 8 July 2013
Line 75:		Line 75:
	====full-throttle-speed====		====full-throttle-speed====
	:Type: Decimal		:Type: Decimal
	:Desc:		:Desc:
			Notes: TRS2006-SP0 reports this tag as an error in a "container-type 'motor'"

	====driving-wheel-weight-ratio====		====driving-wheel-weight-ratio====

Tram: /* brakeratio */

2013-07-05T20:22:17Z

brakeratio

← Older revision		Revision as of 20:22, 5 July 2013
Line 43:		Line 43:
	====brakeratio====		====brakeratio====
	:Type: Decimal		:Type: Decimal
	:Desc:		:Desc: Coefficient between the pressure in brake cylinder and the brake force.

	====max-accel====		====max-accel====