Skip to content

Commit

Permalink
Update README
Browse files Browse the repository at this point in the history
  • Loading branch information
mferrera committed Nov 28, 2023
1 parent 20a5c3b commit 484be8a
Showing 1 changed file with 38 additions and 14 deletions.
52 changes: 38 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,51 @@
# fmu-config

![fmu-config](https://github.com/equinor/fmu-config/workflows/fmu-config/badge.svg)
![Python Version](https://img.shields.io/badge/python-3.8%20|%203.9%20|%203.10%20|%203.11%20|%203.12-blue.svg)
[![License: LGPL v3](https://img.shields.io/github/license/equinor/fmu-tools)](https://www.gnu.org/licenses/lgpl-3.0)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![PyPI](https://img.shields.io/pypi/v/fmu-config.svg)](https://pypi.org/project/fmu-config/)

FMU config is a small Python library to facilitate configuration of global
variables in Equinor's Fast Model Update (FMU) setup.

# The script library fmu.config #
## Installation

```sh
pip install fmu-config
```

FMU config is a small LGPL'ed licensed Python library to facilitate a configuration of global variables in Equinor's FMU setup.
## Usage

```sh
fmuconfig global_config.yml
```

The idea is that there is one global config file that will be the "mother"
of all other files, such as:

* global_variables.ipl (IPL file to run from RMS)
* global_variables.ipl.tmpl (Templated IPL version; [ERT](https://github.com/equinor/ert) will fill
in <> variables)
* global_variables.yml (working YAML file, with numbers)
* global_variables.yml.tmpl (templated YAML file, with <...> instead of
numbers; for ERT to process)
* Various eclipse file stubs (both "working" and template versions)
* Working and templated files for other tools/scrips
- `global_variables.ipl`: IPL file to run from RMS
- `global_variables.ipl.tmpl`: Templated IPL version where
[ERT](https://github.com/equinor/ert) will fill in `<>` variables
- `global_variables.yml`: working YAML file, with numbers
- `global_variables.yml.tmpl`: templated YAML file, with `<...>` instead of
numbers; for ERT to process
- Various eclipse file stubs (both "working" and template versions)
- Working and templated files for other tools/scripts

The global_config file shall be in YAML format, with extension ``.yml``
The global_config file shall be in YAML format, with extension `.yml`

For the FMU users, the front end script to run is ``fmuconfig``
To run this package against the global configuration file, just run

This software is released under LGPLv3.
## Documentation

Copyright 2018-2020 Equinor ASA.
The documentation is location at
https://equinor.github.io/fmu-config/

## Contributing

See the [Contributing](CONTRIBUTING.md) document.

## License

This software is released under LGPLv3.

0 comments on commit 484be8a

Please sign in to comment.