Package: veranda
verandaDescriptionverandastands for"vector and raster data access"and is a place for IO related classes and operations dealing
with raster and vector data. Besides bridging the gap between rigid and complex packages like GDAL to increase
user-friendliness and flexibility (similar torasterio) it defines common ground to unite the world of raster and
vector data and harmonise the entry point to access different data formats or multiple files.verandaconsist of two modulesrasterandvectoreach containing the submodulesnativeandmosaic.nativecontains several classes for interacting with one file/data format, e.g. GeoTIFF or NetCDF. On the other hand, themosaicmodule offers a datacube-like interface to work with multiple, structured files, which can be distributed based on a
mosaic/grid in space or along a stack dimension, e.g. time, atmospheric layers, etc.For further details we recommend to look atveranda's documentation or tests.InstallationThe package can be either installed via pip or if you want to contribute, we recommend to
install it as a conda environment.pipTo installverandavia pip in your own environment, use:pip install verandaATTENTION: GDAL needs more OS support and has more dependencies then other packages and can therefore not be installed solely via pip.
Please have a look athttps://pypi.org/project/GDAL/what requirements are needed. Thus, for a fresh setup, an existing environment
with working a GDAL installation is expected.condaThe packages also comes along with one conda environmentconda_environment.yml.
This is especially recommended if you want to contribute to the project.
The following script will install miniconda and setup the environment on a UNIX
like system. Miniconda will be installed into$HOME/miniconda.wget http://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh -O miniconda.sh
bash miniconda.sh -b -p $HOME/miniconda
export PATH="$HOME/miniconda/bin:$PATH"
conda env create -f conda_environment.yml
source activate verandaThis script adds$HOME/miniconda/bintemporarily to thePATHto do this
permanently addexport PATH="$HOME/miniconda/bin:$PATH"to your.bashrcor.zshrc.For Windows, use the following setup:Download the latestminiconda 3 installerfor WindowsClick on.exefile and complete the installation.Add the foldercondabinfolder to your environment variablePATH.
You can find thecondabinfolder usually under:C:\Users\username\AppData\Local\Continuum\miniconda3\condabinFinally, you can set up the conda environment via:conda env create -f conda_environment.yml
source activate verandaAfter that you should be able to runpython setup.py testto run the test suite.ContributionWe are happy if you want to contribute. Please raise an issue explaining what
is missing or if you find a bug. We will also gladly accept pull requests
against our master branch for new features or bug fixes.
If you want to contribute please follow these steps:Fork theverandarepository to your accountClone theverandarepositoryMake a new feature branch from theverandamaster branchAdd your featurePlease include tests for your contributions in one of the test directories.
We usepy.testso a simple function calledtest_my_featureis enoughSubmit a pull request to our master branchOutlookThe next major release will contain significant support for vector data including IO for SHP and LASZ files.
In addition therastermodule will be extended to allow for accessing ZARR or HDF data for performant time series queries.CitationIf you use this software in a publication then please cite it using the Zenodo DOI.NoteThis project has been set up using PyScaffold 3.2.2. For details and usage
information on PyScaffold seehttps://pyscaffold.org/.