CCG/Steam-Engine

From TrainzOnline
< CCG
Jump to: navigation, search

Contents

KIND: STEAM-ENGINE

Description

The special engine specification for steam locomotives which defines the detailed performance requirements such as throttle requirements, engine and braking performance, boiler capacity and steam attributes.


Container Structure

A well formed steam-engine kind has the following container structure:

CCG steam 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                                                 "steam-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
axle-count                                           data
surface-area                                         data
moving-friction-coefficient                          data
air-drag-coefficient                                 data
throttle-notches                                     data
  
steam
firebox-to-boiler-heat-flow                          data
firebox-efficiency                                   data
boiler-volume                                        data
minimum-volume                                       data
maximum-volume                                       data
initial-boiler-temperature                           data
water-injector-rate                                  data
piston-volume-min                                    data
piston-volume-max                                    data
piston-area                                          data
piston-angular-offsets                               data
firebox-to-boiler-heat-flow-idle                     data
burn-rate-idle                                       data
boiler-to-piston-flow                                data
piston-to-atmosphere-flow                            data
safety-valve-low-pressure                            data
safety-valve-low-flow                                data
safety-valve-high-pressure                           data
safety-valve-high-flow                               data
max-fire-coal-mass                                   data
max-fire-temperature                                 data
shovel-coal-mass                                     data
burn-rate                                            data
fuel-energy                                          data
firebox-volume                                       data
main-reservoir-volume                                data
westinghouse-volume                                  data
  
thumbnails
0
image                                                file
width                                                data
height                                               data


TAGS AND CONTAINERS

The following tags are further defined in Chapter 5:

kuid
Generated automatically by Content Manager.
trainz-build
Automatically set to 2.9 for 2009 assets.
category-class
Should be one of the following: "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" and "Content Creator Plus" programs.
kind
Must be "steam-engine".


Additional Containers

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


Steam Container

The Steam Container stores specialised variables related to steam engines.

The Steam Containers has the following tags:

boiler-to-piston-flow
Relative energy.
boiler-volume
Physical volume of boiler in litres.
burn-rate
Coal consumption rate.
burn-rate-idle
Coal consumption rate when idle.
firebox-efficiency
Atmosphere leakage. 1.0 = No leakage.
firebox-to-boiler-heat-flow
Rate of heat flow from firebox to boiler and viseversa.
firebox-to-boiler-heat-flow-idle
Rate of heat flow from firebox to boiler when idle.
firebox-volume
Physical volume of firebox in litres.
fuel-energy
Relative energy in kilojoules per kilogram of coal.
main-reservoir-volume
Main reservoir volume in litres.
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).
piston-angular-offsets
Leave this setting.
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 end 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-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.
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-low-flow release is initiated.
safety-valve-high-flow
Higher pressure valve release. Nominal hole size.
shovel-coal-mass
Amount of coal in one shovel load in kg.
water-injector-rate
Water injection rate into boiler in litres/second.
westinghouse-volume
Westinghouse volume in litres.
initial-boiler-temperature
Boiler temperature on loading Trainz.
max-coal-mass
Maximum volume of coal.
minimum-volume
The 'minimum' volume of the boiler (in millilitres). It's important to note that this is not literally 'empty', but rather the value at which the water gauge will read empty. By default this is 80% of the boiler volume.
maximum-volume
The 'maximum' volume of the boiler (in millilitres). It's important to note that this is not literally 'full', but rather the value at which the water gauge will read full. By default this is 90% of the boiler volume.

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.
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 pipe 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.

Steam-Power Coordinate Container

This container is a graph, similar to the throttle anddynamic-brake graphs for Velocity incoming, Power multiplier outgoing.

Coordinate Element
The steam-power graph provides a speed (m/s) vs power (multiplier) modifier which controls the power output ofthe pistons on a steam train. This is intended to allow fine adjustments to a working steam engine, and should not be used for large adjustments to the performance characteristics, eg.
0       1.0
 
20      1.1


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, ObsoleteTable, Thumbnails, Privileges, Extensions, Throttle Power Container, Dynamic Brake Container, Pressure Container, Mass Container, Motor Container, Flowsize Container, Volume Container, Steam container, Steam-Power.
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