Update, 2024-05-22: Deprecated

This repository has been has moved to a different hosting platform and is no longer being actively maintained. Please see https://code.usgs.gov/WiM/wimlib (USGS internal access may be required) for latest updates related to this effort.

WIMLib

WIMLib is a custom reusable libraries and objects for handling geojson, logging, and spatial operations leveraging ESRI ArGIS.

Installing

python WIMLib package: pip install WIMLib

Updating package from pypi

pip install WIMLib--upgrade

Updating Library

for more information see packing-project tutorial Build distribution file and store in dist folder python setup.py sdist bdist_wheel upload to pypi twine upload dist/*

Prerequisites

ArcGIS 10.x

• You will be using ESRI's ArcGIS ArcPy library for geoprocessing. If you have not installed ArcGIS before, you can skip to the next section.
• If you already have ArcGIS installed on your machine, then you might need to reinstall it. If you are reinstalling, delete C:\Python27 and C:\Program Files (x86)\ArcGIS to remove the files from your machine. Once that is done, download ArGIS from your favorite repository or have an IT administrator add it to your machine. During installation, if you are prompted to overwrite a file, choose the option to overwrite as it will help you clean up your installation (i.e. miscellaneous parts that ESRI has a tendency of leaving out and about on your computer).
• Following installation, verify that you have Python up and working correctly. Open ArcMap or ArcCatalog to verify the installation worked as expected.

Set Python as a System Variable

• Go to the Start Menu
• Right click on Computer
• Select Properties
• Select Advanced Systems Settings
• Click Environment Variables
• Under System Variables, find Path and press Edit
• Add C:\Python27\ArcGIS10.3 or whatever your relevant path is.
• Click OK
• Click OK, again
• Open the Command Prompt and type python which should turn your Command Prompt into a Python Command Prompt allowing you to use Python commands. It is useful to also obtain the version using python --version from the command line. If you're using ArcGIS 10.3.1 you should have Python 2.7.8.

Pip and Related Packages

• Go here, open the get-pip.py file and save it to your computer. Personally, I open a copy of Notepad++ and save the file.
• Open the Command Prompt, navigate to where get-pip.py is and execute the command python get-pip.py this will download and install Pip.
• Install requests, cirtifi, and virtualenv by executing pip install requests pip install cirtifi pip install virtualenv

netCDF

• For Windows

• Download and install HD5 1.8.18 from [here] (https://support.hdfgroup.org/HDF5/).

• Make an environmental variable HDF5_DIR that's value is the installation directory of HDF5.

• Download and install netCDF 4.4.1.1 from [here] (https://www.unidata.ucar.edu/downloads/netcdf/index.jsp

• Make an environmental variable NETCDF4_DIR that's value is the installation directory of netCDF4.

• Download and pip install the appropriate netCDF4 wheel file from [here] (http://www.lfd.uci.edu/~gohlke/pythonlibs/)

• For Linux

• Use the distribution's respective package manager to install HDF5 and netCDF4. Then use pip to install netCDF4 for Python.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Installing

https://help.github.com/articles/cloning-a-repository/

Built With

• python 2.7

Contributing

Please read CONTRIBUTING.md for details on the process for submitting pull requests to us. Please read CODE_OF_CONDUCT.md for details on adhering by the USGS Code of Scientific Conduct.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Advance the version when adding features, fixing bugs or making minor enhancement. Follow semver principles. To add tag in git, type git tag v{major}.{minor}.{patch}. Example: git tag v2.0.5

To push tags to remote origin: git push origin --tags

*Note that your alias for the remote origin may differ.

Authors

• Jeremy Newson - Lead Developer - USGS Web Informatics & Mapping

See also the list of contributors who participated in this project.

License

This project is licensed under the Creative Commons CC0 1.0 Universal License - see the LICENSE.md file for details

Suggested Citation

In the spirit of open source, please cite any re-use of the source code stored in this repository. Below is the suggested citation:

This project contains code produced by the Web Informatics and Mapping (WIM) team at the United States Geological Survey (USGS). As a work of the United States Government, this project is in the public domain within the United States. https://wim.usgs.gov

Acknowledgments

Henry Walshaw (om-henners/geojson_handler.py)

About WIM

• This project authored by the USGS WIM team
• WIM is a team of developers and technologists who build and manage tools, software, web services, and databases to support USGS science and other federal government cooperators.
• WiM is a part of the Upper Midwest Water Science Center.