Released
Software

Heat Flow Quality Analysis Toolbox (hfqa_tool)

Cite as:

Chishti, Saman F.; Balkan-Pazvantoğlu, Elif; Norden, Ben; Neumann, Florian; Elbarbary, Samah; Gross, Eskil S.; Petrunin, Alexey G.; Fuchs, Sven (2025): Heat Flow Quality Analysis Toolbox (hfqa_tool). GFZ Data Services. https://doi.org/10.5880/fidgeo.2025.043

Status

I   N       R   E   V   I   E   W : Chishti, Saman F.; Balkan-Pazvantoğlu, Elif; Norden, Ben; Neumann, Florian; Elbarbary, Samah; Gross, Eskil S.; Petrunin, Alexey G.; Fuchs, Sven (2025): Heat Flow Quality Analysis Toolbox (hfqa_tool). GFZ Data Services. https://doi.org/10.5880/fidgeo.2025.043

Abstract

Heat Flow Quality Analysis Toolbox hfqa_tool is a Python package containing tools for validating and evaluating the quality of heat flow data. It is designed for researchers and professionals. hfqa_tool simplifies heat flow data analysis by providing standardized and reproducible quality checks. This is developed in compliance with the paper by Fuchs et al. (2023) titled "Quality-assurance of heat-flow data: The new structure and evaluation scheme of the IHFC Global Heat Flow Database," published in Tectonophysics 863: 229976. Also revised for the newer release 2024. There are mainly 2 functions defined in this tool with description as follows:

vocabulary_check(): This set of code has been developed to check whether all the values entered in a Heatflow database adhere to a controlled vocabulary and proper structure described in the aforementioned scientific paper. It generates an error message for each entry where the value entered is out of bounds and does not meet the assigned criteria. The code also enables checking the vocabulary for multiple values entered in a single column for a particular Heatflow data entry. It's a recommended prerequisite before calculating 'Quality Scores' for a given Heatflow dataset.

quality_scores(): This code has been developed to assess the quality of the Heatflow database in terms of U-score (Uncertainty quantification), M-Score (Methodological quality), and P-Flags (Perturbation effects) adhering to the data structure described in the aforementioned scientific paper.

Additional Information

MIT License

Copyright (c) <2024> the authors, GFZ Helmholtz Centre for Geosciences

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "hfqa_tool"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Authors

Contact

  • Fuchs (Sven); GFZ Helmholtz Centre for Geosciences, Potsdam, Germany;

Contributors

Fuchs

    Funders

  • Deutsche Forschungsgemeinschaft: World Heat Flow Database Project  (EL 918/2-1)  

Keywords

heat flow, Global Heat Flow Database, International Heat Flow Commission, data quality

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/fidgeo.2025.043
      • creators
        • creator
          • creatorName (nameType=Personal): Chishti, Saman F.
          • givenName: Saman F.
          • familyName: Chishti
          • nameIdentifier (nameIdentifierScheme=ORCID): 0009-0002-6405-2996
          • affiliation: GFZ Helmholtz Centre for Geosciences, Potsdam, Germany
          • affiliation: University of Potsdam, Potsdam, Germany
        • creator
          • creatorName (nameType=Personal): Balkan-Pazvantoğlu, Elif
          • givenName: Elif
          • familyName: Balkan-Pazvantoğlu
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-8117-4576
          • affiliation: Dokuz Eylül University, Izmir, Türkiye
        • creator
          • creatorName (nameType=Personal): Norden, Ben
          • givenName: Ben
          • familyName: Norden
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0003-2228-9979
          • affiliation: GFZ Helmholtz Centre for Geosciences, Potsdam, Germany
        • creator
          • creatorName (nameType=Personal): Neumann, Florian
          • givenName: Florian
          • familyName: Neumann
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-9666-5087
          • affiliation: MARUM Center for Marine Environmental Sciences, University of Bremen, Bremen, 28334, Germany
        • creator
          • creatorName (nameType=Personal): Elbarbary, Samah
          • givenName: Samah
          • familyName: Elbarbary
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-1479-787X
          • affiliation: GFZ Helmholtz Centre for Geosciences, Potsdam, Germany
        • creator
          • creatorName (nameType=Personal): Gross, Eskil S.
          • givenName: Eskil S.
          • familyName: Gross
          • nameIdentifier (nameIdentifierScheme=ORCID): 0009-0009-8028-7040
          • affiliation: GFZ Helmholtz Centre for Geosciences, Potsdam, Germany
        • creator
          • creatorName (nameType=Personal): Petrunin, Alexey G.
          • givenName: Alexey G.
          • familyName: Petrunin
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-5439-4178
          • affiliation: GFZ Helmholtz Centre for Geosciences, Potsdam, Germany
        • creator
          • creatorName (nameType=Personal): Fuchs, Sven
          • givenName: Sven
          • familyName: Fuchs
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-2896-6662
          • affiliation: GFZ Helmholtz Centre for Geosciences, Potsdam, Germany
      • titles
        • title: Heat Flow Quality Analysis Toolbox (hfqa_tool)
      • publisher: GFZ Data Services
      • publicationYear: 2025
      • subjects
        • subject: heat flow
        • subject: Global Heat Flow Database
        • subject: International Heat Flow Commission
        • subject: data quality
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE > OCEANS > SEA ICE > HEAT FLUX
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE > SOLID EARTH > GEOTHERMAL DYNAMICS > GEOTHERMAL ENERGY
        • subject (subjectScheme=NASA/GCMD Earth Science Keywords): EARTH SCIENCE > SOLID EARTH > GEOTHERMAL DYNAMICS > GEOTHERMAL TEMPERATURE
      • contributors
        • contributor (contributorType=ContactPerson)
          • contributorName (nameType=Personal): Fuchs, Sven
          • givenName: Sven
          • familyName: Fuchs
          • nameIdentifier (nameIdentifierScheme=ORCID): 0000-0002-2896-6662
          • affiliation: GFZ Helmholtz Centre for Geosciences, Potsdam, Germany
        • contributor (contributorType=ContactPerson)
          • contributorName: Fuchs
          • affiliation: GFZ Helmholtz Centre for Geosciences, Potsdam, Germany
      • dates
        • date (dateType=Created): 
      • resourceType (resourceTypeGeneral=Software): Software
      • relatedIdentifiers
        • relatedIdentifier (relatedIdentifierType=DOI relationType=IsSupplementTo): DOI of paper when available
        • relatedIdentifier (relatedIdentifierType=DOI relationType=IsDocumentedBy): 10.1016/j.tecto.2023.229976
        • relatedIdentifier (relatedIdentifierType=URL relationType=IsVariantFormOf): https://github.com/ihfc-iugg
        • relatedIdentifier (relatedIdentifierType=DOI relationType=Cites): 10.5880/fidgeo.2025.042
        • relatedIdentifier (relatedIdentifierType=DOI relationType=Cites): 10.5880/fidgeo.2024.014
      • sizes: 
      • formats: 
      • rightsList
        • rights (rightsURI=https://opensource.org/license/mit): MIT Licence Copyright (c) <2024> the authors; GFZ Helmholtz Centre for Geosciences)
      • descriptions
        • description (descriptionType=Abstract)
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
        • description (descriptionType=Other)
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
          • br: 
      • fundingReferences
        • fundingReference
          • funderName: Deutsche Forschungsgemeinschaft
          • funderIdentifier (funderIdentifierType=Crossref Funder ID): http://dx.doi.org/10.13039/501100001659
          • awardNumber: EL 918/2-1
          • awardTitle: World Heat Flow Database Project
  • 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/fidgeo.2025.043
      • 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: 2025-07-16
      • referenceSystemInfo
        • MD_ReferenceSystem
          • referenceSystemIdentifier
            • RS_Identifier
              • code
                • CharacterString: urn:ogc:def:crs:EPSG:4326
      • identificationInfo
        • MD_DataIdentification
          • citation
            • CI_Citation
              • title
                • CharacterString: Heat Flow Quality Analysis Toolbox (hfqa_tool)
              • date
                • CI_Date
                  • date
                    • Date: 2025-07-16
                  • 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/fidgeo.2025.043
              • citedResponsibleParty (xlink:href=http://orcid.org/0009-0002-6405-2996)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Chishti, Saman F.
                  • organisationName
                    • CharacterString: GFZ Helmholtz 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-8117-4576)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Balkan-Pazvantoğlu, Elif
                  • organisationName
                    • CharacterString: Dokuz Eylül University, Izmir, Türkiye
                  • 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-2228-9979)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Norden, Ben
                  • organisationName
                    • CharacterString: GFZ Helmholtz 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-9666-5087)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Neumann, Florian
                  • organisationName
                    • CharacterString: MARUM Center for Marine Environmental Sciences, University of Bremen, Bremen, 28334, 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-1479-787X)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Elbarbary, Samah
                  • organisationName
                    • CharacterString: GFZ Helmholtz 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/0009-0009-8028-7040)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Gross, Eskil S.
                  • organisationName
                    • CharacterString: GFZ Helmholtz 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-5439-4178)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Petrunin, Alexey G.
                  • organisationName
                    • CharacterString: GFZ Helmholtz 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-2896-6662)
                • CI_ResponsibleParty
                  • individualName
                    • CharacterString: Fuchs, Sven
                  • organisationName
                    • CharacterString: GFZ Helmholtz 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: Heat Flow Quality Analysis Toolbox hfqa_tool is a Python package containing tools for validating and evaluating the quality of heat flow data. It is designed for researchers and professionals. hfqa_tool simplifies heat flow data analysis by providing standardized and reproducible quality checks. This is developed in compliance with the paper by Fuchs et al. (2023) titled "Quality-assurance of heat-flow data: The new structure and evaluation scheme of the IHFC Global Heat Flow Database," published in Tectonophysics 863: 229976. Also revised for the newer release 2024. There are mainly 2 functions defined in this tool with description as follows: vocabulary_check(): This set of code has been developed to check whether all the values entered in a Heatflow database adhere to a controlled vocabulary and proper structure described in the aforementioned scientific paper. It generates an error message for each entry where the value entered is out of bounds and does not meet the assigned criteria. The code also enables checking the vocabulary for multiple values entered in a single column for a particular Heatflow data entry. It's a recommended prerequisite before calculating 'Quality Scores' for a given Heatflow dataset. quality_scores(): This code has been developed to assess the quality of the Heatflow database in terms of U-score (Uncertainty quantification), M-Score (Methodological quality), and P-Flags (Perturbation effects) adhering to the data structure described in the aforementioned scientific paper.
          • pointOfContact
            • CI_ResponsibleParty
              • individualName
                • CharacterString: Fuchs
              • organisationName
                • CharacterString: GFZ Helmholtz Centre for Geosciences, Potsdam, Germany
              • positionName
                • CharacterString: Sven
              • contactInfo
                • CI_Contact
                  • address
                    • CI_Address
                      • electronicMailAddress
                        • CharacterString: sven.fuchs(_at_)gfz.de
                  • onlineResource
                    • CI_OnlineResource
                      • linkage
                        • URL: https://www.gfz.de/en/staff/sven.fuchs
                      • 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): informtion
              • role
                • CI_RoleCode (codeList=http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode codeListValue=pointOfContact): pointOfContact
          • descriptiveKeywords
            • MD_Keywords
              • keyword
                • CharacterString: heat flow
              • keyword
                • CharacterString: Global Heat Flow Database
              • keyword
                • CharacterString: International Heat Flow Commission
              • keyword
                • CharacterString: data quality
          • descriptiveKeywords
            • MD_Keywords
              • keyword
                • CharacterString: EARTH SCIENCE > OCEANS > SEA ICE > HEAT FLUX
              • keyword
                • CharacterString: EARTH SCIENCE > SOLID EARTH > GEOTHERMAL DYNAMICS > GEOTHERMAL ENERGY
              • keyword
                • CharacterString: EARTH SCIENCE > SOLID EARTH > GEOTHERMAL DYNAMICS > GEOTHERMAL TEMPERATURE
              • 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://opensource.org/license/mit)
            • MD_Constraints
              • useLimitation
                • CharacterString: MIT Licence Copyright (c) <2024> the authors; GFZ Helmholtz Centre for Geosciences)
          • resourceConstraints
            • MD_LegalConstraints
              • accessConstraints
                • MD_RestrictionCode (codeList=http://www.isotc211.org/2005/resources/codeList.xml#MD_RestrictionCode codeListValue=otherRestrictions): 
              • otherConstraints
                • CharacterString: MIT Licence Copyright (c) <2024> the authors; GFZ Helmholtz Centre for Geosciences)
          • 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: DOI of paper when available
                  • codeSpace
                    • CharacterString: DOI
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=IsSupplementTo): IsSupplementTo
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: 10.1016/j.tecto.2023.229976
                  • codeSpace
                    • CharacterString: DOI
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=IsDocumentedBy): IsDocumentedBy
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: https://github.com/ihfc-iugg
                  • codeSpace
                    • CharacterString: URL
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=IsVariantFormOf): IsVariantFormOf
          • aggregationInfo
            • MD_AggregateInformation
              • aggregateDataSetIdentifier
                • RS_Identifier
                  • code
                    • CharacterString: 10.5880/fidgeo.2025.042
                  • 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.5880/fidgeo.2024.014
                  • codeSpace
                    • CharacterString: DOI
              • associationType
                • DS_AssociationTypeCode (codeList=http://datacite.org/schema/kernel-4 codeListValue=Cites): Cites
          • 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/fidgeo.2025.043
                  • 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: MIT Licence Copyright (c) <2024> the authors; GFZ Helmholtz Centre for Geosciences)