Engine

Diesel F7

Diesel SD40-2

Steam PB15

File location: ...\Trainz\Engines\

Engines
custom_engine
Config.TXT

Locomotive performance parameters ...

Referenced by the enginespec tag in a traincar config.TXT file.

Config.TXT File Example for an Engine -- Diesel
kuid <KUID:-1:42004202>
kind engine
username "F7 Undec"
region No.Amer.
category-class AL
category-region-0 NA
category-era-0 1950s
rem F7 Generic Engine
flowsize 
{
   trainbrakepipe 170000
   epreservoirpipe 0.1
   no3pipe 0.1
   no4pipe 0.1
   auxreservoirvent 0.1
   auxreservoir_no3 0.1
   auxreservoir_trainbrakepipe 0.1
   autobrakecylindervent 0.1
   auxreservoir_autobrakecylinder 0.1
   equaliser_mainreservoir 0.06
   equaliservent 0.06
   equaliserventhandleoff 0.1
   equaliserventemergency 0.1
   no3pipevent 1.5
   no3pipe_mainreservoir 0.1
   compressor 10
   trainbrakepipe_reservoir 1
   trainbrakepipevent 0.06
   no3pipe_autobrakecylinder 0.1
   epreservoirpipe_autobrakecylinder 0.1
   mainreservoir_ep 0.1
   vacuumbrakepipe 0.1
   vacuumbrakepipereleasevent 0.1
   vacuumbrakepipevent 0.1
   vacuumbrakereservoir_vacuumbrakepipe 0.1
   vacuumbrakecylinder_vacuumbrakepipe 0.1
   highspeedexhauster_vacuumbrakepipe 0.1
}
volume 
{
   scale 1
   trainbrakepipe 0.2
   epreservoirpipe 0.2
   no3pipe 0.2
   no4pipe 0.2
   auxreservoir 0.0384678
   autobrakecylinder 0.00969387
   vacuumbrakepipe 0
   vacuumbrakereservoir 0
   vacuumbrakecylinder 0
   mainreservoir 0.9
   equaliser 0.5
   independantbrakecylinder 0.0103239
}
pressure
{
   scale 1
   compressor 0.00946941
   mainreservoir 0.00946941
   highspeedexhauster 0
   brakepipe 0.00665741
   brakeinitial 0.00609501
   brakefull 0.00504051
   indbrakefull 0.00504051
   trainbrakepipe_start 0.00504051
   epreservoirpipe_start 0
   no3pipe_start 0
   no4pipe_start 0
   auxreservoir_start 0.00504051
   autobrakecylinder_start 0.00507566
   vacuumbrakepipe_start 0
   vacuumbrakereservoir_start 0
   vacuumbrakecylinder_start 0
   mainreservoir_start 0.00806341
   equaliser_start 0.00504051
   independantbrakecylinder_start 0.00507566
}
mass 
{
   scale 1
   fuel 6.2156e+ 006
}
motor 
{
   resistance 1.7
   adhesion 2.5
   maxvoltage 600
   maxspeed 40
   brakeratio 55000
      max-accel 3500
      max-decel 9000
   axle-count 4
   surface-area 80
   moving-friction-coefficient .03
   air-drag-coefficient .00017
}
throttle-power
0
{
0 0
}
1
{
0 30
5 25
10 15
12 0
}
2
{
0 55
5 48
10 40
15 30
30 10
}
3
{
0 100
5 70
10 55
15 50
30 10
}
4
{
2 150
5 80
10 60
15 55
30 10
}
5
{
0 200
5 150
10 80
15 65
30 10
}
6
{
0 231
5 180
10 120
15 90
30 20
}
7
{
0 260
5 220
10 200
15 110
30 20
}
8
{
0 300
3.5 250
5 190
10 160
20 120
30 110
35 140
44 20
}
}
dynamic-brake
{
0
{
0 0
}
1
{
1.333 0
2 30
5 25
10 15
12 0
}
2
{
1.333 0
3 50
10 35
14 20
15 0
}
3
{
1.333 0
3 60
10 40
17 20
22 0
}
4
{
1.333 0
4 80
10 60
20 20
25 0
}
5
{
1.333 0
5 90
10 70
25 25
29 0
}
6
{
1.333 0
5 150
10 80
29 70
32 0
}
7
{
1.333 0
5 200
10 100
32 60
36 0
}
8
{
1.333 0
5 200
10 150
36 50
40 0
}
}
kuid-table
{
   0 <KUID:###:#####>
   1 <KUID:###:#####>
}
obsolete-table
{
}
description "GM/EMD F7 "
trainz-build 1.5

 

Config.TXT File Example for an Engine -- Diesel
kuid <KUID:-1:42004221>
kind engine
rem SD40-2
trainz-build 2.0
flowsize
{
   trainbrakepipe 170000
   epreservoirpipe 0.1
   no3pipe 0.1
   no4pipe 0.1
   auxreservoirvent 0.1
   auxreservoir_no3 0.1
   auxreservoir_trainbrakepipe 0.1
   autobrakecylindervent 0.1
   auxreservoir_autobrakecylinder 0.1
   equaliser_mainreservoir 0.06
   equaliservent 0.06
   equaliserventhandleoff 0.1
   equaliserventemergency 0.1
   no3pipevent 1.5
   no3pipe_mainreservoir 0.1
   compressor 10
   trainbrakepipe_reservoir 1
   trainbrakepipevent 0.06
   no3pipe_autobrakecylinder 0.1
   epreservoirpipe_autobrakecylinder 0.1
   mainreservoir_ep 0.1
   vacuumbrakepipe 0.1
   vacuumbrakepipereleasevent 0.1
   vacuumbrakepipevent 0.1
   vacuumbrakereservoir_vacuumbrakepipe 0.1
   vacuumbrakecylinder_vacuumbrakepipe 0.1
   highspeedexhauster_vacuumbrakepipe 0.1
}
volume
{
   scale 1
   trainbrakepipe 0.2
   epreservoirpipe 0.2
   no3pipe 0.2
   no4pipe 0.2
   auxreservoir 0.0384678
   autobrakecylinder 0.00969387
   vacuumbrakepipe 0
   vacuumbrakereservoir 0
   vacuumbrakecylinder 0
   mainreservoir 0.9
   equaliser 0.5
   independantbrakecylinder 0.0103239
}
pressure
{
   scale 1
   compressor 0.00946941
   mainreservoir 0.00946941
   highspeedexhauster 0
   brakepipe 0.00736041
   brakeinitial 0.00693861
   brakefull 0.0044992
   indbrakefull 0.005075
   trainbrakepipe_start 0.00553261
   epreservoirpipe_start 0
   no3pipe_start 0
   no4pipe_start 0
   auxreservoir_start 0.00553261
   autobrakecylinder_start 0.00560291
   vacuumbrakepipe_start 0
   vacuumbrakereservoir_start 0
   vacuumbrakecylinder_start 0
   mainreservoir_start 0.00946941
   equaliser_start 0.00553261
   independantbrakecylinder_start 0.00560291
}
mass
{
   scale 1
   fuel 6.2156e+006
}
motor
{
   resistance 1.7
   adhesion 7
   maxvoltage 600
   maxspeed 40
   brakeratio 55000
   max-accel 3500
   max-decel 9000
   axle-count 6
   surface-area 80
   moving-friction-coefficient .03
   air-drag-coefficient .00017
}
throttle-power
{
0
{
0 0
}
1
{
0 107
2.2 62
4.4 34
6.6 31
8.8 25
13.3 18
22.2 11
}
2
{
0 224
2.2 125
4.4 68
6.6 62
8.8 50
13.3 36
22.2 22
}
3
{
0 373
2.2 187
4.4 125
6.6 93
8.8 75
13.3 53
}
4
{
0 448
2.2 249
4.4 166
6.6 125
8.8 100
13.3 71
22.2 45
}
5
{
0 618
2.2 309
4.4 206
6.6 154
8.8 123
13.3 88
22.2 56
35.5 36
}
6
{
0 747
2.2 374
4.4 249
6.6 187
8.8 149
13.3 107
22.2 68
35.5 44
}
7
{
0 872
2.2 436
4.4 291
6.6 218
8.8 174
13.3 124
22.2 79
35.5 51
44.4 42
}
8
{
0 996
2.2 498
4.4 332
6.6 249
8.8 199
13.3 142
22.2 90
35.5 58
44.4 48
}
}
dynamic-brake
{
0
{
0 0
}
1
{
1.333 0
2 30
5 25
10 15
12 0
}
2
{
1.333 0
3 50
10 35
14 20
15 0
}
3
{
1.333 0
3 60
10 40
17 20
22 0
}
4
{
1.333 0
4 80
10 60
20 20
25 0
}
5
{
1.333 0
5 190
10 70
25 25
29 0
}
6
{
1.333 0
5 250
10 80
29 70
32 0
}
7
{
1.333 0
5 250
10 100
32 60
36 0
}
8
{
1.33 0
5 250
10 100
36 50
40 0
{
}

TAGS - DIESEL DESCRIPTIONS
kind asset type
rem comment used to display engine name
flowsize rate of flow through pipes (generally use the above settings in the engine config.TXT file example)
trainbrakepipe
epreservoirpipe
no3pipe
no4pipe
auxreservoirvent
auxreservoir_no3
auxreservoir_trainbrakepipe 
autobrakecylindervent
auxreservoir_autobrakecylinder
equaliser_mainreservoir
equaliservent
equaliserventhandleoff
equaliserventemergency
no3pipevent
no3pipe_mainreservoir
compressor
trainbrakepipe_reservoir
trainbrakepipevent
no3pipe_autobrakecylinder
epreservoirpipe_autobrakecylinder
mainreservoir_ep
vacuumbrakepipe
vacuumbrakepipereleasevent
vacuumbrakepipevent
vacuumbrakereservoir_vacuumbrakepipe
vacuumbrakecylinder_vacuumbrakepipe
highspeedexhauster_vacuumbrakepipe
volume size of pipes and appliances

scale 

1

 multiplies volume by given value, generally leave this setting.
trainbrakepipe brake pipe volume
epreservoirpipe For electro pneumatic braking -not currently in use, generally leave this setting
no3pipe Independent brake pipe
no4pipe Bail pipe - not currently in use, generally leave this setting
auxreservoir Auxiliary reservoir volume
autobrakecylinder Brake cylinder volume
vacuumbrakepipe For vacuum braking -not currently in use, generally leave this setting
vacuumbrakereservoir For vacuum braking -not currently in use, generally leave this setting
vacuumbrakecylinder For vacuum braking -not currently in use, generally leave this setting
mainreservoir Main reservoir volume
equaliser Equalizing reservoir volume
independantbrakecylinder Loco brake cylinder volume
pressure brake system pressures

scale 

 1 multiplies pressure by given value, generally leave this setting
compressor compressor maximum pressure (120psi expressed in grams/m³)
mainreservoir main reservoir maximum pressure
highspeedexhauster For vacuum braking -not currently in use, generally leave this setting
brakepipe brake pipe pressure when fully charged (80psi expressed in grams/m³)
brakeinitial brake pipe pressure after initial service reduction (for self lapping brakes) (72psi expressed in grams/m³)
brakefull Brake pipe pressure after full service reduction (for self lapping brakes) (57psi expressed in grams/m³)
indbrakefull Brake cylinder pressure for independent brake service
trainbrakepipe_start Brake pipe pressure on loading the game
epreservoirpipe_ start For electro pneumatic braking - not currently in use, generally leave this setting
no3pipe_start For electro pneumatic braking - not currently in use, generally leave this setting
no4pipe_start For electro pneumatic braking - not currently in use, generally leave this setting
auxreservoir_start Auxiliary reservoir pressure on loading the game
autobrakecylinder_start Train brake cylinder pressure on loading the game
vacuumbrakepipe_start For vacuum braking - not currently in use, generally leave this setting
vacuumbrakereservoir_start For vacuum braking - not currently in use, generally leave this setting
vacuumbrakecylinder_start For vacuum braking - not currently in use, generally leave this setting
mainreservoir_start Main Reservoir pressure on loading the game (100psi expressed in grams/m³)
equaliser_start Equalizing Reservoir pressure on loading the game
independantbrakecylinder_start Locomotive brake cylinder pressure on loading the game
mass  

scale 

 1 multiplies fuel mass by given value, not currently in use, generally leave this setting
fuel fuel level, not currently in use, generally leave this setting
motor
resistance power figure for DCC, higher resistance value= less power
adhesion adhesion parameter, higher value=greater adhesion
maxvoltage generally leave this setting
maxspeed maximum speed for DCC, expressed in meters per second
brakeratio brake force for pressure reduction
     max-accel parameters for DCC acceleration & deceleration
     max-decel parameters for DCC acceleration & deceleration
axle-count Resistance -- axle count
surface-area Resistance -- surface area
moving-friction-coefficient Resistance -- moving friction
air-drag-coefficient Resistance -- air drag
throttle-power Acceleration variables in cabin mode

1 {

 = notch number (1)

0

 30
5 25 = at speed 5 acceleration = 25
10 15
12 0

}
dynamic-brake Deceleration variables while dynamic braking in cabin mode

1 {

 = notch number (1)

1.333

 0
2 30
5 25 = at speed 5 acceleration = 25
10 15
12 0

}

Equalization of Pressures

There is a point at which no further brake pipe pressure reduction will result in increased braking effort, this is known as full application or equalization of pressures.

Imagine you made a 26psi reduction when operating a loco with a 90psi brake pipe. 90psi in the train pipe minus 26psi reduction equals 64psi in the pipe. Due to the 2.5: ratio of auxiliary reservoir volume to brake cylinder volume, the 26psi reduction puts 64psi into the brake cylinder.

As the pressure in the reservoir and the pressure in the cylinder is now equal, no more air will flow into the brake cylinder; and making a further reduction in brake pipe pressure will have no effect on braking.

Equalization occurs at different pressures, depending on the train pipe feed pressure.

100psi pipe (e.g. the UK locos -7 bar) equalization at 71psi.
90psi pipe (e.g. the US locos) equalization at 64psi.
72psi pipe (e.g. French & Queensland locos) equalization at 49psi.

The easiest way to set your custom content to the desired brake pipe feed pressure is to copy the entire pressure section from the config.TXT file of a loco that uses the pressure you desire.

Note: Converting PSI to Grams/m cubed

e.g. 90psi ... (90+14.7).0000703
                    104.7 x .0000703=.00736041

 

Config.TXT File Example for an Engine -- Steam
kuid <KUID:44179:51002>
kind steam-engine
rem PB15
trainz-build 2.0
epbrakes 1
flowsize
{
   trainbrakepipe 170000
   areservoirpipe 0.1
   no3pipe 0.1
   no4pipe 0.1
   auxreservoirvent 0.1
   auxreservoir_no3 0.1
   auxreservoir_trainbrakepipe 0.1
   autobrakecylindervent 0.1
   auxreservoir_autobrakecylinder 0.1
   equaliser_mainreservoir 0.06
   equaliservent 0.06
   equaliserventhandleoff 0.1
   equaliserventemergency 0.1
   no3pipevent 1.5
   no3pipe_mainreservoir 0.1
   compressor 5
   trainbrakepipe_reservoir 1
   trainbrakepipevent 0.06
   no3pipe_autobrakecylinder 0.1
   epreservoirpipe_autobrakecylinder 0.1
   mainreservoir_ep 0.1
   vacuumbrakepipe 0.1
   vacuumbrakepipereleasevent 0.1
   vacuumbrakepipevent 0.1
   vacuumbrakereservoir_vacuumbrakepipe 0.1
   vacuumbrakecylinder_vacuumbrakepipe 0.1
   highspeedexhauster_vacuumbrakepipe 0.1
}
volume
{
   scale 1
   trainbrakepipe 0.2
   epreservoirpipe 0.2
   no3pipe 0.2
   no4pipe 0.2
   auxreservoir 0.0384678
   autobrakecylinder 0.00969387
   vacuumbrakepipe 0
   vacuumbrakereservoir 0
   vacuumbrakecylinder 0
   mainreservoir 1.0
   equaliser 0.5
   independantbrakecylinder 0.0103239
}
pressure
{
   scale 1
   compressor 0.00946941
   mainreservoir 0.00946941
   highspeedexhauster 0
   brakepipe 0.00595441
   brakeinitial 0.00560291
   brakefull 0.00398601
   indbrakefull 0.00398601
   trainbrakepipe_start 0.00440781
   epreservoirpipe_start 0
   no3pipe_start 0
   no4pipe_start 0
   auxreservoir_start 0.00504051
   autobrakecylinder_start 0.00489991
   vacuumbrakepipe_start 0
   vacuumbrakereservoir_start 0
   vacuumbrakecylinder_start 0
   mainreservoir_start 0.00876641
   equaliser_start 0.00440781
   independantbrakecylinder_start 0.00489991
}
mass
{
   scale 1
   fuel 6.2156e+006
}
motor
{
   resistance 1.3
   adhesion 2.5
   maxvoltage 600
   maxspeed 21
   brakeratio 55000
   max-accel 1500
   max-decel 5000
   throttle-notches 32
   axle-count 4
   surface-area 150
   moving-friction-coefficient 0.01
   air-drag-coefficient 0.0001
}
throttle-power
{
0
{
0 0
}
1
{
0 35
5 28
10 18
12 0
}
2
{
0 85
5 70
10 60
15 30
30 0
}
3
{
0 140
5 93
10 70
15 62
30 0
}
4
{
2 187
5 109
10 93
15 87
30 0
}
5
{
0 281
5 218
10 109
15 87
30 0
}
6
{
0 343
5 265
10 172
15 125
30 0
}
7
{
0 359
5 343
10 187
15 156
30 0
}
8
{
0 436
3.5 429
4.25 425
5 408
10 234
15 172
21 0
}
}
dynamic-brake 
{
0
{
0 0
}
1
{
1.333 0
2 30
5 25
6 15
7 0
}
2
{
1.333 0
2 50
5 35
7 20
8 0
}
3
{
1.333 0
2 60
5 40
7 20
8 0
}
4
{
1.333 0
3 80
7 60
10 20
12 0
}
5
{
1.333 0
5 90
9 70
12 25
15 0
}
6
{
1.333 0
5 150
9 80
13 70
17 0
}
7
{
1.333 0
5 200
10 100
16 60
19 0
}
8
{ 1.33 0
5 200
10 150
18 50
21 0
}
}
steam
{
; presure in kPa
; flow sizes in <?>
; volume in L
; mass in kg
   firebox-volume 1000.0
   firebox-to-boiler-heat-flow 0.055
   firebox-efficiency 0.995
   boiler-volume 3000.0
   water-injector-rate 4.0
   westinghouse-volume 100
   main-reservoir-volume 50.0
   cylinder-volume 50.0
   piston-volume-min 1.48
   piston-volume-max 68.7
   piston-area 0.177
   piston-angular-offset 0.1
   piston-to-atmosphere-flow 0.0021
   safety-valve-low-pressure 956.0
   safety-valve-low-flow 0.011
   safety-valve-high-pressure 1010.0
   safety-valve-high-flow 0.2
   max-fire-coal-mass 50.0
   max-fire-temperature 1873.0
   shovel-coal-mass 2.0
   burn-rate 0.0001
   fuel-energy 100.0
   boiler-to-piston-flow 0.0017
}

 

Legend:
Pressure in kPa
Volume in Litres
Mass in kg
Flow sizes (nominal figure)

 

TAGS - STEAM DESCRIPTIONS
steam
firebox-volume physical volume of firebox in litres
firebox-to-boiler-heat-flow rate of heat flow from firebox to boiler and vise-versa
firebox-efficiency atmosphere leakage. 1.0 = no leakage
boiler-volume physical volume of boiler in litres
water-injector-rate water injection rate into boiler in litres/second
westinghouse-volume westinghouse volume in litres
piston-volume-min the volume of the space in the cylinder ahead of the piston at the end of a full stroke
piston-volume-max the volume of the space in the cylinder ahead of the piston at the start of a full stroke
piston-area  the cross section of one piston in m2. It is assumed there is one piston only on each side of the locomotive
piston-angular-offset leave this setting
piston-to-atmosphere-flow atmospheric leakage from piston -- nominal hole size
safety-valve-low-pressure when boiler pressure hits this value in kPa the safety-valve-low-flow release is initiated. (below)
safety-valve-low-flow lower pressure valve release -- nominal hole size
safety-valve-high-pressure when boiler pressure hits this value in kPa the safety-valve-high-flow release is initiated (below)
max-fire-coal-mass the maximum mass of coal the firebox can take in kilograms
max-fire-temperature maximum heat obtainable in degrees K
(Kelvin scale temperature)
shovel-coal-mass amount of coal in one shovel load in kg
burn-rate coal consumption rate
fuel-energy relative energy in kilojoules per kilogram of coal
boiler-to-piston-flow relative energy

Content Creation Guide Table of Content

 Paint Shed Guide