Released
Software

Python Script Apple PY

Cite as:

Ziegler, Moritz O.; Ziebarth, Malte; Reiter, Karsten (2019): Python Script Apple PY. V. 1.02. GFZ Data Services. https://doi.org/10.5880/wsm.2019.001

Status

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

There is a new version of this dataset:

  • https://dx.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. Especially outcropping or out-pinching geological units, i.e. geological layers that are represented in the model volume, pose serious challenges. Changes in the geometry of a model may occur well into a project at a point, 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 uniform 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 contains no or only very few and simple structures. The mesh 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:

    Version 1.02 (8 September 2020):
    Bug fixes - no change in functionality. Manual for Version 1.0 remains valid except for certain cases where only single units should be processed. Then the added workaround should be used.
    - If you are working with only one unit/element set in the variable strata or elems_exclude use either: squared brackets, e.g. elems_exclude = ['disregarded_unit'] or append a comma after the string, e.g. elems_exclude = ('disegarded_unit',)

    Version 1.01 (29 August 2019):
    Bug fixes - no change in functionality. Manual for Version 1.0 remains valid
    - elems_exclude works now as designed and described in the manual.
    - commenting out elems_exclude does not crash the script anymore.
    - create_horizon_file does not create two instances of the uppermost horizon.

    Authors

    Contact

      Funders

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

    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.2019.001
        • 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, Darmstadt, Germany
        • titles
          • title: Python Script Apple PY
        • publisher: GFZ Data Services
        • publicationYear: 2019
        • 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, Darmstadt, 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=IsDocumentedBy): 10.2312/wsm.2019.001
          • relatedIdentifier (relatedIdentifierType=DOI relationType=References): 10.5880/wsm.2018.003
          • relatedIdentifier (relatedIdentifierType=DOI relationType=IsPreviousVersionOf): 10.5880/wsm.2020.002
        • sizes: 
        • formats: 
        • version: 1.02
        • rightsList
          • rights (rightsURI=https://www.gnu.org/licenses/gpl-3.0.en.html): GNU General Public License, Version 3, 29 June 2007 Copyright © 2019 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: 
        • 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
            • 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.2019.001
        • 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: 2020-12-03
        • 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
                • date
                  • CI_Date
                    • date
                      • Date: 2020-12-03
                    • 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.2019.001
                • 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, Darmstadt, 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: 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. Especially outcropping or out-pinching geological units, i.e. geological layers that are represented in the model volume, pose serious challenges. Changes in the geometry of a model may occur well into a project at a point, 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 uniform 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 contains no or only very few and simple structures. The mesh 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.
            • status
              • MD_ProgressCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_ProgressCode codeListValue=Complete): Complete
            • 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 © 2019 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 © 2019 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.2312/wsm.2019.001
                    • 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: 10.5880/wsm.2020.002
                    • codeSpace
                      • CharacterString: DOI
                • associationType
                  • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=IsPreviousVersionOf): IsPreviousVersionOf
            • 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.2019.001
                    • 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 © 2019 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences, Potsdam, Germany

    Software Description

    Documented by