In addition to region, you can examine areas of interest using geospatial files and lists of coordinates. Uploaded files are shared by all users in an account.

Shapefiles

Geospatial files define one or more polygons that bound a region of interest.

Functionality:

Any API call that returns a map slice can be supplied with an additional keyword argument, e.g. “shapefile=test.kml” to mask the requested data slice to the chosen shapefile. This works the same in the dashboard:

The column/dimension named “Location” has the geohash and there is an additional column/dimension named “location_name” (for nc) which has the names decoded. If a name is not supplied, the subregions are named Region 0, Region 1, etc.

Accepted formats:

• Do not include a period in the filename except for the final one associated with the extension.
• .geojson (open standard)
• .kml/.kmz (Google’s Keyhole Markup)
• .shp/.shx/.dbf (ESRI GIS)
  • Caveat: all 3 of the .shp, .shx, and .dbf need to be present for a shapefile to work so currently we only accept these packaged together in a .zip
  • a .prj is also required, in addition to the 3 other extensions listed.
  • the zip cannot have subdirectories
  • the zip cannot have extensions that are not in this list: shp, shx, dbf, prj, xml, idx, sbn, sbx, and cpg.

<aside> 💡 Note: If using shapefiles in downscale, they should be meteorologically consistent because we use one historical analog for the entire shapefile.

</aside>

Salient Standard Shapeflles

Standard shapefiles are available. If these are not visible and you would like access, contact help@salient predictions.com.

ISO regions

CONUS.geojson

CAISO.geojson

ERCOT.geojson

ISO-NE.geojson

MISO.geojson

NYISO.geojson

PJM.geojson

SPP.geojson

EIA regions

EIA East North Central.geojson

EIA East South Central.geojson

EIA Mid-Atlantic.geojson

EIA Mountain West.geojson

EIA New England.geojson

EIA Pacific West.geojson

EIA South Atlantic.geojson

EIA West North Central.geojson

EIA West South Central.geojson

https://www.loom.com/share/ffc80e02a21641e2a16a3cc412d97759?sid=19c89c5c-dbff-4078-bf1f-2b5547017b9a

Location List

Coordinate files define a list of point locations of interest (lat/lons) using the API.

<aside> 💡 Note:

• Limit your location list to 100 if you are not using debiasing or 50 if using debiasing. More locations will result in longer requests and are at risk of timing out.
• Make sure all locations are in one “Area”, e.g. North America, Europe, South America, etc
• Make sure there are no duplicate locations--this will trigger an error.
• Do not include a period in the filename except for the final one associated with the extension. For example, "my_important_cities.csv" is OK, but "my_important.cities.csv" will throw an error: "Files uploaded to /upload_file should only have 1 period, used to specify the file type. Please adjust the filename to remove all other periods.”

</aside>

Functionality: