Released
Software

Python Script Apple PY v1.3

Cite as:

Ziegler, Moritz O.; Ziebarth, Malte; Reiter, Karsten (2020): Python Script Apple PY v1.3. V. 1.3. GFZ Data Services. https://doi.org/10.5880/wsm.2020.002

Status

I   N       R   E   V   I   E   W : Ziegler, Moritz O.; Ziebarth, Malte; Reiter, Karsten (2020): Python Script Apple PY v1.3. V. 1.3. GFZ Data Services. https://doi.org/10.5880/wsm.2020.002

Abstract

In geosciences the discretization of complex 3D model volumes into finite elements can be a time-consuming task and often needs experience with a professional software. In particular, low angle outcropping or out-pinching geological units, i.e. geological layers that are represented in the model volume, pose serious challenges. Another example are changes in the geometry of a model, which can occur at one point of a project, when re-meshing is not an option anymore or would involve a significant amount of additional time to invest.

In order to speed up and automate the process of discretization, Apple PY (Automatic Portioning Preventing Lengthy manual Element assignment for PYthon) separates the process of mesh-generation and unit assignment. It requires an existing mesh together with separate information on the depths of the interfaces between geological units (herein called horizons). These two pieces of information are combined and used to assign the individual elements to different units. The uniform mesh is created with a standard meshing software and has to be available as an Abaqus input file. The information on the horizons depths and lateral variations in the depths is provided in a text file. Apple PY compares the element location and depth with that of the horizons in order to assign each element to a corresponding geological unit below or above a certain horizon.

Additional Information

Version HIstory

This ia a major release of APPLE PY, including a new version of the manual. Previous versions are accessible via https://doi.org/10.5880/wsm.2019.003 (Ziegler et al., 2019).

Changes to version 1.02 (5 December 2020):

- Apple PY v1.3 supports multiple files with horizon depths that may even have a different lateral spacing between the grid points.

- Instead of absolute horizon depths, a mean value and a standard deviation can be provided together with a type of distribution from which Apple PY estimates the horizon depth.

- Due to the end of the support for Python 2.x Apple PY has been updated to run with Python 3.x.

- Various small changes have been implemented in order to make the script more robust. The reading of the code has been facilitated by using more functions and additional comments.

Authors

Contact

    Funders

  • Bundesministerium für Bildung und Forschung: SUBI (FONA/GEO:N)  (03G0869A)  
  • Helmholtz-Gemeinschaft: iCross  (SO-093)  

Keywords

geomechanical-numerical model, stress, in-situ stress, modelling tool, finite-elemeent model

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/wsm.2020.002
      • creators
        • creator
          • creatorName (nameType=Personal): Ziegler, Moritz O.
          • givenName: Moritz O.
          • familyName: Ziegler
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-2288-2820
          • affiliation (affiliationIdentifier=0000-0002-2288-2820 affiliationIdentifierScheme=ORCID): GFZ German Research Centre for Geosciences, Potsdam, Germany
        • creator
          • creatorName (nameType=Personal): Ziebarth, Malte
          • givenName: Malte
          • familyName: Ziebarth
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-5190-4478
          • affiliation (affiliationIdentifier=0000-0002-5190-4478 affiliationIdentifierScheme=ORCID): GFZ German Research Centre for Geosciences, Potsdam, Germany
        • creator
          • creatorName (nameType=Personal): Reiter, Karsten
          • givenName: Karsten
          • familyName: Reiter
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0003-4232-7426
          • affiliation: Technical University Darmstadt
      • titles
        • title: Python Script Apple PY v1.3
      • publisher: GFZ Data Services
      • publicationYear: 2020
      • subjects
        • subject: geomechanical-numerical model
        • subject: stress
        • subject: in-situ stress
        • subject: modelling tool
        • subject: finite-elemeent model
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE > SOLID EARTH > TECTONICS > NEOTECTONICS
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > CRUSTAL MOTION > CRUSTAL MOTION DIRECTION
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > FAULT MOVEMENT
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > PLATE BOUNDARIES
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > STRESS
      • contributors
        • contributor (contributorType=Editor)
          • contributorName (nameType=Personal): Ziegler, Moritz O.
          • givenName: Moritz O.
          • familyName: Ziegler
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-2288-2820
          • affiliation (affiliationIdentifier=0000-0002-2288-2820 affiliationIdentifierScheme=ORCID): GFZ German Research Centre for Geosciences, Potsdam, Germany
        • contributor (contributorType=Researcher)
          • contributorName (nameType=Personal): Ziegler, Moritz O.
          • givenName: Moritz O.
          • familyName: Ziegler
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-2288-2820
          • affiliation (affiliationIdentifier=0000-0002-2288-2820 affiliationIdentifierScheme=ORCID): GFZ German Research Centre for Geosciences, Potsdam, Germany
        • contributor (contributorType=Researcher)
          • contributorName (nameType=Personal): Ziebarth, Malte
          • givenName: Malte
          • familyName: Ziebarth
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-5190-4478
          • affiliation (affiliationIdentifier=0000-0002-5190-4478 affiliationIdentifierScheme=ORCID): GFZ German Research Centre for Geosciences, Potsdam, Germany
        • contributor (contributorType=Researcher)
          • contributorName (nameType=Personal): Reiter, Karsten
          • givenName: Karsten
          • familyName: Reiter
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0003-4232-7426
          • affiliation: Technical University Darmstadt
        • contributor (contributorType=ContactPerson)
          • contributorName: Ziegler, Moritz O.
          • affiliation (affiliationIdentifier= affiliationIdentifierScheme=): GFZ German Research Centre for Geosciences, Potsdam, Germany
        • contributor (contributorType=ContactPerson)
          • contributorName: Ziegler, Moritz O.
          • affiliation (affiliationIdentifier= affiliationIdentifierScheme=): GFZ German Research Centre for Geosciences, Potsdam, Germany
      • resourceType (resourceTypeGeneral=Software): Software
      • relatedIdentifiers
        • relatedIdentifier (relatedIdentifierType=DOI relationType=IsNewVersionOf): 10.5880/wsm.2019.001
        • relatedIdentifier (relatedIdentifierType=DOI relationType=IsDocumentedBy): 10.48440/wsm.2020.002
        • relatedIdentifier (relatedIdentifierType=DOI relationType=References): 10.5880/wsm.2018.003
        • relatedIdentifier (relatedIdentifierType=URL relationType=References): https://www.world-stress-map.org/
      • sizes: 
      • formats: 
      • version: 1.3
      • rightsList
        • rights (rightsURI=https://www.gnu.org/licenses/gpl-3.0.en.html): GNU General Public License, Version 3, 29 June 2007 Copyright © 2020 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences, Potsdam, Germany
      • descriptions
        • description (descriptionType=Abstract)
          • br: 
          • br: 
          • br: 
        • description (descriptionType=Other)
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
      • fundingReferences
        • fundingReference
          • funderName: Bundesministerium für Bildung und Forschung
          • funderIdentifier (funderIdentifierType=Crossref Funder ID): http://doi.org/10.13039/501100002347
          • awardNumber: 03G0869A
          • awardTitle: SUBI (FONA/GEO:N)
        • fundingReference
          • funderName: Helmholtz-Gemeinschaft
          • funderIdentifier (funderIdentifierType=Crossref Funder ID): http://doi.org/10.13039/501100001656
          • awardNumber: SO-093
          • awardTitle: iCross
  • 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/wsm.2020.002
      • 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: 2022-11-28
      • referenceSystemInfo
        • MD_ReferenceSystem
          • referenceSystemIdentifier
            • RS_Identifier
              • code
                • CharacterString: urn:ogc:def:crs:EPSG:4326
      • identificationInfo
        • MD_DataIdentification
          • citation
            • CI_Citation
              • title
                • CharacterString: Python Script Apple PY v1.3
              • date
                • CI_Date
                  • date
                    • Date: 2022-11-28
                  • 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/wsm.2020.002
              • citedResponsibleParty (xlink:href=http://orcid.org/0000-0002-2288-2820)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Ziegler, Moritz O.
                  • 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-0002-5190-4478)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Ziebarth, Malte
                  • 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-0003-4232-7426)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Reiter, Karsten
                  • organisationName
                    • CharacterString: Technical University Darmstadt
                  • 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: In geosciences the discretization of complex 3D model volumes into finite elements can be a time-consuming task and often needs experience with a professional software. In particular, low angle outcropping or out-pinching geological units, i.e. geological layers that are represented in the model volume, pose serious challenges. Another example are changes in the geometry of a model, which can occur at one point of a project, when re-meshing is not an option anymore or would involve a significant amount of additional time to invest. In order to speed up and automate the process of discretization, Apple PY (Automatic Portioning Preventing Lengthy manual Element assignment for PYthon) separates the process of mesh-generation and unit assignment. It requires an existing mesh together with separate information on the depths of the interfaces between geological units (herein called horizons). These two pieces of information are combined and used to assign the individual elements to different units. The uniform mesh is created with a standard meshing software and has to be available as an Abaqus input file. The information on the horizons depths and lateral variations in the depths is provided in a text file. Apple PY compares the element location and depth with that of the horizons in order to assign each element to a corresponding geological unit below or above a certain horizon.
          • pointOfContact
            • CI_ResponsibleParty
              • individualName
                • CharacterString: Ziegler, Moritz O.
              • organisationName
                • CharacterString: GFZ German Research Centre for Geosciences, Potsdam, Germany
              • contactInfo
                • CI_Contact
                  • address
                    • CI_Address
                      • electronicMailAddress
                        • CharacterString: mziegler(_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: geomechanical-numerical model
              • keyword
                • CharacterString: stress
              • keyword
                • CharacterString: in-situ stress
              • keyword
                • CharacterString: modelling tool
              • keyword
                • CharacterString: finite-elemeent model
          • descriptiveKeywords
            • MD_Keywords
              • keyword
                • CharacterString: EARTH SCIENCE > SOLID EARTH > TECTONICS > NEOTECTONICS
              • keyword
                • CharacterString: EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > CRUSTAL MOTION > CRUSTAL MOTION DIRECTION
              • keyword
                • CharacterString: EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > FAULT MOVEMENT
              • keyword
                • CharacterString: EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > PLATE BOUNDARIES
              • keyword
                • CharacterString: EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > STRESS
              • 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
          • resourceConstraints (xlink:href=https://www.gnu.org/licenses/gpl-3.0.en.html)
            • MD_Constraints
              • useLimitation
                • CharacterString: GNU General Public License, Version 3, 29 June 2007 Copyright © 2020 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences, Potsdam, Germany
          • resourceConstraints
            • MD_LegalConstraints
              • accessConstraints
                • MD_RestrictionCode (codeList=http://www.isotc211.org/2005/resources/codeList.xml#MD_RestrictionCode codeListValue=otherRestrictions): 
              • otherConstraints
                • CharacterString: GNU General Public License, Version 3, 29 June 2007 Copyright © 2020 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences, Potsdam, Germany
          • 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.5880/wsm.2019.001
                  • codeSpace
                    • CharacterString: DOI
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=IsNewVersionOf): IsNewVersionOf
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: 10.48440/wsm.2020.002
                  • codeSpace
                    • CharacterString: DOI
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=IsDocumentedBy): IsDocumentedBy
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: 10.5880/wsm.2018.003
                  • codeSpace
                    • CharacterString: DOI
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=References): References
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: https://www.world-stress-map.org/
                  • 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/wsm.2020.002
                  • 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 General Public License, Version 3, 29 June 2007 Copyright © 2020 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences, Potsdam, Germany

Software Description

Documented by