Scientist friendly Python toolbox for processing 2D satellite Earth observation data.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs Issue325 mock missing install nansat readme (#340) Jul 16, 2018
nansat
nansat_integration_tests
provisioning
utilities
.gitignore #365: Added provisioning/site.retry to ignore list Sep 14, 2018
.travis.yml merge master into develop Jul 18, 2018
LICENSE
MANIFEST.in Added manifest file Jan 29, 2018
README.rst Issue325 mock missing install nansat readme (#340) Jul 16, 2018
Vagrantfile #351 fix and close (again) Jul 18, 2018
appveyor.yml #380 appveyor: pin pyproj Sep 19, 2018
readthedocs.yml #116: trying to set up environment for compiling jupyter notebookd on… Jan 22, 2018
setup.py Update setup.py Aug 10, 2018

README.rst

Build Status AppVeyor Status Coverage Status DOI

https://www.nersc.no/sites/www.nersc.no/files/images/nansat_logo_transp.png

Nansat is a scientist friendly Python toolbox for processing 2D satellite earth observation data.

The main goal of Nansat is to facilitate:

  • easy development and testing of scientific algorithms,
  • easy analysis of geospatial data, and
  • efficient operational processing.

You can find a detailed description of Nansat in our paper published in Journal of Open Research Software in 2016.

... and you can join the mailing list.

We appreciate acknowledgments of Nansat. Please add a reference to the following paper if you use Nansat in scientific publications:

Korosov A.A., Hansen M.W., Dagestad K.-F., Yamakawa A., Vines A., Riechert M., (2016). Nansat: a Scientist-Orientated Python Package for Geospatial Data Processing. Journal of Open Research Software. 4(1), p.e39. DOI: http://doi.org/10.5334/jors.120

Documentation

You will find complete documentation for Nansat at Read the Docs.

Contributing

You will find information about contributing to Nansat at Read the Docs.

Installation

The easiest way to install Nansat on any platform is to use Anaconda (download installer).

# install Nansat and requirements from the conda-forge channel
conda create -n py3nansat -c conda-forge nansat

Activate and work in the nansat environment

# download a test file
wget https://github.com/nansencenter/nansat/raw/develop/nansat/tests/data/stere.tif

# activate the py3nansat environment
source activate py3nansat

# start python and work with Nansat
python
# import main file opener
from nansat import Nansat

# open a test file
n = Nansat('stere.tif')

# see file content
print n

# view file footpring
n.write_map('stere.footpring.png')

# create RGB with auto-stretched histogram
n.write_figure('stere_rgb.png', [1,2,3], clim='hist')

Tests

Nansat is outfitted with unittests, which you can use to ensure that all functionality works on your platform.

# install testing packages from conda-forge
conda install -c conda-forge nose mock

# run nansat.tests
nosetests nansat

# Run all tests including nansat_integration_tests with coverage
cd <nansat_repository_folder>
nosetests -w . --with-coverage --cover-package=nansat

Fore more information see Read the Docs or notebooks for Nansat lectures

License

The project is licensed under the GNU general public license version 3.

Acknowledgments

Development is supported by the Research Council of Norway as a part of NORMAP project (grant no. 195397/V30).