"Steam" container
From TrainzOnline
(Difference between revisions)
m (Steam container moved to "Steam" container) |
|||
(4 intermediate revisions by 3 users not shown) | |||
Line 21: | Line 21: | ||
min-fire-temperature 500 | min-fire-temperature 500 | ||
max-fire-temperature 1300 | max-fire-temperature 1300 | ||
− | minimum-volume | + | minimum-volume 8000 |
− | maximum-volume | + | maximum-volume 9000 |
− | fusible-plug-volume | + | fusible-plug-volume 7500 |
boiler-heat-loss 2.0 | boiler-heat-loss 2.0 | ||
piston-angular-offsets 0.0174,1.5254,3.0333,4.5413 | piston-angular-offsets 0.0174,1.5254,3.0333,4.5413 | ||
Line 59: | Line 59: | ||
====boiler-volume==== | ====boiler-volume==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Volume in | + | :Desc: Volume of the boiler, in cubic metres. |
+ | |||
+ | <span style="color: red">Note that in earlier versions of Trainz (pre TC3, trainz-build <2.8) this value was in litres, and newer versions of Trainz will multiply the value when it's read in from the config file.</span> | ||
====burn-rate==== | ====burn-rate==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: The tested/'normal' rate at which the firebox burns coal, in kg/s (before being scaled down by drafting rate). |
====burn-rate-idle==== | ====burn-rate-idle==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: The rate at which the firebox constantly/idly burns coal, in kg/s (before being scaled down by drafting rate). |
====firebox-heating-surface-area==== | ====firebox-heating-surface-area==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Total surface area for heat transfer from the firebox to the boiler, in square metres. Larger areas result in more heat transfer, both cooling the fire and heating the water. |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
====firebox-thermal-conductivity==== | ====firebox-thermal-conductivity==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Technically watts per metre kelvin, but real numbers are no good here - many factors mean a steam loco is far from an ideal heat conductor | + | :Desc: Technically watts per metre kelvin, but real numbers are no good here - many factors mean a steam loco is far from an ideal heat conductor than what the equations are based around. Defaults to 10. A higher number here will mean more heat transfer from the fire to the boiler - resulting in higher pressure but less fire temperature. Lower numbers will result in more fire temperature, but less heating. |
====firebox-plate-thickness==== | ====firebox-plate-thickness==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Thickness of firebox plate in metres. | + | :Desc: Thickness of firebox plate in metres. Defaults to 0.016, which is equivalent to 5/8". |
+ | |||
+ | ====fuel-specific-heat-capacity==== | ||
+ | :Type: Decimal | ||
+ | :Desc: Joules per kilogram kelvin. Amount of energy (joules) needed to raise the temperature of 1 kg of the fuel substance by one degree kelvin. | ||
====fuel-energy==== | ====fuel-energy==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Joules per kilogram. Amount of energy (joules) that | + | :Desc: Joules per kilogram. Amount of energy (joules) that is released by burning 1 kg of the fuel. |
− | ==== | + | ====firebox-efficiency==== |
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Firebox efficiency scalar, from 0.0 to 1.0. This directly scales the energy released from fuel burn, in order to approximate various heat losses from the firebox into the environment. Higher numbers mean more energy from fuel burn, lower numbers mean more energy is lost/wasted. |
====initial-boiler-temperature==== | ====initial-boiler-temperature==== | ||
Line 99: | Line 101: | ||
====max-coal-mass==== | ====max-coal-mass==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Maximum amount (kg) of | + | :Desc: Maximum amount (kg) of fuel it's possible to cram in the firebox, before it starts falling out. |
====ideal-coal-mass==== | ====ideal-coal-mass==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Ideal amount (kg) of | + | :Desc: Ideal amount (kg) of fuel to have in the firebox for optimal burning. This value will appear as "100%" on the interface, and will burn the best. |
====min-fire-temperature==== | ====min-fire-temperature==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Degrees K. A higher value here makes the loco 'wake up' quicker, but too high | + | :Desc: Degrees K. The minimum/idle temperature of the fire. A higher value here makes the loco 'wake up' quicker, but too high and it will build pressure even when left idle. |
====max-fire-temperature==== | ====max-fire-temperature==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Degrees K. | + | :Desc: Degrees K. The maximum temperature the fire is allowed to get to. Lowering this will have the effect of limiting both top end boiler pressure and maximum water heating ability. |
====minimum-volume==== | ====minimum-volume==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Litres. The amount of water in the boiler that corresponds to the bottom of the sight glass - 0% on the interface. Defaults to 80% boiler-volume. |
====maximum-volume==== | ====maximum-volume==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Litres. The amount of water in the boiler that corresponds to the top of the sight glass - 100% on the interface. It should be above the 'minimum volume'. Defaults to 90% boiler-volume. |
====fusible-plug-volume==== | ====fusible-plug-volume==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Litres. The amount of water in the boiler at which point the fusible plugs will kick in. It should be below the 'minimum volume'. Defaults to 75% boiler-volume. |
====boiler-heat-loss==== | ====boiler-heat-loss==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Rate at which heat is radiated away from the boiler into the environment. Bigger numbers mean more cooling and lower boiler efficiency. Defaults to 2. |
====piston-angular-offsets==== | ====piston-angular-offsets==== | ||
Line 135: | Line 137: | ||
====piston-volume-min==== | ====piston-volume-min==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Volume inside the piston when fully contracted. This value greatly affects the level of front-end power available to a specific loco. |
====piston-volume-max==== | ====piston-volume-max==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Volume inside the piston when fully extended. |
====piston-area==== | ====piston-area==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Surface area of the piston (metres | + | :Desc: Surface area of the piston (square metres). |
====safety-valve-low-pressure==== | ====safety-valve-low-pressure==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Pressure (absolute, and in kPa) at which the low pressure safety valve will | + | :Desc: Pressure (absolute, and in kPa) at which the low pressure safety valve will open. |
====safety-valve-low-flow==== | ====safety-valve-low-flow==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Kilograms per second | + | :Desc: Kilograms per second. Rate at which steam escapes through the low pressure safety valve. Note: Too high a value will result in a 'sawtooth' boiler pressure, and repeated short hisses from the safety valve. |
====safety-valve-high-pressure==== | ====safety-valve-high-pressure==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Pressure (absolute, and in kPa) at which the high pressure safety valve will | + | :Desc: Pressure (absolute, and in kPa) at which the high pressure safety valve will open. |
====safety-valve-high-flow==== | ====safety-valve-high-flow==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Kilograms per second | + | :Desc: Kilograms per second. Rate at which steam escapes through the high pressure safety valve. Remember that both valves will be open at this point. |
====shovel-coal-mass==== | ====shovel-coal-mass==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: The mass of a single "shovel" of coal. This affects manual shovelling (default key- spacebar) and the rate of the automatic fireman (the coal slider in the UI). |
====water-injector-rate==== | ====water-injector-rate==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Maximum flow rate of the first injector when fully open (kg/s). |
====water-injector-rate2==== | ====water-injector-rate2==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Maximum flow rate of the second injector when fully open (kg/s). |
====boiler-efficency-idle==== | ====boiler-efficency-idle==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Ratio (0.0 -> 1.0). | + | :Desc: Ratio (0.0 -> 1.0). The maximum efficiency of the boiler - e.g. when the loco is idle. |
====boiler-efficency==== | ====boiler-efficency==== | ||
Line 183: | Line 185: | ||
====boiler-efficency-min==== | ====boiler-efficency-min==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Absolute minimum boiler efficiency. Calculated efficiency will not fall below this value. |
====speed==== | ====speed==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Speed of test run on which test parameters are based. | + | :Desc: Speed (m/s) of test run on which test parameters are based. |
====cutoff==== | ====cutoff==== | ||
Line 199: | Line 201: | ||
====blower-max-flow==== | ====blower-max-flow==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Moles per second of steam used by blower at max boiler pressure and max setting. |
====starting-coal==== | ====starting-coal==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Mass of coal (in kg) to start with in the firebox. Ideal-coal-mass value will be used if this is not present. |
====starting-water==== | ====starting-water==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Mass of water (in kg) to start with in the boiler. Defaults to 85% boiler-volume. |
====starting-boiler-steam==== | ====starting-boiler-steam==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Mass of steam (in kg) to start with in the boiler. If this is too high, a 'high pressure' will be reported at initial startup (but working the loco will reduce it). If it is too low, the boiler will have to immediately boil water to build pressure, meaning the loco isn't immediately ready on startup. Defaults to 10. |
====steam-chest-volume==== | ====steam-chest-volume==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: Volume | + | :Desc: Volume of the steam chest, in cubic metres. A good estimate if unknown is piston-volume-max * number of cylinders (source 5AT website). |
====steam-chest-max-flow==== | ====steam-chest-max-flow==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Moles per second. Maximum flow rate of steam from the boiler to the steam chest with the regulator fully open. |
====valve-lap-percent==== | ====valve-lap-percent==== | ||
Line 235: | Line 237: | ||
====tractive-effort-constant==== | ====tractive-effort-constant==== | ||
:Type: Decimal | :Type: Decimal | ||
− | :Desc: | + | :Desc: Used to calculate theoretical performance along with cylinder dimensions for the AI to use. Defaults to 0.4 * number_of_cylinders. |
====number-cylinders==== | ====number-cylinders==== | ||
Line 253: | Line 255: | ||
''TBD'' | ''TBD'' | ||
− | [[Category:Config Container]] | + | [[Category:Config Container|S]] |
Latest revision as of 20:55, 23 December 2021
The steam container is a top-level config.txt file entry used by Steam Enginespec assets.
[edit] Supported Tags
The Steam container supports the following tags. Each tag is show here with its default value.
steam { boiler-volume 10.0 burn-rate 0.5 burn-rate-idle 0.01 firebox-heating-surface-area 20 firebox-efficiency 0.75 firebox-thermal-conductivity 10 firebox-plate-thickness 0.016 fuel-energy 27912000 fuel-specific-heat-capacity 1260 initial-boiler-temperature 373 max-coal-mass 1000 ideal-coal-mass 500 min-fire-temperature 500 max-fire-temperature 1300 minimum-volume 8000 maximum-volume 9000 fusible-plug-volume 7500 boiler-heat-loss 2.0 piston-angular-offsets 0.0174,1.5254,3.0333,4.5413 piston-volume-min 0.0272 piston-volume-max 0.1505 piston-area 0.1734 safety-valve-low-pressure 1653 safety-valve-low-flow 0.05 safety-valve-high-pressure 1684 safety-valve-high-flow 0.1 shovel-coal-mass 5.0 water-injector-rate 3.0 water-injector-rate2 3.0 boiler-efficency-idle 0.75 boiler-efficency 0.4 boiler-efficency-min 0.25 speed 15.0 cutoff 0.4 blower-effect 0.5 blower-max-flow 2.5 starting-coal 500 starting-water 7500.0 starting-boiler-steam 10.0 steam-chest-volume 0.1233 steam-chest-max-flow 25.0 valve-lap-percent 0.05 hand-brake-max-force 1000 super-heating-constant 100 tractive-effort-constant 0.8 number-cylinders 2 number-power-strokes 2 legacy-piston-count 4 }
[edit] boiler-volume
- Type: Decimal
- Desc: Volume of the boiler, in cubic metres.
Note that in earlier versions of Trainz (pre TC3, trainz-build <2.8) this value was in litres, and newer versions of Trainz will multiply the value when it's read in from the config file.
[edit] burn-rate
- Type: Decimal
- Desc: The tested/'normal' rate at which the firebox burns coal, in kg/s (before being scaled down by drafting rate).
[edit] burn-rate-idle
- Type: Decimal
- Desc: The rate at which the firebox constantly/idly burns coal, in kg/s (before being scaled down by drafting rate).
[edit] firebox-heating-surface-area
- Type: Decimal
- Desc: Total surface area for heat transfer from the firebox to the boiler, in square metres. Larger areas result in more heat transfer, both cooling the fire and heating the water.
[edit] firebox-thermal-conductivity
- Type: Decimal
- Desc: Technically watts per metre kelvin, but real numbers are no good here - many factors mean a steam loco is far from an ideal heat conductor than what the equations are based around. Defaults to 10. A higher number here will mean more heat transfer from the fire to the boiler - resulting in higher pressure but less fire temperature. Lower numbers will result in more fire temperature, but less heating.
[edit] firebox-plate-thickness
- Type: Decimal
- Desc: Thickness of firebox plate in metres. Defaults to 0.016, which is equivalent to 5/8".
[edit] fuel-specific-heat-capacity
- Type: Decimal
- Desc: Joules per kilogram kelvin. Amount of energy (joules) needed to raise the temperature of 1 kg of the fuel substance by one degree kelvin.
[edit] fuel-energy
- Type: Decimal
- Desc: Joules per kilogram. Amount of energy (joules) that is released by burning 1 kg of the fuel.
[edit] firebox-efficiency
- Type: Decimal
- Desc: Firebox efficiency scalar, from 0.0 to 1.0. This directly scales the energy released from fuel burn, in order to approximate various heat losses from the firebox into the environment. Higher numbers mean more energy from fuel burn, lower numbers mean more energy is lost/wasted.
[edit] initial-boiler-temperature
- Type: Decimal
- Desc: Degrees kelvin. This value will determine whether the engine is 'ready to go' or needs 'warming up' prior to a run when first placed.
[edit] max-coal-mass
- Type: Decimal
- Desc: Maximum amount (kg) of fuel it's possible to cram in the firebox, before it starts falling out.
[edit] ideal-coal-mass
- Type: Decimal
- Desc: Ideal amount (kg) of fuel to have in the firebox for optimal burning. This value will appear as "100%" on the interface, and will burn the best.
[edit] min-fire-temperature
- Type: Decimal
- Desc: Degrees K. The minimum/idle temperature of the fire. A higher value here makes the loco 'wake up' quicker, but too high and it will build pressure even when left idle.
[edit] max-fire-temperature
- Type: Decimal
- Desc: Degrees K. The maximum temperature the fire is allowed to get to. Lowering this will have the effect of limiting both top end boiler pressure and maximum water heating ability.
[edit] minimum-volume
- Type: Decimal
- Desc: Litres. The amount of water in the boiler that corresponds to the bottom of the sight glass - 0% on the interface. Defaults to 80% boiler-volume.
[edit] maximum-volume
- Type: Decimal
- Desc: Litres. The amount of water in the boiler that corresponds to the top of the sight glass - 100% on the interface. It should be above the 'minimum volume'. Defaults to 90% boiler-volume.
[edit] fusible-plug-volume
- Type: Decimal
- Desc: Litres. The amount of water in the boiler at which point the fusible plugs will kick in. It should be below the 'minimum volume'. Defaults to 75% boiler-volume.
[edit] boiler-heat-loss
- Type: Decimal
- Desc: Rate at which heat is radiated away from the boiler into the environment. Bigger numbers mean more cooling and lower boiler efficiency. Defaults to 2.
[edit] piston-angular-offsets
- Type: Decimal Array
- Desc: Values are specified in radians. Amount of wheel rotation required to rotate each piston to maximum travel from starting position. Will depend on how the valve gear has been animated in max. One value per piston.
[edit] piston-volume-min
- Type: Decimal
- Desc: Volume inside the piston when fully contracted. This value greatly affects the level of front-end power available to a specific loco.
[edit] piston-volume-max
- Type: Decimal
- Desc: Volume inside the piston when fully extended.
[edit] piston-area
- Type: Decimal
- Desc: Surface area of the piston (square metres).
[edit] safety-valve-low-pressure
- Type: Decimal
- Desc: Pressure (absolute, and in kPa) at which the low pressure safety valve will open.
[edit] safety-valve-low-flow
- Type: Decimal
- Desc: Kilograms per second. Rate at which steam escapes through the low pressure safety valve. Note: Too high a value will result in a 'sawtooth' boiler pressure, and repeated short hisses from the safety valve.
[edit] safety-valve-high-pressure
- Type: Decimal
- Desc: Pressure (absolute, and in kPa) at which the high pressure safety valve will open.
[edit] safety-valve-high-flow
- Type: Decimal
- Desc: Kilograms per second. Rate at which steam escapes through the high pressure safety valve. Remember that both valves will be open at this point.
[edit] shovel-coal-mass
- Type: Decimal
- Desc: The mass of a single "shovel" of coal. This affects manual shovelling (default key- spacebar) and the rate of the automatic fireman (the coal slider in the UI).
[edit] water-injector-rate
- Type: Decimal
- Desc: Maximum flow rate of the first injector when fully open (kg/s).
[edit] water-injector-rate2
- Type: Decimal
- Desc: Maximum flow rate of the second injector when fully open (kg/s).
[edit] boiler-efficency-idle
- Type: Decimal
- Desc: Ratio (0.0 -> 1.0). The maximum efficiency of the boiler - e.g. when the loco is idle.
[edit] boiler-efficency
- Type: Decimal
- Desc: Ratio (0.0 -> 1.0). Efficiency of boiler when working at test parameters.
[edit] boiler-efficency-min
- Type: Decimal
- Desc: Absolute minimum boiler efficiency. Calculated efficiency will not fall below this value.
[edit] speed
- Type: Decimal
- Desc: Speed (m/s) of test run on which test parameters are based.
[edit] cutoff
- Type: Decimal
- Desc: Ratio (0.0 -> 1.0). Position of cutoff control for test run.
[edit] blower-effect
- Type: Decimal
- Desc: Multiplier. Sets the effectiveness of the blower. Value is the draft effect of working the loco at the test parameters compared with running the blower at maximum boiler pressure but the loco otherwise idle.
[edit] blower-max-flow
- Type: Decimal
- Desc: Moles per second of steam used by blower at max boiler pressure and max setting.
[edit] starting-coal
- Type: Decimal
- Desc: Mass of coal (in kg) to start with in the firebox. Ideal-coal-mass value will be used if this is not present.
[edit] starting-water
- Type: Decimal
- Desc: Mass of water (in kg) to start with in the boiler. Defaults to 85% boiler-volume.
[edit] starting-boiler-steam
- Type: Decimal
- Desc: Mass of steam (in kg) to start with in the boiler. If this is too high, a 'high pressure' will be reported at initial startup (but working the loco will reduce it). If it is too low, the boiler will have to immediately boil water to build pressure, meaning the loco isn't immediately ready on startup. Defaults to 10.
[edit] steam-chest-volume
- Type: Decimal
- Desc: Volume of the steam chest, in cubic metres. A good estimate if unknown is piston-volume-max * number of cylinders (source 5AT website).
[edit] steam-chest-max-flow
- Type: Decimal
- Desc: Moles per second. Maximum flow rate of steam from the boiler to the steam chest with the regulator fully open.
[edit] valve-lap-percent
- Type: Decimal
- Desc: Ratio (0.0 -> 1.0)
[edit] hand-brake-max-force
- Type: Decimal
- Desc: Maximum force exerted by handbrake.
[edit] super-heating-constant
- Type: Decimal
- Desc: Degrees (kelvin) to increase temperature of steam between boiler and steam chest. High superheat results in more power at the front end.
[edit] tractive-effort-constant
- Type: Decimal
- Desc: Used to calculate theoretical performance along with cylinder dimensions for the AI to use. Defaults to 0.4 * number_of_cylinders.
[edit] number-cylinders
- Type: Integer
- Desc: Number of cylinders.
[edit] number-power-strokes
- Type: Integer
- Desc: Number of power strokes per revolution. Two is by far the most common number, but this can be other numbers in extreme cases.
[edit] legacy-piston-count
- Type: Decimal
- Desc: Used for loading old (TRS2006) saved sessions. An omission in the TRS2006 save format causes a loco with a different number of pistons not to load properly. The number of pistons often needs to be changed when updating old enginespecs, as previously engines had to have twice as many single acting pistons, rather than the correct number of double acting pistons as they do now. This value is to record the old number of pistons so that old sessions can still be loaded.
[edit] Example steam container
TBD