9 Menus and Commands

9.1 Generals

The descriptions of models or events are immediately changed whenever you type a key in the description field. All other numerical or text values are changed after pressing ’Enter’ only.

Note that not all commands or properties will be available in a specific situation. Typically only those possibilities, that make sense and result in a valid model are offered. In the case that a error occurs when executing a command, an error message is displayed in the status bar or in the message window.

9.2 The File Menu

This menu contains all commands related to the project, its models and libraries. Most commands are also available in pop-up menus that open when pressing the right mouse button in the project members tree.

9.2.1 New Project

If there is an open project this will be closed. If necessary you are asked to save data. After that a dialog will appear where you are asked for a name of the new project. Finally an empty project will be created.

9.2.2 Open Project

If there is an open project this will be closed. If necessary you are asked to save data. After that a dialog will appear where you can select the project to be opened. All libraries and models referred in the project file will be opened and indicated in the ’Project Members’ tree.

9.2.3 Close Project

The current project is closed. If necessary you are asked to save changes in the project, library or models.

9.2.4 Project Properties

A project properties dialog window will open where you can set the project properties. Refer to section 2.4 for details.

9.2.5 Create new Package

A new package is created by File – Create new Package. You will be asked for the name of the new package. A sub-directory with the given name will be created in the project directory, and the local library file will be created.

9.2.6 Import Package

A package created in one project can be imported to the currently open project. When selecting File – Import Package, a dialog will open up where you can select the package directory, and enter a new package name, see figure 15.


PIC

Figure 15: Import package dialog


The package will be copied to the open project, using the entered name.

9.2.7 Create new Member

A new project member is created by File – Create new Member. The Create New Member Dialog will open, where you can select the package the new member shall belong to, and the name and type of the new member, see figure 16.


PIC

Figure 16: The create new member dialog


9.2.8 Add existing Member File

When selecting File – Add existing Member File, a dialog will appear where you can select the file to be added to the project, see figure 17.


PIC

Figure 17: Add existing member dialog


Per default, only files with extension .ignore will be displayed. Anyhow you can also select other files, including files already belonging to another package of the project.

You can select the package to which the member shall be added, and enter a name for it.

9.2.9 Remove active Member

The reference to the member presented in the active tab will be removed from the project, the tab will be closed. If necessary you are asked to save data of this member.

9.2.10 Rename active Member

The project member presented in the active tab can be renamed by File – Rename active Member. A dialog will appear asking you for a new name.


PIC

Figure 18: Rename member dialog


9.2.11 Move active Member

The project member presented in the active tab can be moved to another package by File – Move active Member. A dialog will appear asking you for a new package.

9.2.12 Duplicate active Member

The project member presented in the active tab can be duplicated by File – Duplicate active Member. A dialog will appear asking you for the package and the name of the duplicate.


PIC

Figure 19: Duplicate member dialog


9.2.13 Save active member

Saves the project member currently displayed in the graphics tab. The file extension is automatically appended.

9.2.14 Save All

All project members and the project are saved if changed. Note that a project, that has not been saved after the latest modification, is marked with an asterisk ’*’ in the window title. An unsaved project member is marked with an asterisk ’*’ in the title of its graphics frame.

9.2.15 List of recently used projects

A list of recently used projects is presented. Selecting one is similar to File – Open Project, only that no dialog will appear.

9.2.16 Exit

If necessary you are asked to save changes in the project or in project members. After that the application is terminated.

9.3 The Edit Menu

The Edit menu contains all commands related to changing the structure of a fix train model.

The actions are also available as button in the menu bar. For some actions keyboard commands (short-cuts) exist, see the entries in the Edit menu.

9.3.1 Undo last change

The last 10 actions can be withdrawn. Here an action can be either an edit-action as stated above or a change of some value. The tool-tip text always informs about the next action of the undo-action.

9.3.2 Redo last undo

All undo actions can be withdrawn.

9.3.3 Add Brake Component Model

You can add brake component models by Edit – Add Brake Component Model. A brake component model will be added to the fix train model and displayed in the brake components table. A unique name will be automatically assigned to the new brake component model.

9.3.4 Delete

In case a brake failure model of a fix train model is selected, this brake failure model will be deleted.

9.3.5 Cut

The selected brake failure model will be deleted.

A deleted brake failure model is stored in the background so that it can be pasted at another position.

9.3.6 Copy

The selected brake failure model will be copied to a background memory. It can be pasted somewhere, see below.

9.3.7 Paste

If a fix train model is active and a brake failure model has been cut or copied before, it will be added to the active fix train model below the last brake failure model.

9.4 The Calculate Menu

9.4.1 Calculate Brake Models

All nominal brake models and all corresponding safe brake models (i. e. correction factors) are calculated.

This operation is only available, if a fix train model is the active member.

9.4.2 Calculate Scenario Limits

The limits related to a scenario are calculated and shown in the result’s table in the lower part of the panel.

This operation is only available, if a scenario is the active member.

9.4.3 Show Brake Distances by EBCL Chart

A chart window will open, showing the brake distances as a function of speed and EBCL, see section 4.6.

This operation is only available, if a fix train model is the active member and the brake models have been calculated already.

9.4.4 Show Limits Chart

A chart window will open, showing the limits for the scenario as a function of location, see section 8.2.

This operation is only available, if a scenario is the active member.

9.5 The Export Menu

9.5.1 Export Fix Train Brake Models

Saves all brake models of the active fix train model in a XML file with extension .ebm. Depending on the result mode either absolute values are written or correction factors. In addition a list of the brake model index sections of the fix train model is stored in a XML file with extension .ebi. Finally a C / C++ file (extension .c) is created, that should be used in the vehicle control or brake control in order to calculate the brake model index according to the currently available elements of each kind.

All files have the same name and are stored in the same directory as the train model file (.tm).

This operation is only available, if a fix train model is the active member and the brake models have been calculated already.

9.5.2 Export Limits

The values shown in the limits table (and some more) will be written to a .csv file. The file will be written to the export sub-directory of the directory of the scenario.

This operation is only available, if a scenario is the active member and the limits have been calculated already.

9.6 The Help Menu

9.6.1 Help

The content of this document is presented in HTML format.

9.6.2 Set License File

Specify the path to the license file here.

Note: You must restart ETCS Brake Model Tool to load the new license file.

9.6.3 About

A window opens, indicating the version of ETCS Brake Model Tool and some parameters of the license.

9.7 The tool bar

All frequently used commands are also available as buttons in the tool bar. The tool bar is context sensitive.

Table 4: Toolbar buttons
Icon Command


PIC Close project and open another project
PIC Save active model
PIC Save all
PIC Project properties
PIC Create new member
PIC Add existing file to project
PIC Undo last change
PIC Redo last undo
PIC Add brake component model
PIC Delete brake component model
PIC Cut brake component model
PIC Copy brake component model
PIC Paste brake component model
PIC Calculate scenario or correction factors
PIC Show scenario limits chart
PIC Show fix train brake distances by EBCL chart