CCG/Engine
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:
See Chapter 7 for an example asset of this kind.
A TYPICAL ASSET OF THIS KIND MAY HAVE THE FOLLOWING TAGS:
engine kuid kuid trainz-build data category-class data category-region data category-era data username data kind 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.
