nationalparkservice / arc2places

0 stars 1 forks source link

arc2places

This project provides tools for uploading National Park Service GIS data from ESRI data sources to the NP Places system which is based on the OSM data model. It was built to support the centennial data call(NPS-only)

This kernel of this project was derived from Paul Norman's ogr2osm tool which was derived from the UVM tool of the same name.

Other documents describe the workflow supported by the tools in this project.

Installation

National Park Service employees using ArcGIS Desktop can find installation help at http://akrgis.nps.gov/apps/arc2places/ (NPS-only)

Others can try the following:

  1. Clone or download this repository

  2. Install Pip

  3. Use Pip to install dependencies:

    • pip install requests_oauthlib
  4. Create the secrets.py file. Currently, the tool only writes to the NPS internal Places database and relies on tokens that are in the secrets.py file not included in the repo. Contact RISD for a token to write to the Places database (NPS-only).

Places Toolbox

Places.pyt is an ArcGIS Python Toolbox with tools for seeding ArcGIS data to Places. It includes place holders for planned tools for two way syncing between ArcGIS data and Places. This is the primary interface for the typical NPS ArcGIS user.

The toolbox provides both step by step tools, as well as a do it all in one step tool. The step by step tools are recommended until you are familiar with how the tool works and the suitability of your datasets. You should also test your datasets against the test version of the Places database before doing your production upload. Testing the toolbox is easier if you turn off Background Processing in the Geoprocessing Options.

The ArcToolbox tools relies on the structure and files in the repo, so be sure to move it as a unit.

The toolbox is primarily an ArcGIS interface to the same functionality provided with the command line tools. Additional information can be gleaned by reading about the command line tools.

Command line tools

There are command line versions of several of the tools in the toolbox. These are suitable for batch processing or server side scripting on Windows. There are versions of some of the tools that do not require ArcGIS or Windows. See Command Line.md for additional details.

Translation Files

All tools rely on the translation files for the logic to convert the fields/values in ESRI data sources to the Places tagging schemes. The translation files are based on the Park Service EGIS Data Standards and the Places Tracing Guide. They are fairly simple configuration files allowing them to be adapted to different database schemas if necessary.

Building

To build the installation bundle for the website:

  1. get latest version of getpip.py from https://bootstrap.pypa.io/get-pip.py
  2. get latest version of arc2places
  3. get latest version of secrets.py from RISD.
  4. Package the following files into a zip file called arc2places.zip:

    • get-pip.py
    • secrets.py
    • arc2places.pyt
    • *.py
    • *.pyt.xml
    • translations folder