README.md

Creating a python development environment for this module

# create a goesr environment (only needs to happen once)
conda create -n goesr python=3.6 anaconda netcdf4 pyproj jupyter ipython

# set current shell environment to use goesr python environment (once per shell)
source activate goesr
# fix hdf4 dependency of netcdf4 (only needed once)
conda install jpeg=8d

# clone git repository (alternately, can download zipfile or tar file directly from https://gitlab.ssec.wisc.edu/rayg/goesr)
git clone https://gitlab.ssec.wisc.edu/rayg/goesr.git

# install goesr module into goesr python environment in a development mode, allowing source editing
cd goesr
python setup.py develop

# test that the module can import
cd ..
python -c 'import goesr.l1b'

# you can use the python executable in the environment directly if you have specific scripts,
# e.g. start python script with #!/home/myuser/anaconda/envs/goesr/bin/python in linux or macos
which python

# start up ipython
ipython

Building the Conda Package

# add the conda-forge channel (done once)
conda config --add channels conda-forge

# build the conda package and place things in dist/
conda build conda-recipe --output-folder dist

# copy the output to a Conda channel host
cp dist/<platform>/*.bz2 /path/to/channel/<platform>/
# add the package to the channel index
conda index /path/to/channel/<platform>/

Installing the Conda Package (no development)

# specify the appropriate channel to install the package in either the
# 'create' command
conda create -n goesr -c http://larch.ssec.wisc.edu/channels/sift python=3.6 goesr
# or 'install' command
conda install -c http://larch.ssec.wisc.edu/channels/sift goesr

# to update the package
conda update -c http://larch.ssec.wisc.edu/channels/sift goesr