ENG and WAG File Structure

Aim - this section describes the structure and layout for Open Rails ENG and WAG files, as well as providing some example template files.

Index

Introduction

Typical Engine and Wagon File Layout

Wagon File Structure

Engine File Structure

Include Files

Engine and Wagon Example Templates


Introduction

The example ENG and WAG files put all the separate pieces together to support the creation of "realistic" ENg or WAG files for a steam locomotive, just change the relevant values.

They are based upon NSWGR standards, which may different functions compared to the system that you are modelling. For example NSWGR used single pipe air brakes, if you need vaccum brake, then you will need to adjust the appropriate sections accordingly.

If you wish to use any of these examples as templates, either cut and paste the text into your working file, or you can right click to download the file and then edit it as appropriate.

top


Typical Engine and Wagon File Layout

For ease of reading and finding information these files should be structured in a systematic fashion. The following layout structures are suggested as a possible way to structure the sections within the relevant ENG and WAG files. Click on the relevant link to see more details about the type of information that is included in each section.

Wagon (WAG) File
Engine (ENG) File

The ENG file has two sections, namely a wagon section, and a engine section, as shown in the diagram below. The engine file for a steam locomotive will have different sections when compared to the diesel or electric locomotive.

             Steam Locomotive

top


Wagon File Structure

The various sections of the wagon filke are shown below in each of the boxes. Each box contains the following type of information, which shows what is typically grouped in each of the sections (boxes):

  • Section Name - is indicated by the comment statement.
  • Included in section - indicates the type of information found in the sectionby the comment statement.
  • Example code - provides a representative sample of the parameter statements that may appear in each section. Some of the actual statements may be optional depending upon the type of locomotive, and reference should be made to the links to the detailed information in each section.
  • Link - provides a link to a relevant CTN physics page if more detailed information is available.

When building the WAG or ENG files, it is highly recommended that:

  • comment statements be used to provide relevant documentation that will allow easy finding and checking of information in the relevant file.
  • only parameters known to work in OR are included in the files. This will reduce files sizes, and make it easier to read. Alternatively if it is desired to maintain these parameters in the files, then they should be grouped in a separate section of the file, and claearly commented as such.

top


Engine File Structure

Steam Locomotive

Comment ( *************************** Brake System ***************************
                      Included in this section - Compressor, Reservoir, Application rates, etc
                      *********************************************************************** )

Example Code -

Comment ( == Compressor, Main Reservoir and General == )
AirBrakesMainMaxAirPressure( 105.0 )
AirBrakesCompressorRestartPressure( 90.0 )
AirBrakesMainResVolume ( "9.549*(ft^3)" ) Comment (Assume 1 x 9.549 cu ft main reservoir volume)
ORTSMainResChargingRate ( 0.313 ) Comment (Assume 6.0in Compressor)
ORTSBrakePipeChargingRate ( 40.0 )

Comment ( == Automatic Brake valve - Train == )
TrainBrakesControllerMaxSystemPressure ( 70 )
TrainBrakesControllerMaxReleaseRate ( 1.0 )
TrainBrakesControllerMaxQuickReleaseRate ( 20.0 )
TrainBrakesControllerMaxApplicationRate ( 0.5 )
TrainBrakesControllerEmergencyApplicationRate ( 30.0 )
TrainBrakesControllerFullServicePressureDrop ( 25.0 )
TrainBrakesControllerMinPressureReduction ( 7.0 )

Comment ( == Independent Brake valve - Engine & Tender == )
EngineBrakesControllerMaxSystemPressure ( 70 )
EngineBrakesControllerMaxReleaseRate ( 1.0 )
EngineBrakesControllerMaxQuickReleaseRate ( 20.0 )
EngineBrakesControllerMaxApplicationRate ( 0.5 )
EngineBrakesControllerEmergencyApplicationRate ( 30.0 )
EngineBrakesControllerFullServicePressureDrop ( 25.0 )
EngineBrakesControllerMinPressureReduction ( 7.0 )

Link -

Brakes
BrakeControllers

Top - Steam Layout

top


Include Files

INCLUDE files can be used streamline the development of ENG or WAG files as follows:

INCLUDE files can be used to add information to either rolling stock or routes.

To implement an INCLUDE file it is necessary to follow the following steps: