BTN-1709003

GRAPE User’s Guide

September, 2017
Nuclear Engineering, Ltd.
 ATN-1709003

This page is intentionally left blank.

 ATN-1709003

Proprietary Information Class 2

This document is proprietary to Nuclear Engineering, Ltd. (NEL). The

recipient shall not use this document for any purposes other than its
intended purpose, nor disclose this document and/or information
therein to any third party without official permission from NEL.
 ATN-1709003

Contents

1. Introduction ......................................................................................................................................... 1
2. Tutorials ............................................................................................................................................... 3
2.1. Start-up of GRAPE ..................................................................................................................... 3
2.2. View Calculation Results ........................................................................................................... 4
2.3. Run Calculation ........................................................................................................................ 14
2.4. Exit System ............................................................................................................................... 21
3. Functions............................................................................................................................................ 22
3.1. Control Ribbon.......................................................................................................................... 22
3.2. Project Control .......................................................................................................................... 23
3.2.1. Create project .................................................................................................................... 23
3.2.2. Open project...................................................................................................................... 25
3.2.3. Save as new project .......................................................................................................... 27
3.2.4. Save project....................................................................................................................... 29
3.2.5. Delete project .................................................................................................................... 29
3.3. Input Features............................................................................................................................ 30
3.3.1. Edit calculation conditions .............................................................................................. 31
3.3.2. Advanced input features .................................................................................................. 38
3.3.3. Input error notifications ................................................................................................... 40
3.3.4. Show input file.................................................................................................................. 47
3.4. Run/Stop .................................................................................................................................... 49
3.4.1. Run calculation ................................................................................................................. 49
3.4.2. Stop calculation ................................................................................................................ 51
3.5. Visualization Features .............................................................................................................. 52
3.5.1. Plant diagram .................................................................................................................... 52
3.5.2. Noding diagram ................................................................................................................ 61
3.5.3. Core diagram .................................................................................................................... 68
3.5.4. Event log ........................................................................................................................... 75
3.5.5. Trend graph ....................................................................................................................... 76
3.5.6. Time slider ........................................................................................................................ 91
3.5.7. Show output file ............................................................................................................... 98
3.6. Useful Features ....................................................................................................................... 100
3.6.1. Screen shot ...................................................................................................................... 100
3.6.2. Open tab as window ....................................................................................................... 101
 ATN-1709003

3.6.3. Screen setting .................................................................................................................. 102

3.6.4. Status notification........................................................................................................... 107
4. Summary .......................................................................................................................................... 108
 ATN-1709003

1. Introduction
GRAPE (Graphical RELAP/SCDAPSIM Analysis Platform for Education and engineering) is
an analysis platform compatible with RELAP/SCDAPSIM. The present system automatically setup
analysis and visualization environments only with a simple operation. Therefore, not only you can
reduce the hustle and bustle of input deck making or data management, but also it helps you
concentrate on your research and/or engineering activities. The present system is equipped with the a
typical 4-loop PWR plant model
Calculation and visualization procedures in the present system are as follows:
At first, the present system automatically generates an input deck depending on the specified
calculation condition on the graphical user interface (GUI) of the present system. Then, it is executed
with RELAP/SCDAPSIM. (Fig. 1) Thus, the present system can dramatically reduce the burden of
input deck making of RELAP/SCDAPSIM.

Calculation Input
conditions deck

RELAP/
GRAPE SCDAPSIM

Fig. 1 Calculation flow of the present system

In addition, the present system visualizes the calculation results of RELAP/SCDAPSIM in real time
on the GUI. It helps users intuitively understand calculation results . (Fig. 2)

Visualization Calculation
results
RELAP/
GRAPE SCDAPSIM

Fig. 2 Visualization flow of the present system

In the present system, a set of relevant files to the calculation are summarized in a directory as a
“project” as shown in Fig. 3.

1
 ATN-1709003

RELAP/SCDAPSIM RELAP/SCDAPSIM Project file

input deck output file (*.saproj)
(relap.i) (relap.o)

01010100101
01011000101
0100101010

RELAP/SCDAPSIM RELAP/SCDAPSIM Database of 

steam table Restart file calculation results
(tpfd2o/tpfh2o) (relap.r) (relap.h5)

Input files Output files Management files

“Project”

Fig. 3 A set of files related to a calculation, project

Contents of this manual is as follows:

Chapter 1 Introduction (this chapter)

Introduction of the present system is described.

Chapter 2 Tutorials
The way to use the present system is described.
If it is the first time for you to use the present system, please be sure to read this chapter.

Chapter 3 Functions
Detailed description about the functions of the present system is described.

Chapter 4 Summary
Summary of this manual and contact information are described..

2
 ATN-1709003

2. Tutorials
In this chapter, the way to use the present system is described through an analysis flow.

2.1. Start-up of GRAPE

1) Double-click the shortcut icon, “GRAPE”, to launch the present system. (Fig. 4) If there is no
the shortcut icon, double-click the executable, “sa_sim.exe”, located at “C:/grape/package”.

Fig. 4 Shortcut icon of the present system

2) The following title screen appears. (Fig. 5)

Fig. 5 Title screen of the present system

3
 ATN-1709003

2.2. View Calculation Results

In this section, the way to show calculation results is described.

1) Click the open project button to load a calculation result. (Fig. 6)

Open project
button

click!

Fig. 6 Open project button

2) The dialog to select a project file appears. (Fig. 7) Move to “C:¥grape_trial¥package” where is
the default data directory of the present system.

Fig. 7 Dialog to select project file

4
 ATN-1709003

3) The following project directories are stored in the default data directory.

Table 1 Projects directories stored in the default data directory

Project directory name sample case
PWR_LOCA Cold leg LOCA scenario in PWR plant

Double-click the directory, “PWR_LOCA”. (Fig. 8)

double-click!

Fig. 8 Project directory stored in the default data directory

5
 ATN-1709003

4) Click the project file, “PWR_LOCA.saproj”, located at the project directory “PWR_LOCA”.
Then, click “Open”. (Fig. 9)

click!

click!

Fig. 9 Project file, PWR_LOCA.saproj, in the project directory

5) Opening the project file, the title screen is reloaded. (Fig. 10) The following tabs are added to
the title screen.
Static condition tab : the tab to specify static calculation conditions
Transient condition tab : the tab to specify perturbation/malfunction conditions
Plant diagram tab : the tab to show major plant parameters
Core diagram tab : the tab to show detailed parameter distribution in the core
Event log tab : the tab to show an event list

Fig. 10 Reloaded title screen after opening the project file

6
 ATN-1709003

Overview of each tab is as follows:

Static condition tab

Click the tab, “Static condition”, to show it. This is the screen to input calculation
conditions and/or set-points of plant components. (Fig. 11) In the present calculation,
availabilities of safety injections are specified in this tab. (See section 3.3 for detail.)

click!

Fig. 11 Static condition tab

7
 ATN-1709003

Transient condition tab

Click the tab, “Transient condition”, to show it. This is the screen to specify conditions
such as perturbations and malfunctions. (Fig. 12) In the present calculation, the recirculation
line break condition and other manual trip conditions are specified. (See section 3.3 for detail.)

click!

Fig. 12 Transient condition tab

8
 ATN-1709003

Plant diagram tab

Click the tab, “Plant”, to show it. This is a diagram to show global plant behavior of with
major plant parameters. (Fig. 13)

click! Major
parameters

Fig. 13 Plant diagram

Diagram shown at the center of the screen is the plant diagram. Text boxes around the diagram
show you values of major plant parameters at the selected time with the time slider. (Fig. 14)
Play buttons allows you to playback calculation results. (See sections 3.5.1 or 3.5.6 for detail of
plant diagrams or the time slider.)

Selected time

Time slider

Playback button

Fig. 14 Time slider to select time to show calculation results

9
 ATN-1709003

Core diagram tab

The core diagram is a screen to show detailed parameter distribution inside the core. Click
the core tab, “Core”, to show it. (Fig. 14)

click!

Fig. 15 Core diagram

The core diagram tab shows color maps of REAP, SCDAP and COUPLE’s parameter distribution at
a selected time with the time slider. (See section 3.5.3 for detail of the diagrams.)

10
 ATN-1709003

Event log tab

The event log tab is a screen to show a list of events occurred in a transient calculation.
Click the event tab, “Event”, to show it. (Fig. 16) Event name and its time of occurrence are
shown on the screen.

click!

Fig. 16 Event log

11
 ATN-1709003

Noding diagram tab

Click the noding diagram button located at the top of the screen to show noding diagrams.
(Fig. 17) This diagram shows a color maps of thermal-hydraulic parameters with noding. You
can add another noding diagram by clicking the button again.

Noding diagram button

click!

Fig. 17 Noding diagram

The diagram shown at the center of the screen is the noding diagram. In noding diagrams, a
color map of thermal-hydraulic parameters is shown at a selected time with the time slider. (See
section 3.5.3 for detail of noding diagrams.)

12
 ATN-1709003

Trend graph tab

Click the trend graph button located at the top of the screen to show trend graphs. (Fig. 18)
Dragging and dropping parameters onto the trend graph area, a new trend graph is created. Not
only thermal-hydraulic parameters but also user-defined parameters (i.e., cntrlvar defined as
control component in input decks of RELAP/SCDAPSIM) are available. (See section 3.5.4 for
detail of trend graph.)

Trend graph button

click!

Drag&drop

Fig. 18 Trend graph

13
 ATN-1709003

2.3. Run Calculation

In this section, the way to run a new calculation is described.

1) Click the create project button to specify a new calculation condition. (Fig. 19)

Create new
project button

click!

Fig. 19 Create project button

2) The following dialog to select a plant model appears. (Fig. 20)

Fig. 20 Dialog to select plant model

14
 ATN-1709003

3) Select a plant model in the dialog. Then, choose a directory to save a project and input a new
project name. For example, in this tutorial, select BWR model and input directory and project
name as follows: (Fig. 21)
Directory to save project : C:¥grape_trial¥user case
Project name : locked_rotor
Then, click the “OK” button.

click!

Click to choose
a directory

(a) Select plant model (b) Choose directory and project name
Fig. 21 Create a new project

Through this step, the following project directory and project files are created.
Project directory : C:¥grape_trial¥user case/locked_rotor
Project file : C:¥grape_trial¥user case/locked_rotor/locked_rotor.saproj

15
 ATN-1709003

4) Tabs to specify calculation conditions, i.e., the static condition and the transient condition tabs,
appears. (Fig. 22) In the input screen, there is a list of available input items at the left of the
screen.

Input
item list

Fig. 22 Input screen

5) Show the static condition tab and click the item, “Calculation Condition”, located at the top of
the input item list. The input item, “Time step”, appears.

Click!

Fig. 23 Input item, time step

16
 ATN-1709003

6) When input items in the input item list located the left panel are clicked, tables and/or text
boxes are added to the calculation condition list located at the right panel. Specified calculation
conditions in the right panel will be used in a transient calculation. For example, click the item,
“Time step”. A time step table is added to the calculation condition list. (Fig. 24)

click!

Calculation condition list

Fig. 24 Time step table added to the calculation condition list

7) Specify the time step conditions in the table. (Fig. 25) In the following example, the transient
calculation is carried out until 100 seconds because “end time” is specified as 100 sec.

Fig. 25 Input of time step table

17
 ATN-1709003

8) As a next, click the transient condition tab to specify conditions such as perturbations and
malfunctions. (Fig. 26)

click!

Fig. 26 Transient condition tab

9) Click “Perturbations” located at the input item list in the left panel of the transient condition tab.
Then, click the item, “RCP failure”. (Fig. 27)

click!

Fig. 27 Input item for recirculation line break

18
 ATN-1709003

10) The following input boxes appear. Specify the break mode as “Locked rotor”, the break time as
50.0 sec, and target loop as “A-loop”. (Fig. 28)

Fig. 28 Input of locked rotor condition

19
 ATN-1709003

11) Finally, click the run button located at the top of the screen to run the calculation. (Fig. 29)

Run button

click!

Fig. 29 Run calculation

12) If you want to terminate the calculation, click the stop button. (Fig. 30)

Stop button

click!

Fig. 30 Stop calculation

20
 ATN-1709003

2.4. Exit System

Click the “x” button to exit the present system. (Fig. 31)

Exit
button

Fig. 31 Exit button

If you exit the present system during execution of RELAP/SCDAPSIM, calculations of

RELAP/SCDAPSIM will be continued. If you want to terminate the calculations,
terminate the executable of RELAP/SCDAPSIM by yourself.

21
 ATN-1709003

3. Functions
In this chapter, the detailed functions of the present system are described.

3.1. Control Ribbon

The control ribbon located at the top of the screen allows users to select the various functions of
the present system. (Fig. 32)

Control ribbon

Fig. 32 Control ribbon

Available buttons are displayed in solid black line. (Fig. 33) Clicking the available button, the
function assigned to itis launched.

(a) Not available (b) Available

Fig. 33 Availability of the buttons

22
 ATN-1709003

3.2. Project Control

In this section, functions to create, open or save a project are described.

3.2.1. Create project

1) Click the create project button to specify a new calculation condition. (Fig. 34)

Create new
project button

click!

Fig. 34 Create project button

2) The following dialog to select a plant model appears. (Fig. 35)

Fig. 35 Dialog to select plant model

23
 ATN-1709003

3) Select a plant model in the dialog. Then, choose a directory to save a project and specify a new
project name. (Fig. 36) Then, click the “OK” button to make a project.

Blank or space characters are not allowed for the directory and the project names.

click!

Click to choose
a directory

(a) Select plant model (b) Choose directory and project name
Fig. 36 Create a new project

In the above example, the following project directory and project files are created.
Project directory : C:¥grape_trial¥user case/locked_rotor
Project file : C:¥grape_trial¥user case/locked_rotor/locked_rotor.saproj

24
 ATN-1709003

3.2.2. Open project

1) Click the open project button located at the top of the screen. (Fig. 37)

Open project
button

click!

Fig. 37 Open project button

2) The following dialog to select a project file appears. Click a project file, *.saproj. Then click the
“Open” button. (Fig. 38) Click the “Cancel” button to cancel.

click!

click!

Fig. 38 Dialog to select a project file (*.saproj)

25
 ATN-1709003

3) Opening a project file, the static and the transient condition tabs appear. If calculation results
have already existed, tabs to show calculation results are also shown on the display.

If calculation results have already existed, the following message might be shown on
the display.

“Input conditions are updated after the execution of the calculation.”

This message will be shown if the calculation condition in static and transient
condition tabs are modified after the execution. Running the calculation again, this
message will not be shown.

26
 ATN-1709003

3.2.3. Save as new project

This function allows users to save a project as a new one. It is useful to make some calculation
conditions for sensitivity analysis.

1) Click the save project button located at the top of the screen. (Fig. 39)

Save project button

click!

Fig. 39 Save project button

2) Click “Save as” in save options. (Fig. 40)

Save options

Fig. 40 Save option, “Save as”

27
 ATN-1709003

3) Select a directory to save a project and specify a new project name in the project save dialog.
(Fig. 41) Click the “OK” button to save the project. Click the “Cancel” button to cancel.

Fig. 41 Project save dialog

The calculation result shown in the display after saving as another project is that of
newly created project.

Name of the project currently opened with the present system is shown at the title
bar.

Project name
currently opened

28
 ATN-1709003

3.2.4. Save project

This function allows users to save input conditions in current project.

1) Click the save project button located at the top of the screen. (Fig. 42)

Save project button

click!

Fig. 42 Save project button

2) Click “Save” in save options. (Fig. 43)

Save options

Fig. 43 Save options, “Save”

3.2.5. Delete project

There is no specifications to manage projects. Delete a project directory within the windows
explorer.

29
 ATN-1709003

3.3. Input Features

The present system has two tabs to specify calculation conditions, i.e., static condition and
transient condition tabs. (Fig. 44)
Static condition tab : The tab to specify calculation conditions such as time step
table, set-points of plant components and boundary
conditions
Transient condition tab : The tab to specify conditions such as perturbations and
malfunction during transient

Tabs to specify
calculation conditions

Fig. 44 Tabs to specify calculation conditions

In the following subsections, the way to specify calculation conditions is described.

30
 ATN-1709003

3.3.1. Edit calculation conditions

The static and transient condition tabs have the input item list and the calculation condition list.
(Fig. 45) The input item list located at the left of the screen is a list of available input items. All input
items in the input item list correspond to input cards of RELAP/SCDAPSIM, and you can choose
any input items to change corresponding calculation conditions. The calculation condition list
located at the right side of the screen is a list of specified calculation conditions which you can freely
edit.

Input
item list Calculation condition list

Fig. 45 Input item list and calculation condition list

To specify calculation conditions, click an input item from the input item list. Since a panel to edit
the corresponding calculation condition of the selected input item appears in the calculation
condition list, edit it as you like.

In order to run a calculation, at least time step table must be specified in the present
system.

31
 ATN-1709003

3.3.1.1. Add input item

1) Available input items are grouped by plant components in the input item list located at the left
of the screen. (Fig. 46)

click!

Available input items

for safety injections

Fig. 46 Available input items for safety injections of BWR plant model

32
 ATN-1709003

2) Click an input item to specify the corresponding calculation condition. A panel to edit input
parameters appears at the right side of the screen. (Fig. 47)

Default value

click!

Panel to specify input parameters

Fig. 47 Input item added to calculation condition list

33
 ATN-1709003

3.3.1.2. Modify input value

Values on a panel added to the calculation condition list located at the right side of the screen
are modified as you like. Click an object on the panel, e.g., text box or table, etc., to modify its
value.

click to edit

Fig. 48 Modification of default value

The present system has the following input objects:

 Text box
 Table
 Radio button
 Combo box
The way to edit the value of each object is as follows:

34
 ATN-1709003

Text box
Fig. 49 shows an example of text box objects. Click to edit the value.

click to edit

Fig. 49 Input object, text box

If you leave a text box which has a default value blank, the original default value is used
for transient calculations.

Table
Fig. 50 shows an example of table objects. Click a value to edit as well as text box.

click to edit

Fig. 50 Input object, table

If the mouse cursor is in a table, the following two buttons, which allow you to copy or remove the
row, appear at the right side of the row. (Fig. 51)

remove this row

copy & add of this row

Fig. 51 Copy/remove table row

The tab key allows you to move the focus to next cell.

35
 ATN-1709003

Radio button
Fig. 52 shows an example of a radio button object. Select one option from a set of alternatives.
The option with a check mark is the selected one.

click to select

Fig. 52 Input object, radio button

Combo box
Combo box objects also allow users to select one option from a set of alternatives as well as
radio button. (Fig. 53) Click to select another option.

click to select another option

Fig. 53 Input object, combo box

36
 ATN-1709003

3.3.1.3. Remove input item

Click the remove button to remove the input item from the calculation condition list. (Fig. 54)

click to remove

Fig. 54 Remove input item from calculation condition list

37
 ATN-1709003

3.3.2. Advanced input features

As a more advanced input feature, the present system allows users to use input cards of
RELAP/SCDAPSIM from GUI.

1) Click the input item group, “Manual Card Edit”, located at the bottom of the input item list.
Then, click the item, “RELAP input cards”. (Fig. 55)

click!

Fig. 55 Input item, “RELAP input cards”

38
 ATN-1709003

2) The following panel which has a text area appears at the right side of the screen. Write input
cards of RELAP/SCDAPSIM. (Fig. 56) They are added to the input file as is when the present
system automatically generates the input file for this calculation.

Text area for input cards

Fig. 56 Text area to edit input cards

Both the static condition and the transient condition tabs have the same input item,
“RELAP input cards”. However, the present system adds input cards corresponding to
specified input items in the static condition tab to input templates. After that, input cards
in the transient condition tab are added.

39
 ATN-1709003

3.3.3. Input error notifications

The present system checks input values and indicates input errors with error messages and
red-hatching of input objects. In this subsection, error messages and their solution are described.

3.3.3.1. Invalid number error

If text boxes or table objects are input unrecognizable characters as numbers, the present system
indicates the error in the following message. (Fig. 57)

Error message
Input numerical value.

Fig. 57 Invalid number error

Specify a valid number to fix this error,. Examples of valid and invalid numbers are as follows:
Valid number 0.001, 1.0E-3, 1e-3, 1000, 1.00E+3, etc
Invalid number 1.0D-3, 1.0-3, etc

40
 ATN-1709003

3.3.3.2. Range error

If input values of text boxes or table objects are not within their allowed range, the present
system indicates the error with the following message. (Fig. 58)

Error message
Input value is not within the allowed range, <interval notation>

Fig. 58 Range error

Specify a value within the range shown in the interval notation to fix this error. Interval notations
indicate as follows:
(min, max) min  (input value)  max
[min, max) min  (input value)  max
(min, max] min  (input value)  max
[min, max] min  (input value)  max

41
 ATN-1709003

3.3.3.3. Input required error

Input parameters marked with Required must be input. If not, the following error message
appears. (Fig. 59)

Error message
This value must be input.

Fig. 59 Input required error

Specify a value to fix this error.

42
 ATN-1709003

3.3.3.4. Duplicated cell value error

End time of the time step table cannot be duplicated with RELAP/SCDAPSIM. If such time
step table is specified, the present system indicates it with the following message. (Fig. 60)

Error message
Value in this row is duplicated with that of other one.

Fig. 60 Duplicated cell value error

Specify different value for the cells in the first column to fix this error.

43
 ATN-1709003

3.3.3.5. Incomplete table error

In table objects, cells in each row must be full-filled or all blank. If there are incomplete rows,
the present system indicates it with the following message. (Fig. 60)

Error message
Input a value in blank cell.

Fig. 61 Incomplete table error

Specify values in blank cells or delete the row to fix this error.

44
 ATN-1709003

3.3.3.6. Duplicate entry error

If there is already an existing input items, the following error message might be shown.

Error message
This input item competing with other input items.

For example, if two recirculation line break conditions are specified as shown in Fig. 62, they are
competing with each other because they are trying to occur a line break at the same recirculation line
with the different conditions. In this case, the present system indicate this error.

Fig. 62 Duplicate entry error

Remove one of the competing conditions from the calculation condition list located at the right side
of the screen to fix this error.

45
 ATN-1709003

3.3.3.7. Too many input items error

Number of each input item which can be specified in the calculation condition list located at
the right side of the screen is restricted by the present system. If too many calculation conditions are
specified on the calculation condition list, the present system indicates it with the following message.

Error message
Too many input items!

Fig. 63 Too many input items error

Reduce the number of the input items on which the error message appears to fix it.

46
 ATN-1709003

3.3.4. Show input file

Automatically created input files of RELAP/SCDAPSIM using specified calculation conditions
on GUI can be confirmed with the present system.

1) Click the show input/output file button located at the top of the screen. (Fig. 64)

show input/output file button

click!

Fig. 64 Show input/output button

2) Click the option, “show input file”, to open the input file created with the specified calculation
condition. (Fig. 65)

表示オプション

click!

Fig. 65 Option, “show input file”

47
 ATN-1709003

If the input file is opened with another software or some errors are detected in
template files, the following dialog will be shown. If you are opening the input file
with another software, close it and try it again. If not, please see the DSL log file
located at “C:/grape/package/dsl/error.log”.

3) The present system automatically generates an input file and it is opened with the text editor,
notepad.

Fig. 66 Created input file

Modifications of the opened input file is not reflected to transient calculations because
the present system re-creates and overwrites the input file before run it.

48
 ATN-1709003

3.4. Run/Stop
3.4.1. Run calculation
Click the run button located at the top of the screen to run a calculation with RELAP/
SCDAPSIM.

Run button

click!

Fig. 67 Run calculation

In order to run a calculation, at least time step table must be used.

If the present system obtains the calculation result, tabs to show results are automatically shown on
result view screens. (See section 3.5.)

49
 ATN-1709003

If the calculation result already exists in the project, the following dialog appears:

Click the “OK” button to overwrite the existing calculation results. If you don’t want to
overwrite it, click the “Cancel” button and save the project as another name.
If errors detected during input processing with RELAP/SCDAPSIM, the following
dialog appears. Click the “OK” button to open output file.

If the input file is opened with another software or some errors are detected in template
files, the following dialog will be shown. If you are opening the input file with another
software, close it and try it again. If not, please see the DSL log file located at
“C:/grape/package/dsl/error.log”.

50
 ATN-1709003

3.4.2. Stop calculation

Click the stop button located at the top of the screen to stop the calculation. (Fig. 68) Since the
confirmation dialog shown in Fig. 69 appears, click the “OK” button to terminate the calculation.
Click the “Cancel” button to continue the calculation.

Even if the transient calculation is stopped, the calculation results already obtained from
RELAP/SCDAPSIM can be visualized on result view screens. (See section 3.5.)

実行中断
ボタン

click!

Fig. 68 Terminate calculation

Fig. 69 Confirmation dialog to terminate calculation

51
 ATN-1709003

3.5. Visualization Features

The present system has the following screens to see calculation results.
 Plant diagram
 Noding diagram
 Core diagram
 Event log
 Trend graph
In this section, each one of the view screens is described.

3.5.1. Plant diagram

The plant diagram is a screen to show global behaviors of the plant with major plant parameters
shown in text boxes. Click the “Plant” tab to show it. (Fig. 70)

click!

Fig. 70 Show plant diagram

The plant diagram has the following functions:

 Indicators for events, e.g., start-up of safety injection, open/close of valves, etc.
 Widget graphs of main parameters
In the following subsections, detail of each the function is described.

52
 ATN-1709003

3.5.1.1. Indicators
The plant diagram has the following indicators to notify events in the plant.
 Break indicator
 Valve status indicator
 Reactor scram indicator
 Safety injection indicator
 Water level indicator
In this subsection, detail of each indicator is described.

LOCA indicator
Break indicator is shown at the position of a break of something with mark when a break of
something occurs. (Fig. 71)

Pipe break

Fig. 71 Break indicator

53
 ATN-1709003

Valve status indicator

Each valve status indicator shows its status with a solid color. (Fig. 72) White means the valve
is fully opened. Black means it is fully closed. The color of the indicator has linear relationship with
the ratio of the current valve stem position to the fully open valve stem position. (Table 2)

Fig. 72 Valve status indicators

Table 2 Valve status vs color of valve status indicator

Valve status Close 50% open 100% open
Indicator color

54
 ATN-1709003

Reactor scram indicator

Reactor scram indicator indicates the reactor trip event with the animation of control rods. (Fig.
73)

Fig. 73 Reactor scram indicator

55
 ATN-1709003

Safety injection indicator

Safety injection indicators are shown when safety injections start up. (Fig. 74)

Fig. 74 Safety injection indicators

56
 ATN-1709003

Water level indicator

Water level indicator shows the water level of the core, steam generator and pressurizer. (Fig.
75)

Fig. 75 Water level indicator

57
 ATN-1709003

3.5.1.2. Widget graphs

The plant diagram allows users to show small widget graphs. Widget graphs help them
understand global behaviors of the plant more effectively.

1) Click a parameter value in the plant diagram to show its widget graph. (Fig. 76)

click!

Fig. 76 Show widget graph

58
 ATN-1709003

2) Drag the widget to move it. (Fig. 77)

drag & drop

Fig. 77 Move widget graph

3) Click the “ ” button located at the top-right of the widget graph area to delete it. (Fig. 78)

Fig. 78 Delete widget graph

59
 ATN-1709003

4) You can show multiple widget graphs on the plant diagram. (Fig. 79)

Fig. 79 Multiple widget graphs

60
 ATN-1709003

3.5.2. Noding diagram

The noding diagram is a screen to show a volume-wise thermal-hydraulic parameter distribution.
Clicking the noding diagram button located at the top of the screen to show it. (Fig. 80) You can add
another noding diagram by clicking the button again.

noding diagram button

click!

Fig. 80 Noding diagram

61
 ATN-1709003

In the noding diagram, a volume-wise thermal-hydraulic parameter distribution are shown with a
color map. The thermal-hydraulic property of a specific volume can be easily read by referring a
color bar located at the right-side of the diagram. (Fig. 81) For example, the coolant density of the
red-squared volume in Fig. 81 seems to be about 750~800 kg/m3.

coolant density
750~800kg/m3

Fig. 81 Read coolant density with color map

62
 ATN-1709003

To see its actual value, put the mouse cursor on the target volume. A tooltip will be pop up to show
the value associated with the volume name, e.g., the coolant density at the down comer is 785.2
kg/m3 as shown in Fig. 82.

Fig. 82 Tool tip to show actual thermal-hydraulic property and volume name

Since there are large number of volumes, it would be efficient to understand a global
behavior with a color map and local one with a tooltip.

In the following subsections, functions of noding diagram are described.

63
 ATN-1709003

3.5.2.1. Change parameter to show

1) Click the combo box located at the upper right corner of the screen to change the visualized
parameter. (Fig. 83)

click!

Fig. 83 Combo box to select visualized parameter

2) Click a parameter to show from the pull-down menu. (Fig. 84) Table 3 shows the list of
available parameters.

click!

Fig. 84 Pull-down menu to select parameter name

64
 ATN-1709003

Table 3 Available parameters of noding diagram

Parameter code Parameter name
rho average density
rhof liquid density
rhog vapor density
uf liquid energy
ug vapor energy
voidf liquid fraction
voidg vapor fraction
velf liquid velocity
velg vapor velocity
p Pressure
q heat source
qwg heat source from wall
quals static quality
quale equilibrium quality
tempf liquid temperature
tempg vapor temperature
vapgen interface mass transfer rate
quala noncondensable mass fraction
sound sonic velocity
boron boron concentration
sattemp saturation temperature
floreg Flow regime number
(Refer RELAP/SCDAPSIM Manual,
“Vol. II: User’s Guide and Input
Requirement” for detail)

65
 ATN-1709003

3.5.2.2. Zoom in and zoom out

The scaling buttons located at the upper left of the screen allow users to zoom in or zoom out
the noding diagram. (Fig. 85) The function of each button are as follows:
: Zoom out
: Reset scaling
: Zoom in

scaling
buttons

Fig. 85 Scaling buttons to zoom in / zoom out

Zoom in/out functions are also available with holding down the Ctrl key while scrolling
the mouse wheel. Drag the noding diagram to move its center position.

As zooming in the noding diagram, component numbers appear. (Fig. 86)

66
 ATN-1709003

Fig. 86 Show component numbers

67
 ATN-1709003

3.5.3. Core diagram

The core diagram is a screen to show detail transitions and distributions of REALP/SCDAP
/COUPLE parameters. Click the “Core” tab to show it. (Fig. 87)

click!

Fig. 87 Show core diagram

In the following subsections, detail of core diagram is described.

68
 ATN-1709003

3.5.3.1. How to see color map

The core diagram shows RELAP/SCDAP/COUPLE’s parameter distributions are shown with
color maps. Fig. 88 shows the relationships between each color map and color bar.

SCDAP
results

RELAP
results
COUPLE results

Fig. 88 Color bar vs REALP/SCDAP/COUPLE calculation results

69
 ATN-1709003

RELAP/SCDAP/COUPLE properties of a specific volume can be easily read by referring the

corresponding color bar as well as the noding diagram. For example, coolant density of the
red-circled volume in Fig. 89 seems to be about 350 kg/m3.

気液相平均
About
冷却材密度が3
350kg/m
約350kg/m3

Fig. 89 Read coolant density with color map

70
 ATN-1709003

To see its actual value, put the mouse cursor on the target volume. A tooltip will be pop up to
show the value, e.g., the coolant density at the down comer is 353 kg/m3 as shown in Fig. 90.

Fig. 90 Tool tip to show actual thermal-hydraulic property and volume name

71
 ATN-1709003

3.5.3.2. Change parameter to show

1) Click the combo box located at the upper of the color bar to change the visualized parameter.
(Fig. 91)

click!

Fig. 91 Combo box to select visualized parameter

72
 ATN-1709003

2) Click a parameter to show from the pull-down menu. (Fig. 92) shows the list of available
parameters. Available parameters are shown in Table 4.

click!

Fig. 92 Pull-down menu to select parameter name

73
 ATN-1709003

Table 4 Available parameters of core diagram

Parameter code Parameter name
RELAP (See Table 3) -
SCDAP damlev Damage level
0.0 : Intact geometry
0.1 : Rupture due to ballooning
0.2 : Rubble (fragmented)
0.4 : Cohesive debris
1.0 : Molten pool
h2oxd2 Hydrogen production rate
hoop Cladding hoop strain
oxdeo Oxide thickness
cadct Fuel/cladding temperature
COUPLE afbulk Material indicator
0.3 : Mostly Ag-In-Cd
0.4 : Mostly stainless steel
0.5 : Mostly Zr
0.6 : Mostly ZrO2
0.7 : More than 50% UO2
1.0 : More than 70% UO2
tmpcou Debris bed temperature

74
 ATN-1709003

3.5.4. Event log

The event log tab shows a list of events, e.g., signals of control systems and/or open/close of
valves. Click event the event log tab to show it. (Fig. 93)

click!

scroll bar

Fig. 93 Event log

Event name and its time of occurrence are shown on the screen. Scrolling the scroll bar located at the
right side of the screen, you will be able to see all events.

75
 ATN-1709003

3.5.5. Trend graph

Clicking the trend graph button located at the top of the screen, a tab to show trend graphs is
added to the screen. (Fig. 94)
Trend graph button

click!

Fig. 94 Trend graph

Functions to initiate or modify trend graphs are described in the following subsections.

76
 ATN-1709003

3.5.5.1. Make trend graphs

1) Drag and drop parameters shown at the left side of the screen to make trend graphs. (Fig. 95)
Multiple parameters can be also selected with holding down the Ctrl key while clicking
parameter names before drag and drop.

Drag&drop

Fig. 95 Drag & drop parameter to make trend graph

2) Depending on the parameter, the following dialog to select volume numbers appears. (Fig. 96)
Specify volume numbers in the text box located at the top of the dialog with comma separated
form, or select volumes in the noding diagram shown at the center of it.

click!

Fig. 96 Dialog to select volume numbers

77
 ATN-1709003

3) Trend graphs are generated with the selected parameters and the volume numbers. (Fig. 97)

If the background color of the text box becomes red, input volume numbers are not
valid. Check the volume numbers and input them carefully again.

click!

Fig. 97 Trend graphs generated with the selected parameters and volume numbers

78
 ATN-1709003

3.5.5.2. Modify trend graphs

1) Click the legend icon ( ) located at the right side of each trend graph. (Fig. 98)

click! click!

Fig. 98 Open legend

2) Drag and drop a legend into another legend area to move it. (Fig. 99 and Fig. 100)

Fig. 99 Drag and drop of a legend

79
 ATN-1709003

Fig. 100 Trend graphs after moving a legend

3) Drag and drop a legend to the trash icon to delete it. (Fig. 101)

drag&drop

Fig. 101 Delete a legend

80
 ATN-1709003

4) Click the close legend icon ( ) to close the legend area. (Fig. 102)

click!

click!

Fig. 102 Close legend

5) Click the ”x” icon to delete a trend graph. (Fig. 103)

click!

Fig. 103 Delete a trend graph

81
 ATN-1709003

3.5.5.3. Axes set up

Ranges of the x- and y-axes are automatically set up by using maximum and minimum values
of selected parameters. However, they can be also manually modified. In this subsection, the way to
change them is described.

1) Double-click an axis area to change the range of the axis. (Fig. 104)

double-click!

Fig. 104 Axis area (red-hatched area)

2) The dialog to set the range of the axis appears. Click “Manual” to set new range manually. (Fig.
105)

click!

Fig. 105 Dialog to set the range of the axis

82
 ATN-1709003

3) Input a new range, i.e., minimum and maximum values, and click the OK button. (Fig. 106)
Click the “Cancel” button to cancel.

click!

Fig. 106 Manual input of range of the axis

If the background color of the text boxes becomes red, an input value is not valid. Check
the value and input it carefully again.

Ex.) Valid value : 0.001, 1.0E-3, 0.1e-2, 1E-3, …

Invalid value : -5.0*1.0E-2, -5.0*0.01, -5.0x10^-2, -5.0-2, …

83
 ATN-1709003

3.5.5.4. Parameter name search

The text box located at the upper-left of the screen allows users to find a specific parameter
more effectively. Inputting a specific parameter name, the list of candidate appears. Leave the text
box blank to show all parameters.

Fig. 107 Text box to search parameter name

84
 ATN-1709003

3.5.5.5. Pinning of parameters

Clicking a pin icon, the corresponding parameter goes up to the top of the parameter list. (Fig.
108) Clicking it again, the parameter goes back to its original position.

click!

click!

Fig. 108 Pinning of parameters

85
 ATN-1709003

3.5.5.6. Show/hide parameter list

There are buttons to hide/show the parameter list at the top of the trend graph screen. (Fig. 109)
They make trend graphs more visible.

Hide parameter list button

click!

click!

Show parameter list button

Fig. 109 Buttons to show/hide parameter list

86
 ATN-1709003

3.5.5.7. Zoom in and zoom out

The scaling buttons allow users to zoom in and zoom out the list of trend graphs. (Fig. 110 and
Fig. 111)

Scaling
button

Fig. 110 Scaling buttons for trend graph

click!

Zoom out Zoom in

click!

Fig. 111 Zoom in / zoom out of trend graphs

87
 ATN-1709003

Double-clicking a graph area (red-hatched area in Fig. 112), the clicked trend graph area is
maximized or minimized.

double-click!

Zoom out Zoom in

double-click!

Fig. 112 Maximize and minimize trend graph area

88
 ATN-1709003

When trend graph areas are maximized, light blue solid lines are shown on the background.
Putting the mouse cursor on it, the list of events occurred at that time is shown on the top of the trend
graph. (Fig. 113)

Fig. 113 Event list with trend graph

89
 ATN-1709003

3.5.5.8. Data export

Data of trend graphs are exportable by clicking the export button. (Fig. 114) All of the data
shown in a trend graph tab are exported into a csv format file.

Export button

Fig. 114 Export button for trend graph

Clicking the export button, a dialog to enter a file path appears. Enter a file path and save it.

90
 ATN-1709003

3.5.6. Time slider

The time slider allows users to select a specific time to show. (Fig. 115)

Selected
time

Time slider

Fig. 115 Time sider

Dragging the thumb of the time slider, a selected time shown at the lower-left of the screen is
changed. The time slider has also have playback and jump functions, which is described in the
following subsections.

91
 ATN-1709003

3.5.6.1. Playback
Clicking playback button located at the bottom of the screen, the thumb of the time slider is
automatically pushed forward. (Fig. 116)

click!

Fig. 116 Playback button

92
 ATN-1709003

Click the stop button located at the bottom of the screen to stop playback. Playback is also
automatically stopped at the end of time slider. (Fig. 117)

click!

Fig. 117 Stop button

93
 ATN-1709003

Playback layback speed can be changed with the combo box located at the right side of the playback
button. (Fig. 118)

click!

Fig. 118 Combo box to choose a playback speed

94
 ATN-1709003

Dragging and dropping the thumb of the time slider, its position can be changed. If the thumb is
dragged and dropped during automatic playback, it will keep playback from where it is dropped.

Fig. 119 Combo box to choose a playback speed

95
 ATN-1709003

3.5.6.2. Jump functions

The jump buttons located at the left and right side of the playback button allow users to select
beginning and end time, respectively. (Fig. 120)

Jump to beginning time Jump to end time

Fig. 120 Jump buttons to select beginning and end time

96
 ATN-1709003

Inputting a specific time at the text box located at the right bottom of the screen and clicking “Go!!”
button (Fig. 121), the thumb of the time slider also jumps to the specified time. There are 2 ways to
specify the time as follows:
1) Input in seconds order (Ex. t = 130 sec  input as “130”)
2) Input in “mm:ss” manner (Ex. t = 130 sec  input as “2:10”)

click!

Fig. 121 Jump with specifying time to show

97
 ATN-1709003

3.5.7. Show output file

The present system can show output files of RELAP/SCDAPSIM. They will help you to
identify reasons of calculation errors.

1) Click “show input/output file” button located at the top of the screen. (Fig. 122)

show input/output file button

click!

Fig. 122 Show input/output file button

2) Click the option, “show output file”. (Fig. 123)

click “show output file”

Fig. 123 File option, “show output file”

98
 ATN-1709003

3) The output file of RELAP/SCDAPSIM is opened with notepad. (Fig. 124)

Fig. 124 Output file of RELAP/SCDAPSIM

Error messages of RELAP/SCDAPSIM are described at the end of the output file.
For example, the following message will be shown if an input error is detected
during input processing.

Ex.) 0******** Errors detected during input processing.

Search the key word, “0********”, in the output file. It will help you to fix the error.

99
 ATN-1709003

3.6. Useful Features

In this section, other useful features of the present system are described.

3.6.1. Screen shot

The screen shot button allows users to capture a screen shot. Clicking the screen shot button,
image of the screen is copied to the clipboard. It can be pasted on other documents. (Fig. 125)

Screen shot
button

Fig. 125 Screen shot

100
 ATN-1709003

3.6.2. Open tab as window

Dragging and dropping a title of a tab to outside of the window, the tab is opened as a new
window. (Fig. 126)

drag&drop

Fig. 126 Drag and drop of the tab title

Using this function in the multi-display environment, comparison of the parameters or understanding
of the physical phenomena become easier. (Fig. 127)

Fig. 127 Multi-display environment view

101
 ATN-1709003

3.6.3. Screen setting

The present system allows users to save the window layout and showing parameters as a
“screen setting”. This capability helps them

Screen

Screen
setting file
Window layout,
Parameters to show, etc.
Save
screen setting

Project A

Fig. 128 Save screen setting

Restore window layout and

showing parameters

Screen
setting

Load
screen setting Project B

Fig. 129 Load screen setting

102
 ATN-1709003

3.6.3.1. Save screen setting

1) Click screen setting button located at the top of the screen. (Fig. 130)

Screen setting button

click!

Fig. 130 Screen setting button

2) Click the option, “save”, to save current screen layout and showing parameters as a screen
setting file. (Fig. 131)

click “save”

Fig. 131 Screen setting option, “Save”

103
 ATN-1709003

3) Since the following dialog appears, specify a file name to save. Then, click “Save”. (Fig. 132)

Specify screen setting file name

click!

Fig. 132 Dialog to specify screen setting file name

The default saving directory of screen setting file is as follows:

C:/grape/package/model/PWR/favorite

104
 ATN-1709003

3.6.3.2. Load screen setting

1) Click the screen setting button located at the top of the screen. (Fig. 124)

Screen setting button

click!

Fig. 133 Screen setting button

2) Click the option, “Open”, to load a screen setting file. (Fig. 134)

click “open”

Fig. 134 Screen setting file option, “Open”

105
 ATN-1709003

3) Select an screen setting file with the following dialog. Then, click “Open”. (Fig. 135)

select a screen setting file

click!

Fig. 135 Dialog to specify screen setting file

4) Screen setting is automatically restored. (Fig. 136)

Fig. 136 Restored screen setting

106
 ATN-1709003

3.6.4. Status notification

The status of the present system is shown at the status panel located at the upper-right of the
screen. (Fig. 137)

Status
panel

Fig. 137 Status panel

One of the following icon will be shown at the status panel.

(a) waitting for run (b) running calculation (c) calculation completed
Fig. 138 Calculation status

107
 ATN-1709003

4. Summary
In this manual, the way to use the present simulator is described. Please contact us if you have
any questions regarding this manual and/or present system.

550-0001 1-3-7 Tosabori Nishi-ku, Osaka, Japan

Design Group, Design Service Division
Nuclear Engineering, Ltd.
TEL : +81-6-6446-9361 FAX : +81-6-6446-9122
E-mail : sim_support@neltd.co.jp

108
 ATN-1709003

550-0001 1-3-7 Tosabori Nishi-ku, Osaka, Japan

TEL : +81-6-6446-9361 FAX : +81-6-6446-9122
E-mail : sim_support@neltd.co.jp
http://www.neltd.co.jp/index_eng.html