Aquaveo leprovost adcirc

[aclark-aquaveo]

This is the initial merge of ADCIRC and LeProvost tidal database extractors. Changed our code to fetch resources from aquaveo.com if not found. Converted our code to return pandas.DataFrames in same format as the TPXO interface. We probably still want to do another pass to make the interfaces more consistent. Added a test case and tutorial for using the Python API with TPXO, ADCIRC, and LeProvost. Added Sphinx files for auto generation of docs.

[kajiglet]

@aclark-aquaveo This is a great start at incorporating the LeProvost and ADCIRC databases.

My worries are:

• Deconflict TidalDB and pytides as both include astronomical formulations
  • erdc/pytides may be edited
• Subclass TPXO support from TidalDB
  • LeProvost and TPXO, as global uniform gridded datasets, could share a subclass if LeProvost data is loaded into xarray
• Move resource download/extract into base class as standardized operation
  • Download into site-package harmonica/data directory
• ADCIRC requires Windows executables (one for each database)
  • Do the *.grd and *.tdb files provide all necessary data?
  • If the operations performed by the executables cannot be written in python then the executables must be compiled and hosted for all platforms
  • Convert the pertinent FORTRAN source code provided in the ADCIRC packages into Python
• Treat ADCIRC as a single resource
  • Automatically determine which database region (if any) the requested locations are within and then query the appropriate database
    • This probably requires the region domain extents as shapely objects
  • Simplify interface for the user who may not be aware how ADCIRC is different from the others