20.

Batch Jobs
User Guide

Rock Flow Dynamics

April 2020
 20.1

Copyright Notice
Rock Flow Dynamics r (RFD), 2004–2020. All rights reserved. This document is the intel-
lectual property of RFD. It is not allowed to copy this document, to store it in an information
retrieval system, distribute, translate and retransmit in any form or by any means, electronic
or mechanical, in whole or in part, without the prior written consent of RFD.

Trade Mark
RFD, the RFD logotype and tNavigator r product, and other words or symbols used to identify
the products and services described herein are trademarks, trade names or service marks of
RFD. It is not allowed to imitate, use, copy trademarks, in whole or in part, without the prior
written consent of the RFD. Graphical design, icons and other elements of design may be
trademarks and/or trade names of RFD and are not allowed to use, copy or imitate, in whole
or in part, without the prior written consent of the RFD. Other company, product, and service
names are the properties of their respective owners.

Security Notice
The software’s specifications suggested by RFD are recommendations and do not limit the
configurations that may be used to operate the software. It is recommended to operate the
software in a secure environment whether such software is operated on a single system or
across a network. The Licensee is responsible for configuring and maintaining networks and/or
system(s) in a secure manner. If you have any questions about security requirements for the
software, please contact your local RFD representative.

Disclaimer
The information contained in this document is subject to change without notice and should
not be construed as a commitment by RFD. RFD assumes no responsibility for any error that
may appear in this manual. Some states or jurisdictions do not allow disclaimer of expressed
or implied warranties in certain transactions; therefore, this statement may not apply to you.
Since the software, which is described in the present document is constantly improved, you
may find descriptions based on previous versions of the software.

2
 20.1

Contents
1. Introduction 4

2. General description 5

3. Using queue 5
3.1. Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.1.1. Top toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.1.2. Main menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.1.3. Context menu of model in the list . . . . . . . . . . . . . . . . . . . . . 8
3.2. Adding tasks to the queue . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.3. Monitoring results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

CONTENTS 3
 20.1

1. Introduction
In this document there is a description of Batch Jobs Manager that can be used to calculate
models on workstations and clusters.
Batch Jobs Manager (Model Queue) is fully integrated with simulation modules (Black
Oil simulator, Compositional simulator, Thermal simulator).
tNavigator User Manual contains the description of physical model, mathematical model
and the keywords that can be used in dynamic model.
tNavigator is a software package, offered as a single executable, which allows to build
static and dynamic reservoir models, run dynamic simulations, perform extended uncertainty
analysis and build surface network as a part of one integrated workflow. All the parts of the
workflow share common proprietary internal data storage system, super-scalable parallel nu-
merical engine, data input/output mechanism and graphical user interface. tNavigator supports
METRIC, LAB, FIELD units systems.
tNavigator is a multi-platform software application written in C++ and can be installed on
Linux, Windows 64-bit OS and run on systems with shared and distributed memory layout
as a console or GUI (local or remote) based application. tNavigator runs on workstations and
clusters. Cloud based solution with full GUI capabilities via remote desktop is also available.
tNavigator contains the following 8 functional modules licensed separately:

• Geology Designer (includes PVT Designer and Well Designer);

• Model Designer (includes PVT Designer and Well Designer);

• Network Designer (includes PVT Designer and Well Designer);

• Black Oil simulator;

• Compositional simulator;

• Thermal simulator;

• Assisted History Matching (AHM, optimization and uncertainty analysis);

• Graphical User Interface.

1. Introduction 4
 20.1

2. General description
There is a possibility to put models in the queue for successive calculation. Calculation of
these models will be started automatically by default.
To create a new queue:
1. Select Modeling → Batch Jobs → New Queue in tNavigator main window.

2. Select where models will be calculated: on local host or on cluster.

3. Enter queue file name and save it.

4. Calculation Options Window will be opened. Specify settings and press OK.

3. Using queue
The Queue manager window is divided into two tabs.
The Calculations tab contains the list of models to calculate; they will be calculated in
the order you see. Besides model names, another information about models is visualized in
columns. In Info Columns section of settings one can set list of columns to visualize. For
adding models to the list, see Adding tasks to the queue.
The Results tab contains the list of calculation results, see Monitoring results.

3.1. Interface
3.1.1. Top toolbar
Top toolbar contains the following interface elements:

• Add Jobs
Specify model (job) to calculate in the queue. The name of the added model will be
visualized in the queue window.

• New Customized Job

Specify model (job) to calculate in the queue and specify calculation options for it. The
name of the added model will be visualized in the queue window.

• Load Summary
Load results of calculated models. Results will be visualized in the Results tab.

• Simultaneously Calculated Models (only on a local computer)

Maximum number of models that will start calculating simultaneously.

• Max Models In Cluster Queue (only on a cluster)

Maximum number of models that may be put to the cluster queue by the current user
simultaneously.

2. General description 5
 20.1

3.1.2. Main menu

Main menu at the top of the window contains the following items:

1. Menu Document.

• Add Jobs
See Top toolbar.
• New Customized Job
See Top toolbar.
• Queue Models From Folder
Specify folder with models to put them in the queue for calculation. Names of all
added models will be visualized in the queue window.
• Load Summary
See Top toolbar.
• Load Summary From Folder
Specify folder which contains calculated models results to load.
• Close
Close queue window.

2. Menu Calculations.

• Run Jobs
Run calculation of marked model. If you need to calculate several models in the
queue, mark them all and press Run Jobs.
• Pause Jobs (only on a local computer)
Pause calculations of models.
• Stop Jobs
Stop calculations of models.
• Rerun Jobs
Start calculation of models again. Results of previous run will be erased.
• Kill Jobs
Delete model(-s) from queue.
• View Results
View results of the model during simulation, including graphs and grid properties.
In this mode the results can’t be changed, deleted, or recalculated.
• View Graphs
View just the graphs during simulation.
In this mode the results can’t be changed, deleted, or recalculated. Also, in this
mode functions which use grid are unavailable. For example:

3.1.2. Main menu 6

 20.1

• visualization of grid properties is not available;

• the following graphs are not available: Flow between FIPs, Block Info, Well
Profile, Well Section;
• some results data can’t be saved as binary files (grid properties, connection
data).
• View Log
View log file of the model during simulation.
• Move Up / Move Down (only on a local computer)
Move the model up/down in queue.
• Mark as Calculated
Mark the model as calculated. This option can only be applied to models with
status Not calculating.
• Try to Find Results
tNavigator will look for RESULTS folder which contains results of model run in
folder of its .data file. Then it will try to load files in it as a result of calculation.
• Select/Unselect All
Mark or unmark all models in queue.
• Auto Run New Jobs
Automatically start model calculation after adding it in queue.
• Show/Hide Finished
In Calculations tab all models with status Calculated will be shown. If this button
is unpressed then calculated models will be shown in Results tab only.
3. Settings. Menu Settings has only one item Options:
3.1. General.
• Time Limit for Jobs Shutting Down Too Slow. Maximal duration of one of
calculation model stages – shutting down. If this limit is exceeded, then this
stage would be stopped; calculation of the next model will be started.
• Simultaneously Calculated Models.
3.2. New Job Options. Default settings for the new jobs. For the full list see Adding
tasks to the queue, step 4.
3.3. New Job Options (Advanced). Default advanced settings for the new jobs. For
the full list see Adding tasks to the queue, step 5.
3.4. Common Email Settings. tNavigator provides the possibility to receive emails
about progress of calculation of models in the queue. You should set the following

!
parameters to use it:

Only local SMTP servers without authorization are supported.

3.1.2. Main menu 7

 20.1

• Local SMTP-server.
Local server of outcoming emails.
• Server port.
Port of local server of outcoming emails.
• Sender Address.
Sender’s email address.
• Receiver Address.
Receiver’s email address.
• Delay.
Different notifications will be sent in one email message if they come more
frequent than specified delay.
• Send Test Email.
Send test email from sender’s address to receiver’s address.
3.5. Current Window Email Settings.
• Send email notification when job is completed
Send email to receiver’s address when job calculation is completed.
• Send email on calculation progress each...
Each number of percents of calculation model email about run progress will
be sent.
3.6. Power Saving (only on a local computer).
• Shut down computer when all jobs will be finished.
• Close tNavigator when all jobs will be finished.
3.7. Queue Auto Selection (only on a cluster).
Allows the selection of a cluster queue to which the new jobs will be put by
default.
3.8. Appearance.
• Place Job Action Buttons to the Left/Right From Job List.
• Use Text/Icon Buttons.
• Show/Hide Log.
• Show Queue Load (only on a cluster).
3.9. Calculations Page Columns. Select columns to visualize in queue window.
4. Help. Opens the tNavigator manuals library.
Right toolbar buttons duplicate the items of menus Queue and Settings which are de-
scribed above.

3.1.3. Context menu of model in the list

For each model the context menu is available. It can be called via right-clicking on model
name. Dependent on model status, this menu may contain the following items (mostly dupli-
cating the equivalent positions under Queue in the top menu):

3.1.3. Context menu of model in the list 8

 20.1

1. View Results.

2. View Graphs.

3. View Log.

4. Open model. Model will be opened in tNavigator.

5. Edit Calculation Options. Set new Job Calculation Setting for this model.

6. Rerun Job.

7. Kill Job.

Figure 1. Queue. Context menu of the model

3.2. Adding tasks to the queue

To add tasks to the queue:

1. In tNavigator main window, click Batch Jobs → Open. The Queue Manager window
will pop up (see figure 2).

2. Click Add Jobs to add a new task. Alternatively, click New Customized Job
to add a new task and specify custom options for it.

3. Browse to the model *.data file and click Open.

4. Enter the calculation parameters:

3.2. Adding tasks to the queue 9

 20.1

Figure 2. Setting up job

• Node Count (only on a cluster)

How many cluster nodes to use.
• Queue Name (only on a cluster)
Queue for putting the task to (there may be multiple queues with different priori-
ties).
• Core Count (only on a local computer)
The number of CPU cores which are used to calculate model. You can select one
of suggested variants (1, 2, 4, Max System Threads, i.e. all CPU cores will be
used) or set any number.
• Physical model Type
Type of physical model (Blackoil, compositional).
• Write Results
Which tNavigator calculation results to write: Write All, Write Wells (in GUI you
will see only graphs, no grid properties), or Do not write.

3.2. Adding tasks to the queue 10

 20.1

• Dump UNRST/UNSMRY Binaries

Which UNRST/UNSMRY binary files to write:
◦ Do not write
◦ Write Summary (SMSPEC, .UNSMRY files)
◦ Write All (.EGRID, .INIT, .UNSMRY, .UNRST, .SMSPEC files).
• Dump RSM file
Turn on the saving of a text report file in RSM format.
• Dump OFM file
Turn on the saving of a text report file in OFM format.
• UNRST/UNSMRY Binaries Folder
Where to put the UNRST/UNSMRY binary files, with the following options: RE-
SULTS folder or the folder with the model .data) file. Available if the saving of
at least one among UNRST/UNSMRY, RSM, OFM is switched on.
• Time Limit for Calculation
Maximum calculation time. If a job runs longer than that, it will be forcibly
stopped.
• Delay calculation until
Provides an option to postpone the start of calculation until the desired date.

5. If necessary, enter the advanced parameters:

• Use GPU
Use graphical processor. If checked, enables the numeric input GPU count.
• Dump Last Calculated Step
This is done so that a failed computation could be continued smoothly.
• Continue from Last Calculated Step/Continue Calculations From Step.
Specify time step number from which calculation will be continued. This option is
only enabled if Write Results is set to Write All.
• Writing Maps Timesteps.
Specify time steps on which grid properties will be saved, overriding the settings
made within the model itself. The possible options are:
• First and two last;
• Annually;
• Monthly;
• On all steps;
• As in RPTMAPD/RPTGRAPHD;
• As in RPTRST.
The detailed description of options for selective recording of calculation results is
given in the section 9.1 of tNavigator User Manual.

3.2. Adding tasks to the queue 11

 20.1

• Writing Graphs Timesteps.

Same as above, only for graphs.
• Override Default Thread Count (only on a cluster)
Set the number of threads for parallel calculation.
• Use Custom Version (only on a cluster)
Choose tNavigator version among the accessible versions installed on the cluster.
• License Wait Time Limit
If there is no license of required type, tNavigator will wait for that long before
dropping the task.
• Additional Custom Options
Additional command line options passed to the simulator upon launching the cal-
culation.

! It is recommended to minimize the usage of the latter option. All settings

that are normally required can and should be made via GUI.

6. Click OK.

3.3. Monitoring results

In this tab results of calculation are represented. For each model values of some parameters
are shown. For each parameter the following data is available:

• Calculated value;

• Historical value. If it doesn’t exist, then 0 is shown;

• Relative mismatch between calculated and historical values;

• Absolute mismatch between calculated and historical values.

There is a time slider above the table. As the slider is moved, the table is updated to
display parameter values for the corresponding time step.

3.3. Monitoring results 12

 20.1

Figure 3. Queue. Results

3.3. Monitoring results 13

 Rock Flow Dynamics

Phone: +1 713-337-4450
Fax: +1 713-337-4454
Address: 2200 Post Oak Boulevard, STE 1260, Houston, TX 77056
E-mail: tnavigator@rfdyn.com
Web: http://rfdyn.com

To locate the office nearest to you, please visit https://rfdyn.com/contact/

© Rock Flow Dynamics. All rights reserved. 30.04.2020