pynoddy is a python package to write, change, and analyse kinematic geological modelling simulations performed with Noddy (see below for more infomration on Noddy).
At this stage, pynoddy provides wrapper modules for existing Noddy history (.his) and result files (.g00, etc.). It is
To install pynoddy simply run:
python setup.py install
Note:
- sufficient privileges are required (i.e. run in sudo with MacOSX/ Linux and set permissions on Windows)
Important: the Noddy executable has to be in a directory defined in the PATH variable!!
Important: the topology executable has to be in a directory defined in the PATH variable!!
A tutorial starting with simple examples for changing the geological history and visualisation of output, as well as the implementation of stochastic simulations and uncertainty visualisation are available as interactive ipython notebooks.
pynoddy depends on several standard Python packages that should be shipped with any standard distribution (and are easy to install, otherwise):
. numpy . matplotlib . pickle
The uncertainty anaysis, quantification, and visualisation methods based on information theory are implemented in the python package pygeoinfo. This package is available on github and part of the python package index. It is automatically installed with the setup script provided with this package. For more information, please see:
(todo: include package info!)
In addition, to export model results for full 3-D visualisation with VTK, the pyevtk package is used, available on bitbucket:
https://bitbucket.org/pauloh/pyevtk/src/9c19e3a54d1e?at=v0.1.0
The package is automatically downloaded and installed when running python setup.py install.
pynoddy is free software and published under a MIT license (see license file included in the repository). Please attribute the work when you use it, feel free to change and adapt it otherwise!
Noddy itself is a kinematic modelling program written by Mark Jessell [1][2] to simulate the effect of subsequent geological events (folding, unconformities, faulting, etc.) on a primary sedimentary pile. A typical example would be:
- Create a sedimentary pile with defined thicknesses for multiple formations
- Add a folding event (for example simple sinoidal folding, but complex methods are possible!)
- Add an unconformity and, above it, a new stratigraphy
- Finally, add a sequence of late faults affecting the entire system.
The result could look something like this:
.. image:: docs/pics/noddy_block_example.png
The software runs on Windows only, but the source files (written in C) are available for download to generate a command line version of the modelling step alone:
https://github.com/flohorovicic/pynoddy
It has been tested and compiled on MacOSX, Windows and Linux.
[1] Mark W. Jessell. Noddy, an interactive map creation package. Unpublished MSc Thesis, University of London. 1981. [2] Mark W. Jessell, Rick K. Valenta, Structural geophysics: Integrated structural and geophysical modelling, In: Declan G. De Paor, Editor(s), Computer Methods in the Geosciences, Pergamon, 1996, Volume 15, Pages 303-324, ISSN 1874-561X, ISBN 9780080424309, http://dx.doi.org/10.1016/S1874-561X(96)80027-7.