Released
Software

Python Script Apple PY

Cite as:

Ziegler, Moritz O.; Ziebarth, Malte; Reiter, Karsten (2019): Python Script Apple PY. V. 1.01. GFZ Data Services. http://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.01. GFZ Data Services. http://doi.org/10.5880/wsm.2019.001

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.

Version History:

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.

Contact

Keywords

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

GCMD Science Keywords

More Metadata

  • iso19115:  /  download xml
    • MD_Metadata (xsi:schemaLocation=http://www.isotc211.org/2005/gmd http://www.isotc211.org/2005/gmd/gmd.xsd)
      • fileIdentifier
        • CharacterString: doi:10.5880/wsm.2019.001
      • language
        • LanguageCode (codeList=http://www.loc.gov/standards/iso639-2/ codeListValue=eng): eng
      • characterSet
        • MD_CharacterSetCode (codeList=http://www.isotc211.org/2005/resources/codeList.xml#MD_CharacterSetCode codeListValue=utf8): 
      • hierarchyLevel
        • MD_ScopeCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_ScopeCode codeListValue=): 
      • hierarchyLevelName
        • CharacterString: 
      • contact
        • CI_ResponsibleParty
          • organisationName
            • CharacterString: GFZ German Research Centre for Geosciences
          • contactInfo
            • CI_Contact
              • address
                • CI_Address
                  • electronicMailAddress
                    • CharacterString: 
              • onlineResource
                • CI_OnlineResource
                  • linkage
                    • URL: http://www.gfz-potsdam.de/
                  • function
                    • CI_OnLineFunctionCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_OnLineFunctionCode codeListValue=information): information
          • role
            • CI_RoleCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode codeListValue=pointOfContact): pointOfContact
      • dateStamp
        • Date: 2019-08-29
      • 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: 2019-08-29
                  • 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=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode_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=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode_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=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode_author): author
          • 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. Version History: 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.
          • 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=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode_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 > PLATE TECTONICS > PLATE BOUNDARIES
              • 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 > STRESS
              • keyword
                • CharacterString: EARTH SCIENCE > SOLID EARTH > TECTONICS > NEOTECTONICS
              • 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
          • language
            • CharacterString: eng
      • distributionInfo
        • MD_Distribution
          • transferOptions
            • MD_DigitalTransferOptions
              • onLine
                • CI_OnlineResource
                  • linkage
                    • URL: http://dx.doi.org/doi:10.5880/wsm.2019.001
                  • protocol
                    • CharacterString: WWW:LINK-1.0-http--link
                  • name
                    • CharacterString: Download
                  • description
                    • CharacterString: Download
                  • 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_download): download
  • datacite:  /  download xml
    • resource (xsi:schemaLocation=http://datacite.org/schema/kernel-4 http://schema.datacite.org/meta/kernel-4/metadata.xsd)
      • identifier (identifierType=DOI): 10.5880/wsm.2019.001
      • creators
        • creator
          • creatorName: Ziegler, Moritz O.
          • givenName: Moritz O.
          • familyName: Ziegler
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-2288-2820
          • affiliation: GFZ German Research Centre for Geosciences, Potsdam, Germany
        • creator
          • creatorName: Ziebarth, Malte
          • givenName: Malte
          • familyName: Ziebarth
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-5190-4478
          • affiliation: GFZ German Research Centre for Geosciences, Potsdam, Germany
        • creator
          • creatorName: Reiter, Karsten
          • givenName: Karsten
          • familyName: Reiter
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0003-4232-7426
          • affiliation: Technical University Darmstadt, Darmstadt, Germany
      • titles
        • title (xml:lang=en): 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 (schemeURI=http://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/sciencekeywords subjectScheme=NASA/GCMD Earth Science Keywords xml:lang=en): EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > PLATE BOUNDARIES
        • subject (schemeURI=http://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/sciencekeywords subjectScheme=NASA/GCMD Earth Science Keywords xml:lang=en): EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > CRUSTAL MOTION > CRUSTAL MOTION DIRECTION
        • subject (schemeURI=http://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/sciencekeywords subjectScheme=NASA/GCMD Earth Science Keywords xml:lang=en): EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > FAULT MOVEMENT
        • subject (schemeURI=http://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/sciencekeywords subjectScheme=NASA/GCMD Earth Science Keywords xml:lang=en): EARTH SCIENCE > SOLID EARTH > TECTONICS > PLATE TECTONICS > STRESS
        • subject (schemeURI=http://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/sciencekeywords subjectScheme=NASA/GCMD Earth Science Keywords xml:lang=en): EARTH SCIENCE > SOLID EARTH > TECTONICS > NEOTECTONICS
      • contributors
        • contributor (contributorType=Editor)
          • contributorName: Ziegler, Moritz O.
          • givenName: Moritz O.
          • familyName: Ziegler
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-2288-2820
          • affiliation: GFZ German Research Centre for Geosciences, Potsdam, Germany
        • contributor (contributorType=Researcher)
          • contributorName: Ziegler, Moritz O.
          • givenName: Moritz O.
          • familyName: Ziegler
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-2288-2820
          • affiliation: GFZ German Research Centre for Geosciences, Potsdam, Germany
        • contributor (contributorType=Researcher)
          • contributorName: Ziebarth, Malte
          • givenName: Malte
          • familyName: Ziebarth
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-5190-4478
          • affiliation: GFZ German Research Centre for Geosciences, Potsdam, Germany
        • contributor (contributorType=Researcher)
          • contributorName: Reiter, Karsten
          • givenName: Karsten
          • familyName: Reiter
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0003-4232-7426
          • affiliation: Technical University Darmstadt, Darmstadt, Germany
      • language: en
      • resourceType (resourceTypeGeneral=Software): 
      • relatedIdentifiers
        • relatedIdentifier (relatedIdentifierType=DOI relationType=IsDocumentedBy): 10.2312/wsm.2019.001
        • relatedIdentifier (relatedIdentifierType=DOI relationType=References): 10.5880/wsm.2018.003
      • sizes
        • size: 5 Files
      • formats
        • format: application/octet-stream
        • format: application/octet-stream
        • format: application/octet-stream
        • format: application/octet-stream
        • format: application/octet-stream
      • version: 1.01
      • 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: 
          • 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
  • dif:  /  download xml
    • DIF (xsi:schemaLocation=http://gcmd.gsfc.nasa.gov/Aboutus/xml/dif/ http://gcmd.nasa.gov/Aboutus/xml/dif/dif_v9.8.2.xsd)
      • Entry_ID: 10.5880/wsm.2019.001
      • Entry_Title: Python Script Apple PY
      • Data_Set_Citation
        • Dataset_Creator: Ziegler, Moritz O.; Ziebarth, Malte; Reiter, Karsten
        • Dataset_Title: Python Script Apple PY
        • Dataset_Release_Date: 2019
        • Dataset_Release_Place: Potsdam, Germany
        • Dataset_Publisher: GFZ Data Services
        • Online_Resource: http://dx.doi.org/10.5880/wsm.2019.001
      • Parameters
        • Category: EARTH SCIENCE
        • Topic: SOLID EARTH
        • Term: TECTONICS
        • Variable_Level_1: PLATE TECTONICS
        • Variable_Level_2: PLATE BOUNDARIES
      • Parameters
        • Category: EARTH SCIENCE
        • Topic: SOLID EARTH
        • Term: TECTONICS
        • Variable_Level_1: PLATE TECTONICS
        • Variable_Level_2: CRUSTAL MOTION
        • Variable_Level_3: CRUSTAL MOTION DIRECTION
      • Parameters
        • Category: EARTH SCIENCE
        • Topic: SOLID EARTH
        • Term: TECTONICS
        • Variable_Level_1: PLATE TECTONICS
        • Variable_Level_2: FAULT MOVEMENT
      • Parameters
        • Category: EARTH SCIENCE
        • Topic: SOLID EARTH
        • Term: TECTONICS
        • Variable_Level_1: PLATE TECTONICS
        • Variable_Level_2: STRESS
      • Parameters
        • Category: EARTH SCIENCE
        • Topic: SOLID EARTH
        • Term: TECTONICS
        • Variable_Level_1: NEOTECTONICS
      • ISO_Topic_Category: geoscientificInformation
      • Keyword: geomechanical-numerical model
      • Keyword: stress
      • Keyword: in-situ stress
      • Keyword: modelling tool
      • Keyword: finite-elemeent model
      • Data_Center
        • Data_Center_Name
          • Short_Name: Deutsches GeoForschungsZentrum GFZ
          • Long_Name: GFZ
        • Personnel
          • Role: DATA CENTER CONTACT
          • Last_Name: Deutsches GeoForschungsZentrum GFZ
      • Summary
        • 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. Version History: 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.
      • Metadata_Name: DIF
      • Metadata_Version: 9.8.2
  • escidoc:  /  download xml
    • resource
      • title (xml:lang=en): Python Script Apple PY
      • creator
        • creatorName: Ziegler, Moritz O.
        • givenName: Moritz O.
        • familyName: Ziegler
        • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-2288-2820
        • affiliation: GFZ German Research Centre for Geosciences, Potsdam, Germany
      • creator
        • creatorName: Ziebarth, Malte
        • givenName: Malte
        • familyName: Ziebarth
        • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-5190-4478
        • affiliation: GFZ German Research Centre for Geosciences, Potsdam, Germany
      • creator
        • creatorName: Reiter, Karsten
        • givenName: Karsten
        • familyName: Reiter
        • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0003-4232-7426
        • affiliation: Technical University Darmstadt, Darmstadt, Germany

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