Released
Software

eGSIM - a Python library and web application to select and test Ground Motion models

Cite as:

Zaccarelli, Riccardo; Weatherill, Graeme (2020): eGSIM - a Python library and web application to select and test Ground Motion models. GFZ Data Services. https://doi.org/10.5880/GFZ.2.6.2023.007

Status

I   N       R   E   V   I   E   W : Zaccarelli, Riccardo; Weatherill, Graeme (2020): eGSIM - a Python library and web application to select and test Ground Motion models. GFZ Data Services. https://doi.org/10.5880/GFZ.2.6.2023.007

Abstract

Ground motion models (GMM) have been employed in several domains, from traditional seismic hazard and risk analysis to more recent shakemaps and rapid loss assessment. In this framework, eGSIM is a Python package and web application intended to help engineers and seismologist in understanding how different models compare for specific earthquake scenarios and how well they fit to observed ground motion data, producing results as visual plot or tabular data in standard, accessible and convenient formats (CSV, HDF, JSON and several image formats).

Based on OpenQuake, a popular open-source Python library for seismic hazard and risk analysis, eGSIM incorporates and makes available in two user-friendly interfaces hundreds of published GMMs implemented and tested in OpenQuake: an online graphical user interface (GUI) accessible at https://egsim.gfz-potsdam.de, ideal for comparisons that can be visualized or downloaded as images, and a web application programming interface (web API), implemented along the lines of popular seismological web services (FDSN), more suited for comparisons that may be automatized in scheduled jobs, or need to be integrated into custom code and further processed in the user's own workflows.

By incorporating databases in form of so-called flatfiles (ESM) and regionalizations derived from seismic hazard models (SHARE, ESHM20), eGSIM allows users to seamlessly select data for comparison and models for comparison based on regions of interest. It also features management scripts to smoothly incorporate new flatfiles or regionalizations from future research projects.Moreover, via the generation of flatfile templates based on a custom selection of GMMs, and the possibility to upload user-defined flatfiles, eGSIM facilitates the non-trivial task of compiling data for model comparison, and can be used to analyze ground motions from any data set recorded anywhere in the world, including rapid analysis of earthquake records following large events.

Authors

Contact

Keywords

Ground motion model, PSHA, OpenQuake, Strong motion database, flatfile, web API, science > materials science > engineering > seismic engineering

GCMD Science Keywords

More Metadata

  • datacite: download xml
    • resource (xsi:schemaLocation=http://datacite.org/schema/kernel-4 http://schema.datacite.org/meta/kernel-4.3/metadata.xsd)
      • identifier (identifierType=DOI): 10.5880/GFZ.2.6.2023.007
      • creators
        • creator
          • creatorName (nameType=Personal): Zaccarelli, Riccardo
          • givenName: Riccardo
          • familyName: Zaccarelli
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0001-9133-1750
          • affiliation: GFZ German Research Centre for Geosciences, Potsdam, Germany
        • creator
          • creatorName (nameType=Personal): Weatherill, Graeme
          • givenName: Graeme
          • familyName: Weatherill
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0001-9347-2282
          • affiliation: GFZ German Research Centre for Geosciences, Potsdam, Germany
      • titles
        • title: eGSIM - a Python library and web application to select and test Ground Motion models
      • publisher: GFZ Data Services
      • publicationYear: 2020
      • subjects
        • subject: Ground motion model
        • subject: PSHA
        • subject: OpenQuake
        • subject: Strong motion database
        • subject: flatfile
        • subject: web API
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE > HUMAN DIMENSIONS > NATURAL HAZARDS > EARTHQUAKES
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE SERVICES > DATA ANALYSIS AND VISUALIZATION
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE SERVICES > WEB SERVICES
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE SERVICES > WEB SERVICES > DATA PROCESSING SERVICES
        • subject (subjectScheme=GEMET - INSPIRE themes, version 1.0): science > materials science > engineering > seismic engineering
      • contributors
        • contributor (contributorType=ContactPerson)
          • contributorName: Zaccarelli, Riccardo
          • affiliation: GFZ German Research Centre for Geosciences, Potsdam, Germany
        • contributor (contributorType=ContactPerson)
          • contributorName: Weatherill, Graeme
          • affiliation: GFZ German Research Centre for Geosciences, Potsdam, Germany
      • resourceType (resourceTypeGeneral=Software): Software
      • relatedIdentifiers
        • relatedIdentifier (relatedIdentifierType=DOI relationType=Cites): 10.13127/ESM.2
        • relatedIdentifier (relatedIdentifierType=DOI relationType=Cites): 10.1785/0220130087
        • relatedIdentifier (relatedIdentifierType=DOI relationType=Cites): 10.12686/SED-00000001-SHARE
        • relatedIdentifier (relatedIdentifierType=URL relationType=IsVariantFormOf): https://github.com/rizac/egsim
        • relatedIdentifier (relatedIdentifierType=URL relationType=References): http://www.efehr.org
        • relatedIdentifier (relatedIdentifierType=URL relationType=References): https://egsim.gfz-potsdam.de
      • sizes: 
      • formats: 
      • rightsList
        • rights (rightsURI=https://www.gnu.org/licenses/agpl-3.0.html): GNU Affero General Public License, Version 3 (19 June 2007); Copyright © 2023 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences, Potsdam, Germany (Riccardo Zaccarelli, Graeme Warherill)
      • descriptions
        • description (descriptionType=Abstract)
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
  • iso19115: download xml
    • MD_Metadata (xsi:schemaLocation=http://www.isotc211.org/2005/gmd http://www.isotc211.org/2005/gmd/gmd.xsd)
      • fileIdentifier
        • CharacterString: 10.5880/GFZ.2.6.2023.007
      • language
        • LanguageCode (codeList=http://www.loc.gov/standards/iso639-2/ codeListValue=eng): eng
      • characterSet
        • MD_CharacterSetCode (codeListValue=utf8 codeList=http://www.isotc211.org/2005/resources/codeList.xml#MD_CharacterSetCode): 
      • hierarchyLevel
        • MD_ScopeCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_ScopeCode codeListValue=dataset): dataset
      • hierarchyLevelName
        • CharacterString: 
      • contact
        • CI_ResponsibleParty
          • organisationName
            • CharacterString: GFZ German Research Centre for Geosciences
          • contactInfo
            • CI_Contact
              • address
                • CI_Address
                  • electronicMailAddress
                    • CharacterString: datapub(_at_)gfz-potsdam.de
              • onlineResource
                • CI_OnlineResource
                  • linkage
                    • URL: http://www.gfz-potsdam.de
                  • name
                    • CharacterString: Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences
                  • description
                    • CharacterString: Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences
          • role
            • CI_RoleCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode codeListValue=pointOfContact): pointOfContact
      • dateStamp
        • Date: 2023-09-27
      • referenceSystemInfo
        • MD_ReferenceSystem
          • referenceSystemIdentifier
            • RS_Identifier
              • code
                • CharacterString: urn:ogc:def:crs:EPSG:4326
      • identificationInfo
        • MD_DataIdentification
          • citation
            • CI_Citation
              • title
                • CharacterString: eGSIM - a Python library and web application to select and test Ground Motion models
              • date
                • CI_Date
                  • date
                    • Date: 2023-09-27
                  • dateType
                    • CI_DateTypeCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode codeListValue=revision): revision
              • identifier
                • MD_Identifier
                  • code
                    • CharacterString: doi:10.5880/GFZ.2.6.2023.007
              • citedResponsibleParty (xlink:href=http://orcid.org/0000-0001-9133-1750)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Zaccarelli, Riccardo
                  • organisationName
                    • CharacterString: GFZ German Research Centre for Geosciences, Potsdam, Germany
                  • role
                    • CI_RoleCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode codeListValue=author): author
              • citedResponsibleParty (xlink:href=http://orcid.org/0000-0001-9347-2282)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Weatherill, Graeme
                  • organisationName
                    • CharacterString: GFZ German Research Centre for Geosciences, Potsdam, Germany
                  • role
                    • CI_RoleCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode codeListValue=author): author
              • citedResponsibleParty
                • CI_ResponsibleParty
                  • organisationName
                    • CharacterString: GFZ Data Services
                  • role
                    • CI_RoleCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode codeListValue=publisher): publisher
          • abstract
            • CharacterString: Ground motion models (GMM) have been employed in several domains, from traditional seismic hazard and risk analysis to more recent shakemaps and rapid loss assessment. In this framework, eGSIM is a Python package and web application intended to help engineers and seismologist in understanding how different models compare for specific earthquake scenarios and how well they fit to observed ground motion data, producing results as visual plot or tabular data in standard, accessible and convenient formats (CSV, HDF, JSON and several image formats). Based on OpenQuake, a popular open-source Python library for seismic hazard and risk analysis, eGSIM incorporates and makes available in two user-friendly interfaces hundreds of published GMMs implemented and tested in OpenQuake: an online graphical user interface (GUI) accessible at https://egsim.gfz-potsdam.de, ideal for comparisons that can be visualized or downloaded as images, and a web application programming interface (web API), implemented along the lines of popular seismological web services (FDSN), more suited for comparisons that may be automatized in scheduled jobs, or need to be integrated into custom code and further processed in the user's own workflows. By incorporating databases in form of so-called flatfiles (ESM) and regionalizations derived from seismic hazard models (SHARE, ESHM20), eGSIM allows users to seamlessly select data for comparison and models for comparison based on regions of interest. It also features management scripts to smoothly incorporate new flatfiles or regionalizations from future research projects.Moreover, via the generation of flatfile templates based on a custom selection of GMMs, and the possibility to upload user-defined flatfiles, eGSIM facilitates the non-trivial task of compiling data for model comparison, and can be used to analyze ground motions from any data set recorded anywhere in the world, including rapid analysis of earthquake records following large events.
          • pointOfContact
            • CI_ResponsibleParty
              • individualName
                • CharacterString: Zaccarelli, Riccardo
              • organisationName
                • CharacterString: GFZ German Research Centre for Geosciences, Potsdam, Germany
              • contactInfo
                • CI_Contact
                  • address
                    • CI_Address
                      • electronicMailAddress
                        • CharacterString: rizac(_at_)gfz-potsdam.de
              • role
                • CI_RoleCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode codeListValue=pointOfContact): pointOfContact
          • pointOfContact
            • CI_ResponsibleParty
              • individualName
                • CharacterString: Weatherill, Graeme
              • organisationName
                • CharacterString: GFZ German Research Centre for Geosciences, Potsdam, Germany
              • contactInfo
                • CI_Contact
                  • address
                    • CI_Address
                      • electronicMailAddress
                        • CharacterString: gweather(_at_)gfz-potsdam.de
              • role
                • CI_RoleCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode codeListValue=pointOfContact): pointOfContact
          • descriptiveKeywords
            • MD_Keywords
              • keyword
                • CharacterString: Ground motion model
              • keyword
                • CharacterString: PSHA
              • keyword
                • CharacterString: OpenQuake
              • keyword
                • CharacterString: Strong motion database
              • keyword
                • CharacterString: flatfile
              • keyword
                • CharacterString: web API
          • descriptiveKeywords
            • MD_Keywords
              • keyword
                • CharacterString: EARTH SCIENCE > HUMAN DIMENSIONS > NATURAL HAZARDS > EARTHQUAKES
              • keyword
                • CharacterString: EARTH SCIENCE SERVICES > DATA ANALYSIS AND VISUALIZATION
              • keyword
                • CharacterString: EARTH SCIENCE SERVICES > WEB SERVICES
              • keyword
                • CharacterString: EARTH SCIENCE SERVICES > WEB SERVICES > DATA PROCESSING SERVICES
              • thesaurusName
                • CI_Citation
                  • title
                    • CharacterString: NASA/GCMD Earth Science Keywords
                  • date
                    • CI_Date
                      • date (gco:nilReason=missing): 
                      • dateType
                        • CI_DateTypeCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode codeListValue=publication): publication
          • descriptiveKeywords
            • MD_Keywords
              • keyword
                • CharacterString: science > materials science > engineering > seismic engineering
              • thesaurusName
                • CI_Citation
                  • title
                    • CharacterString: GEMET - INSPIRE themes, version 1.0
                  • date
                    • CI_Date
                      • date (gco:nilReason=missing): 
                      • dateType
                        • CI_DateTypeCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode codeListValue=publication): publication
          • resourceConstraints (xlink:href=https://www.gnu.org/licenses/agpl-3.0.html)
            • MD_Constraints
              • useLimitation
                • CharacterString: GNU Affero General Public License, Version 3 (19 June 2007); Copyright © 2023 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences, Potsdam, Germany (Riccardo Zaccarelli, Graeme Warherill)
          • resourceConstraints
            • MD_LegalConstraints
              • accessConstraints
                • MD_RestrictionCode (codeList=http://www.isotc211.org/2005/resources/codeList.xml#MD_RestrictionCode codeListValue=otherRestrictions): 
              • otherConstraints
                • CharacterString: GNU Affero General Public License, Version 3 (19 June 2007); Copyright © 2023 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences, Potsdam, Germany (Riccardo Zaccarelli, Graeme Warherill)
          • resourceConstraints
            • MD_SecurityConstraints
              • classification
                • MD_ClassificationCode (codeList=http://www.isotc211.org/2005/resources/codeList.xml#MD_ClassificationCode codeListValue=unclassified): 
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: 10.13127/ESM.2
                  • codeSpace
                    • CharacterString: DOI
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=Cites): Cites
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: 10.1785/0220130087
                  • codeSpace
                    • CharacterString: DOI
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=Cites): Cites
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: 10.12686/SED-00000001-SHARE
                  • codeSpace
                    • CharacterString: DOI
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=Cites): Cites
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: https://github.com/rizac/egsim
                  • codeSpace
                    • CharacterString: URL
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=IsVariantFormOf): IsVariantFormOf
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: http://www.efehr.org
                  • codeSpace
                    • CharacterString: URL
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=References): References
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: https://egsim.gfz-potsdam.de
                  • codeSpace
                    • CharacterString: URL
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=References): References
          • language
            • CharacterString: eng
          • characterSet
            • MD_CharacterSetCode (codeListValue=utf8 codeList=http://www.isotc211.org/2005/resources/codeList.xml#MD_CharacterSetCode): 
          • topicCategory
            • MD_TopicCategoryCode: geoscientificInformation
      • distributionInfo
        • MD_Distribution
          • transferOptions
            • MD_DigitalTransferOptions
              • onLine
                • CI_OnlineResource
                  • linkage
                    • URL: http://doi.org/10.5880/GFZ.2.6.2023.007
                  • protocol
                    • CharacterString: WWW:LINK-1.0-http--link
                  • name
                    • CharacterString: Data Access - DOI
                  • description
                    • CharacterString: Data Access - DOI
                  • function
                    • CI_OnLineFunctionCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_OnLineFunctionCode codeListValue=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_OnLineFunctionCode_information): information
      • dataQualityInfo
        • DQ_DataQuality
          • scope
            • DQ_Scope
              • level
                • MD_ScopeCode (codeListValue=dataset codeList=http://www.isotc211.org/2005/resources/codeList.xml#MD_ScopeCode): 
  • schema.org download

Files

License: GNU Affero General Public License, Version 3 (19 June 2007); Copyright © 2023 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences, Potsdam, Germany (Riccardo Zaccarelli, Graeme Warherill)

Related Work

Cites

Variant Form of

References