HydroShare GIS app

The HydroShare GIS app was developed to help HydroShare users visualize their spatial data and develop geospatial maps of the same. Users can generate new visual layers by uploading geospatial data files or importing data from HydroShare resources. Map layer visualization state can be saved back to HydroShare as a map project file stored in a Generic resource.

What can I do with this App?

With this app, you can visualize any spatial data that you have access to in HydroShare (if it is o the following resource types: Geographic Feature, Raster, Generic) on a map. You can also upload spatial files directly into the app, each of which will both be stored in newly-created, appropriate resource and then displayed on the app’s map for visualization. Multiple spatially-based files and/or resources can be added and viewed together, where each separate map layer (spatial file or resource) has its own layer list item from which it’s viewing options can be manipulated. Viewing options include the ability to modify the symbology (color scheme, labels, etc), toggle the visibility, and render on top of or beneath other layers.

This app will also save its current state in a map project file that is stored in a newly-created Generic HydroShare resource. Thus, all current layers and their configurations (symbology, visibility, rendering order, display names) can be accessed again at a later time or shared with others.

Users can choose from three internal base maps of the Earth (e.g., Aerial view, Aerial with names, or Roadview). Additional data uploaded or imported into the session would generate new data layers for visualization. Users can manipulate the visual attributes, modify the legend, or rename each layer using the layers options menu (on the right-corner of each layer tab). Finally, users can choose to save their session as a new HydroShare generic resource or export their visualizations as PDF or PNG file formats.

Example Uses of the App

HydroShare GIS can either be opened directly from the HydroShare Apps Library Portal (https://apps.hydroshare.org/apps), or from the “Open with...” dropdown on the landing page of associated HydroShare resources (Geographic Feature, Raster, Generic).

An example use of opening the app directly might be that a HydroShare user just finished producing/obtaining various spatial data files and wants to both upload them to HydroShare and then visualize them together with other existing HydroShare resource. That work-flow would look like this:

  1. Open the app from the HydroShare Apps Library Portal (https://apps.hydroshare.org/apps) or its direct URL or bookmark (https://apps.hydroshare.org/apps/hydroshare-gis/)
  2. Click the green “Add Local File” button
    1. A modal dialog will open up
  3. Choose to store files “In unique resource (create new resource)
  4. Choose the resource type (Geographic Feature, Raster, or Generic)
  5. Give the resource a title, abstract, and keywords
  6. Choose the spatial file(s) you would like stored in the resource
  7. Click “Add”
    1. The modal dialog will automatically close
    2. The left navigation bar will be disabled and showing a “Loading” animation
    3. After loading, the layer will be added to the map, a layer list item will appear in the “Current layers list”, and the Log modal dialog will appear containing a link to the newly-created resource on HydroShare
  8. Click the green “Add Resource” button
  9. Using the search input, type one or more keywords to find one of the other resources you were wanting to view with the newly-created, currently-added one.
  10. Click on the desired resource in the filtered list
  11. Click “Add”
    1. Repeat of options 7a, b, and c.
  12. Repeat steps 8-11 for each subsequent resource that you’d like to view with the currently added resources
  13. Once all desired resource have been added, you can now manipulate how they are being visualized together.
  14. Click and drag on any layer item to rearrange it in the “Current Layers” list.
    1. Layers are rendered on the map order of the bottom-most layer in the “Current Layers” list to the top-most layer. Thus, the top-most layer in the “Current Layers” list is rendered last and displayed on top of all other layers on the map (should be completely visible and clip out all other layers)
  15. Toggle on or off the little check box to the left of the layer name on the list item in the “Current Layers” list to toggle on or off the layer’s visibility in the map.
  16. Click the hamburger menu on any layer
  17. Select “Modify Symbology”
    1. A modal dialog will appear
  18. Choose the color scheme you would like for the layer
  19. Choose whether or not you’d like to add labels to the layer features (if applicable)
  20. Click “Apply” when you’re happy with your choices
    1. The map layer’s symbology will update to reflect your choices
  21. When done configuring your layer visualization options, you may wish to save the current state of your project (your session) for later viewing or sharing
  22. Click “Save as...”
    1. A modal dialog will appear
  23. Fill in the resource title, abstract, and keywords.
  24. Click “Save”
  25. Resource is created in the background
  26. Log modal dialog will appear when complete with a link to the newly-created Generic resource representing your map project
  27. If you wish to open the map project again in the future, from this resource’s landing page click the “Open with...” dropdown and select “HydroShare GIS”.
  28. HydroShare GIS will reload your project to its same state at save-time.

App Output

The rendered layers and segment of the basemap may be exported as PDF or PNG files.

The current app session (state) can be saved back to HydroShare as a map project file stored inside of a Generic resource.

Suggestions to learn more

View app’s Help dialog by opening the app (https://apps.hydroshare.org/apps/hydroshare-gis/) and clicking on the “Help” button in the upper right corner

View app’s code on GitHub here: https://github.com/hydroshare/tethysapp-hydroshare_gis

Credits, Authors, Contributors and Contacts

This app was created by Shawn Crawley at the Hydroinfomatics Lab at Brigham Young University (BYU) under the direction of Dan Ames. Zhiyu Li, also from BYU, acted as a primary, unofficial consultant. The HydroShare Team, led by David Tarboton at Utah State University, also contributed in various stages of planning, discussion and testing to make the app what it is today.