Getting started

To get started you need to initialize FMU Settings for your project.

Initialize FMU Settings

Initialization from the terminal - Recommended!

To initialize FMU Settings you must be in your FMU project root, meaning within a revision directory of your model. This directory should contain a subdirectory called ert.

Example of a how a standard project path could look like: project/asset/resmod/ff/25.0.0

In this example the 25.0.0 folder is the revision folder and the FMU project root, and initialization should be run from within this revision folder. FMU Settings will verify that the project folder contains a subfolder named ert to identify your project as a FMU project.

1. Go to the project root:

cd  project/asset/resmod/ff/25.0.0

2. From here, run the command:

fmu init

You have now initialized FMU Settings.

Important:

For early onboarders to SUMO, that already have masterdata in the global config before initialization of FMU Settings:

The initialization triggers FMU Settings to look for an existing global config file at the standard location: fmuconfig/output/global_variables.yml. If a valid configuration is found here, FMU Settings will import the sections masterdata, model and access, so that you will not have to configure everything again.

NB! Stratigraphy is not imported. Stratigraphy data must be configured directly in the GUI. When configuration of the stratigraphy is completed in the FMU Settings GUI, these sections should be deleted from the global config yaml file.

3. Open FMU Settings:

fmu settings

Initialization from the GUI

Initialization of a project can also be done from the FMU Settings GUI.

1. Start the FMU Settings application:

fmu settings

2. Open the project selector:

   • from the start page by clicking Select project

   • or from Project > Overview by clicking the project select/change button

3. Enter the project path in the text field.

4. If the project is not yet initialized, FMU Settings asks if you want to initialize it.

5. The same initialization rules apply here as when running fmu init in the terminal:

   • the project folder must contain a subfolder ert

   • valid global config is searched for in fmuconfig/output/global_variables.yml

   • valid global config is also searched for in files matching global*.yml under fmuconfig/input/

   • available masterdata, model, and access are imported automatically

6. Confirm, and the FMU Settings application will initialize and open the project.

How to open FMU Settings when your project is already initialized

1. Go to the project root (revision folder):

cd project/asset/resmod/ff/25.0.0

2. Run:

fmu settings

NB: FMU Settings can be opened from anywhere in your project folder hierarchy by running the command fmu settings. FMU Settings will in that case automatically detect the nearest project. Inside the FMU Settings GUI you will be able to open a project either from the list of recent projects or by entering the project path manually.

Once the FMU Settings project is open, continue with the GUI user guide.