Installation
Installation instructions for nc5ng-python
System Installation
nc5ng
offers common installation options for python distributions
Note
It is recommended to use a python virtual environment (virtualenv
) to install this package and dependencies.
Installing directly to a system python distribution can break certain system packages.
Requirements
- Python 3.x
-
pip
andvirtualenv
(Recommended) - Fortran (
gfortran
) - GMT (4.x-6.x)
- GMT/Python (Optional) - GMT6.0 Required for ``GMT/Python``(Development Release Only)
Python Package Index
Released versions of nc5ng
can be installed directly from the PyPi by using pip
pip install nc5ng
Specific versions can be installed by specifying nc5ng==VERSION
Development Versions
pip
can be used to install development versions of python packages by
specifying the git repository, including branch or commit
pip install -U git+git://github.com/nc5ng/nc5ng-python@stable pip install -U git+git://github.com/nc5ng/nc5ng-python@8f482ba1ce6484ab18e6ccd88d6e251655cd61f2
Local Copies can be installed in editable mode for development
git clone git@github.com/nc5ng/nc5ng-python pip install -U -e ./nc5ng-python
Docker Deployment
Docker images are provided to use nc5ng through container virtualization.
Pre-configured images are available from the nc5ng-docker project (Dockerhub), and base images with gmt tools are available from the gmt-docker project (Dockerhub).
For convenience, the docker image nc5ng/nc5ng
contains a pre-compiled conversion for testing.
For more information on deployment and use please see the docker project pages.
Requirements
docker
docker-compose
(Optional)
Install Conversion Data
Raw Source data is provided directly from the nc5ng-core package. However conversion data must either be built or downloaded seperately.
Conversion data are released publically on the nadcon5-ng github or upstream via National Geodetic Survey. For compilation please see the source library docs , project homepage, and github
Conversion data can be placed anywhere and is referenced by configration arguments used to load data.