An interface to web services based on ArcGIS RESTful, WFS, and WMS.
Project description
Features
PyGeoOGC is a part of the Hydrodata suite that offer interfaces to web services that are based on ArcGIS RESTful, WMS, and WFS.
You can try using PyGeoOGC without installing it by clicking on the binder badge below the PyGeoOGC banner. A Jupyter notebook instance with Hydrodata and PyGeoOGC installed, will be launched in yout web browser and you can start coding!
Moreover, requests functionalities can be submitted via issue tracker.
Installation
You can install PyGeoOGC using pip:
$ pip install pygeoogcQuickstart
We can access Watershed Boundary Dataset via RESTful service, 3D Eleveation Program from WMS, and FEMA National Flood Hazard Layer via WFS. The output fo these functions are of type requests.Response that can be converted to GeoDataFrame or xarray.Dataset using Hydrodata.
from pygeoogc import ArcGISREST, WFS, wms_bybox, MatchCRS
from hydrodata import Station, utils
la_wshed = Station('11092450')
wbd8 = ArcGISRESTful(base_url="https://hydro.nationalmap.gov/arcgis/rest/services/wbd/MapServer/4")
wbd8.get_featureids(la_wshed.geometry)
resp = wbd8.get_features()
_huc8 = utils.json_togeodf(resp[0])
huc8 = _huc8.append([utils.json_togeodf(r) for r in resp[1:]])
url_wms = "https://www.fws.gov/wetlands/arcgis/services/Wetlands_Raster/ImageServer/WMSServer"
layer = "0"
r_dict = wms_bybox(
url_wms,
layer,
la_wshed.geometry.bounds,
1e3,
"image/tiff",
box_crs="epsg:4326",
crs="epsg:3857",
)
geom = MatchCRS.geometry(la_wshed.geometry, "epsg:4326", "epsg:3857")
wetlands = utils.wms_toxarray(r_dict, geom, "epsg:3857")
url_wfs = "https://hazards.fema.gov/gis/nfhl/services/public/NFHL/MapServer/WFSServer"
wfs = WFS(
url_wfs,
layer="public_NFHL:Base_Flood_Elevations",
outformat="esrigeojson",
crs="epsg:4269",
)
r = wfs.getfeature_bybox(la_wshed.geometry.bounds, box_crs="epsg:4326")
flood = utils.json_togeodf(r.json(), "epsg:4269", "epsg:4326")Contributing
Contirbutions are very welcomed. Here’s how to set up PyGeoOGC for local development.
Fork the PyGeoOGC repo through the GitHub website.
Clone your fork locally and add the main PyGeoOGC as the upstream remote:
$ git clone git@github.com:your_name_here/pygeoogc.git
$ git remote add upstream git@github.com:cheginit/pygeoogc.gitInstall your local copy into a virtualenv. Assuming you have Conda installed, this is how you can set up your fork for local development:
$ cd pygeoogc/
$ conda env create -f ci/requirements/environment.yml
$ conda activate pygeoogc-dev
$ python -m pip install . --no-depsCheck out the develop branch and create a branch for local development:
$ git checkout develop
$ git checkout -b bugfix-or-feature/name-of-your-bugfix-or-feature
$ git pushBefore you first commit, pre-commit hooks needs to be setup:
$ pre-commit install
$ pre-commit run --all-filesNow you can make your changes locally, make sure to add a description of the changes to HISTORY.rst file and add extra tests, if applicable, to tests folder. Please make sure to add your name at the end of the item(s) you added to the history file like this By `Taher Chegini <https://github.com/cheginit>`_. Afterwards, fetch the latest updates from the remote and resolve any merge conflicts:
$ git fetch upstream
$ git merge upstream/developThen lint and test the code:
$ make clean
$ make lint
$ make install
$ make coverageIf you are making breaking changes make sure to reflect them in docs/usage.ipynb and docs/quickguide.ipynb notebooks if necessary.
Commit your changes and push your branch to GitHub:
$ git add .
$ git commit -m "Your detailed description of your changes."
$ git push origin name-of-your-bugfix-or-featureSubmit a pull request through the GitHub website. The pull request should work for Python 3.6, 3.7 and 3.8. Check https://github.com/cheginit/pygeoogc/actions and make sure that the tests pass.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pygeoogc-0.1.1-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 34e36e7b6ba1b300dc5a23e64c022398090be1ef9478225586137337cba19d05 |
|
| MD5 | e818e4034fa88913f9bb9a991eb92c99 |
|
| BLAKE2b-256 | 5de9277c9fab188ea5418f3fb917a9489392be2518028f7bae02a34db9b04a05 |
