Fortran 90 namelist parser
=========================================================
A Python module and command line tool for parsing Fortran namelist files
.. image:: https://travis-ci.org/marshallward/f90nml.svg?branch=master :target: https://travis-ci.org/marshallward/f90nml
.. image:: https://ci.appveyor.com/api/projects/status/bcugyoqxiyyvemy8?svg=true :target: https://ci.appveyor.com/project/marshallward/f90nml
.. image:: https://coveralls.io/repos/marshallward/f90nml/badge.svg?branch=master :target: https://coveralls.io/r/marshallward/f90nml?branch=master
.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.1112518.svg :target: https://doi.org/10.5281/zenodo.1112518
Documentation: http://f90nml.readthedocs.org/en/latest/
f90nml is a Python module and command line tool that provides a simple
interface for the reading, writing, and modifying Fortran namelist files.
A namelist file is parsed and converted into an Namelist object, which
behaves like a standard Python dict. Values are converted from Fortran
data types to equivalent primitive Python types.
The command line tool f90nml can be used to modify individual values inside
of a shell environment. It can also be used to convert the data between
namelists and other configuration formats. JSON and YAML formats are currently
supported.
To read a namelist file sample.nml which contains the following namelists:
.. code-block:: fortran
&confignml input = 'wind.nc' steps = 864 layout = 8, 16 visc = 1.0e-4 usebiharmonic = .false. /
we would use the following script:
.. code:: python
import f90nml nml = f90nml.read('sample.nml')
which would would point nml to the following dict:
.. code:: python
nml = { 'confignml': { 'input': 'wind.nc', 'steps': 864, 'layout': [8, 16], 'visc': 0.0001, 'usebiharmonic': False } }
File objects can also be used as inputs:
.. code:: python
with open('sample.nml') as nmlfile: nml = f90nml.read(nmlfile)
To modify one of the values, say steps, and save the output, just
manipulate the nml contents and write to disk using the write function:
.. code:: python
nml['confignml']['steps'] = 432 nml.write('newsample.nml')
Namelists can also be saved to file objects:
.. code:: python
with open('target.nml') as nmlfile: nml.write(nmlfile)
To modify a namelist but preserve its comments and formatting, create a
namelist patch and apply it to a target file using the patch function:
.. code:: python
patchnml = {'confignml': {'visc': 1e-6}} f90nml.patch('sample.nml', patchnml, 'newsample.nml')
A command line tool is provided to manipulate namelist files within the shell:
.. code:: sh
$ f90nml config.nml -g config_nml -v steps=432
.. code-block:: fortran
&confignml input = 'wind.nc' steps = 432 layout = 8, 16 visc = 1.0e-4 usebiharmonic = .false. /
See the documentation for details.
f90nml is available on PyPI and can be installed via pip::
$ pip install f90nml
It is also available on Arch Linux via the AUR::
$ git clone https://aur.archlinux.org/python-f90nml.git $ cd python-f90nml $ makepkg -sri
f90nml is currently not available on other Linux distributions.
The latest version of f90nml can be installed from source::
$ git clone https://github.com/marshallward/f90nml.git $ cd f90nml $ python setup.py install
Users without install privileges can append the --user flag to
setup.py::
$ python setup.py install --user
