Ergo requires that hazard data, both probabilistic and deterministic, be in ESRI's ASCII Raster format before importing the data. More details about this format can be found here:

If you are trying to convert a USGS shakemap from vector to raster and are not familiar with the process, please consult the following guide for further instructions - TODO add link to QGIS guide

Importing ASCII Raster Data

Once the data has been formatted, follow the instructions that best match the hazard data you are trying to import. The metadata for each type is slightly different depending on the hazard data you have (e.g. deterministic will ask you to specify the magnitude used to generate the hazard). If you have not already created a local data repository or don't know how, we recommend that you follow the guide Create Local Repository.

Deterministic Hazard

With the Ergo software open, go to File > Import, which will open the Import wizard.

Expand the folder Data, select Dataset and click Next.

Where it says Select One, select Raster and click Next.

Click Browse and locate the hazard dataset. You don't need to add location information. Click Next.

Where it says Select the data type for this file select Deterministic Hazard and click Next.

This is the last screen before we choose the repository to import the data to. We need to specify the following information about the dataset:

  • Hazard - the type of hazard represented by this dataset (e.g. PGA, SA, SD, etc)
  • Unit - the unit of measurement for the data (e.g. ground motion in g, %g, etc)
  • Magnitude - the magnitude used to generate the hazard data
  • Attenuation - the model used to generate the hazard data
  • period - the period of the data (e.g. if the hazard type is Sa, Ergo needs to know which period the value was taken).

Some of this metadata is informational (e.g. the magnitude used to generate the data); however some of it is used internally by the software to convert hazard types (if applicable), e.g. 0.2 for Sa so the period. After specifying the requested information, click Next.

Where it says Repository to ingest to select from the list of repositories, where it says Descriptive name for this dataset enter something like Shelby-PGA-Hazard and give it a version. Click Finish when done. The dataset should be available in the repository you selected under Hazards > Deterministic Hazard.

Probabilistic Hazard

For ingesting a probabilistic hazard map, follow the same sequence of steps above except for data type you will want to select Probabilistic Hazard. The only screen that will change will be the attribute mappings page. You should see all of the fields that the deterministic hazard shows, except magnitude and attenuation have been removed. Once imported, the data can be found under Hazards > Probabilistic Hazard.





  • No labels