CCG/Engine

From TrainzOnline
< CCG
Jump to: navigation, search

Contents

KIND: ENGINE

Description

An engine specification for locomotives and rolling-stock which defines the detailed performance requirements; including throttle requirements and engine and braking performance.

Container Structure

A well formed engine kind has the following container structure:

CCG engine dir.jpg

See Chapter 7 for an example asset of this kind.

A TYPICAL ASSET OF THIS KIND MAY HAVE THE FOLLOWING TAGS:

kind                                   "engine"
kuid                                   kuid
trainz-build                           data
category-class                         data
category-region                        data
category-era                           data
username                               data
  
flowsize
trainbrakepipe                         data
epreservoirpipe                        data
no3pipe                                data
no4pipe                                data
auxreservoirvent                       data
auxreservoir_no3                       data
auxreservoir_trainbrakepipe            data
autobrakecylindervent                  data
auxreservoir_autobrakecylinder         data
equaliser_mainreservoir                data
equaliservent                          data
equaliserventhandleoff                 data
equaliserventemergency                 data
no3pipevent                            data
no3pipe_mainreservoir                  data
compressor                             data
trainbrakepipe_reservoir               data
trainbrakepipevent                     data
no3pipe_autobrakecylinder              data
epreservoirpipe_autobrakecylinder      data
mainreservoir_ep                       data
vacuumbrakepipe                        data
vacuumbrakepipereleasevent             data
vacuumbrakepipevent                    data
vacuumbrakereservoir_vacuumbrakepipe   data
vacuumbrakecylinder_vacuumbrakepipe    data
highspeedexhauster_vacuumbrakepipe     data
  
volume
scale                                  data
trainbrakepipe                         data
epreservoirpipe                        data
no3pipe                                data
no4pipe                                data
auxreservoir                           data
autobrakecylinder                      data
vacuumbrakepipe                        data
vacuumbrakereservoir                   data
vacuumbrakecylinder                    data
mainreservoir                          data
equaliser                              data
independantbrakecylinder               data
  
pressure
scale                                  data
compressor                             data
mainreservoir                          data
highspeedexhauster                     data
brakepipe                              data
brakeinitial                           data
brakefull                              data
indbrakefull                           data
trainbrakepipe_start                   data
epreservoirpipe_start                  data
no3pipe_start                          data
no4pipe_start                          data
auxreservoir_start                     data
autobrakecylinder_start                data
vacuumbrakepipe_start                  data
vacuumbrakereservoir_start             data
vacuumbrakecylinder_start              data
mainreservoir_start                    data
equaliser_start                        data
independantbrakecylinder_start         data
   
mass
scale                                  data
fuel                                   data
  
motor
resistance                             data
adhesion                               data
maxvoltage                             data
maxspeed                               data
brakeratio                             data
max-accel                              data
max-decel                              data
throttle-notches                       data
axle-count                             data
surface-area                           data
moving-friction-coefficient            data
air-drag-coefficient                   data
   
throttle-power
  
*See Chapter 7 Examples for various Throttle-Power values.
  
dynamic-brake
  
*See Chapter 7 Examples for various Dynamic Brake values.
  
thumbnails
0
image                                  file
width                                  data
height                                 data



TAGS AND CONTAINERS

The following tags are further defined in Chapter 5:

kuid
Generated automatically by CCP.
trainz-build
Automatically set to 2.9 for 2009 assets.
category-class
Should be one of the following:
"AA" - Electric Multi-current, "AC" - AC Electric, "AD" - DC Electric, "AE" - Experimental or Special, "AG" - Gas Turbine, "AH" - Diesel Hydraulic, "AL" - Diesel & Diesel Electric, "AM" - Mammal, "AS" - Steam Loco & Tender, “AT" - Steam Tank.
See the "Motive Power" section of Category Class.
category-region
See Category Region for a list of valid category-region values.
category-era
See Category Era for a list of valid category-era values.
username
Asset username. Though this asset doesn't appear in the Surveyor menu, the username is used to identify the asset in the "Content Manager Plus" and "Content Creator Plus" programs.
kind
Must be "engine".


Additional Containers

As well as containing all of the common tags and containers detailed in Chapter 5 , the engine kind also contains additional containers and tags that are specialised to the requirements of the kind.


Throttle-Power Container

Contains acceleration variables as used in cabin mode,

eg.

1
0       30
5       25 = At speed 5, acceleration = 25
10      15
12      0

See Chapter 7 for example Throttle-Power values.


Dynamic Brake Container

Contains deceleration variables for dynamic braking in cabin mode,

eg.

1
1.333   0
2       30
5       25 = At speed 5, deceleration = 25
10      15
12      0

See Chapter 7 for example Dynamic Brake values.


Pressure Container

Stores brake system pressures.

The Pressure Container has the following tags:

scale
Multiplies pressure by given value, generally leave this setting.
compressor
(120psi expressed in grams/m³) Compressor maximum pressure.
mainreservoir
Main reservoir maximum pressure
highspeedexhauster
For vacuum braking - not currently in use, generally leave this setting.
brakepipe
(80psi expressed in grams/m³) Brake pipe pressure when fully charged.
brakeinitial
(72psi expressed in grams/m³) Brake pipe pressure after initial service reduction (for self lapping brakes).
brakefull
(57psi expressed in grams/m³) Brake pipe pressure after full service reduction (for self lapping brakes).
indbrakefull
Brake cylinder pressure for independant brake service.
trainbrakepipe_start
Brake pipe pressure on loading Trainz.
epreservoirpipe_start
For electro pneumatic braking - not currently in use, generally leave this setting.
no3pipe_start
Generally leave these settings.
no4pipe_start
Generally leave these settings.
auxreservoir_start
Auxiliary reservoir pressure on loading Trainz.
autobrakecylinder_start
Train brake cylinder pressure on loading Trainz.
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
(100psi expressed in grams/m³) Main Reservoir pressure on loading Trainz.
equaliser_start
Equalising Reservoir pressure on loading Trainz.
independantbrakecylinder_start
Locomotive brake cylinder pressure on loading Trainz.


Mass Container

The mass container stores information related to fuel consumption. These tags aren't in use and shouldn't generally be used.

The mass container has the following tags:

scale
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 Container

The Motor Container stores an assortment of values related to motor function, particularly that of DCC.

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 metres per second.
brakeratio
Brake force for pressure reduction.
max-accel
Parameters for DCC acceleration & deceleration.
max-decel
Parameters for DCC acceleration & deceleration.
throttle-notches
Number of throttle notches.
axle-count
Resistance - Axle Count.
surface-area
Resistance - Surface Area.
moving-friction-coefficient
Resistance - Moving friction.
air-drag-coefficient
Resistance - Air drag.


Flowsize Container

Flowsize settings specify the rate of flow through the pipes. Generally these setting should be left unaltered.

The Flowsize Container has the following tags:

trainbrakepipe
Flowsize of the brake pipe.
epreservoirpipe
Flowsize of the electric pneumatic braking
no3pipe
Flowsize of the independent brake pipe.
no4pipe
Flowsize of the bail pipe.
auxreservoirvent
Flowsize of the auxiliary reservoir vent.
auxreservoir_no3
Flowsize of the auxiliary independent brake pipe.
auxreservoir_trainbrakepipe
Flowsize of the auxiliary reservoir brake pipe.
autobrakecylindervent
Flowsize of the automatic brake cylinder vent.
auxreservoir_autobrakecylinder
Flowsize of the auxiliary reservoir automatic brake cylinder.
equaliser_mainreservoir
Flowsize of the equaliser main reservoir.
equaliservent
Flowsize of the equaliser vent.
equaliserventhandleoff
Flowsize of the equaliser to the atmosphere when in the "handle off" position.
equaliserventemergency
Flowsize of the emergency equaliser vent.
no3pipevent
Flowsize of the independent brake pipe.
no3pipe_mainreservoir
Flowsize of the independent brake main reservoir.
compressor
Flowsize of the compressor.
trainbrakepipe_reservoir
Flowsize of the brake pipe reservoir.
trainbrakepipevent
Flowsize of the brake pipe vent.
no3pipe_autobrakecylinder
Flowsize of the independent automatic brake pipe cylinder.
epreservoirpipe-autobrakecylinder
Flowsize of the electro pneumatic automatic brake cylinder reservoir.
mainreservoir_ep
Flowsize of the electro pneumatic main reservoir.
vacuumbrakepipe
Flowsize of the vacuum brake pipe.
vacuumbrakepipereleasevent
Flowsize of the vacuum brake pipe release vent.
vacuumbrakepipevent
Flowsize of the vacuum brake vent.
vacuumbrakereservoir_vacuumbrakepipe
Flowsize of the vacuum brake pipe reservoir.
vacuumbrakecylinder_vacuumbrakepipe
Flowsize of the vacuum brake pipe cylinder.
highspeedexhauster_vacuumbrakepipe
Flowsize of the high speed exhauser vacuum brake pipe.


Volume Container

The volume container stores information regarding the size of pipes and appliances. Generally these settings should remain unaltered.

The Volume Container has the following tags:

scale
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
Equalising reservoir volume.
independantbrakecylinder
Loco brake cylinder volume.


Notes

Equalisation 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 equalisation of pressures.

Imagine you made a 26 psi reduction when operating a loco with a 90psi brake pipe. 90psi in the train pipe minus 26psi reduction equals 64 psi in the pipe. Due to the 2.5:1 ratio of auxiliary reservoir volume to brake cylinder volume, the 26 psi reduction puts 64 psi 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.

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

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

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 of a loco that uses the pressure you desire.

Note: Converting PSI to grams /m cubed...

e.g. 90Psi... (90+14.7)0.0000703  (add atmospheric pressure 14.7psi to get absolute pressure)
              = 104.7 x 0.0000703
              = 0.00736041

THIS KIND SUPPORTS THE FOLLOWING:

CONTAINERS
String Table, Chinese String Table, Czech String Table, Dutch String Table, French String Table, German String Table, Italian String Table, Polish String Table, Russian String Table, Spanish String Table, KUID Table, Obsolete Table, Thumbnails, Privileges, Extensions, Throttle Power Container, Dynamic Brake Container, Pressure Container, Mass Container, Motor Container, Flowsize Container, Volume Container.
TAGS
kuid, trainz-build, category-class, category-region, category-era, username, kind, author, category-keyword, class, contact-email, contact-website, description, description-cn, description-cz, description-de, description-es, description-fr, description-it, description-pl, description-nl, description-ru, license, organisation, username-cn, username-cz, username-de, username-es, username-fr, username-it, username-nl, username-pl, username-ru.


Return to CCG Index

Content Creator's Guide

Personal tools