ARCHETYPE common_audiological_functional_parameters (openEHR-EHR-OBSERVATION.common_audiological_functional_parameters.v3)

Name: common_audiological_functional_parameters
License: http://creativecommons.org/licenses/by-sa/3.0/

ARCHETYPE ID	openEHR-EHR-OBSERVATION.common_audiological_functional_parameters.v3
Concept	common_audiological_functional_parameters
Description	A set of functional parameters that provides an abstract description of all relevant functional aspects of the human auditory system, with interpretation ranging from "normal" (0) to "maximally impaired" (1). The list of possible functional aspects corresponds to the definition of Buhl et al. (2019).
Use	Use to summarize data from audiological tests that were performed with humans in hearing aid acoustician, ENT physician, or research scenarios. CAFPAs can be estimated by human experts or predicted by machine learning algorithms.
Misuse	Not to be used to directly save measurement results (corresponding to a test corresponding to the respective functional parameter).
Purpose	To summarize data from different audiological tests (as performed in a certain clinic/database) in an independent and abstract representation of the human auditory system. Thereby, the CAFPAs are independent from the exact used tests for characterizing certain aspects of hearing loss in different clinical or research databases, and can be used to compare data from different databases.
References	Buhl M, Warzybok A, Schädler MR, Lenarz T, Majdani O, Kollmeier B. Common Audiological Functional Parameters (CAFPAs): statistical and compact representation of rehabilitative audiological classification based on expert knowledge. Int J Audiol. 2019 Apr;58(4):231-245. doi: 10.1080/14992027.2018.1554912. PMID: 30900518. Buhl M, Warzybok A, Schädler MR, Majdani O, Kollmeier B. Common Audiological Functional Parameters (CAFPAs) for single patient cases: deriving statistical models from an expert-labelled data set. Int J Audiol. 2020 Jul;59(7):534-547. doi: 10.1080/14992027.2020.1728401. Epub 2020 Feb 24. PMID: 32091289. Saak SK, Hildebrandt A, Kollmeier B, Buhl M. Predicting Common Audiological Functional Parameters (CAFPAs) as Interpretable Intermediate Representation in a Clinical Decision-Support System for Audiology. Front Digit Health. 2020 Dec 15;2:596433. doi: 10.3389/fdgth.2020.596433. PMID: 34713064; PMCID: PMC8521966. Buhl M, Akin G, Saak S, Eysholdt U, Radeloff A, Kollmeier B, Hildebrandt A. Expert validation of prediction models for a clinical decision-support system in audiology. Front Neurol. 2022 Aug 23;13:960012. doi: 10.3389/fneur.2022.960012. PMID: 36081868; PMCID: PMC9446152.
Copyright	© openEHR Foundation, HiGHmed
Authors	Author name: Mareike Buhl, Samira Saak Organisation: Institut de l'Audition, Institut Pasteur, Paris, France / University of Oldenburg and Cluster of Excellence Hearing4all, Germany Email: mareike.buhl@pasteur.fr Date originally authored: 2023-06-19
Other Details Language	Author name: Mareike Buhl, Samira Saak Organisation: Institut de l'Audition, Institut Pasteur, Paris, France / University of Oldenburg and Cluster of Excellence Hearing4all, Germany Email: mareike.buhl@pasteur.fr Date originally authored: 2023-06-19
OtherDetails Language Independent	{licence=This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/., custodian_organisation=HiGHmed, references=Buhl M, Warzybok A, Schädler MR, Lenarz T, Majdani O, Kollmeier B. Common Audiological Functional Parameters (CAFPAs): statistical and compact representation of rehabilitative audiological classification based on expert knowledge. Int J Audiol. 2019 Apr;58(4):231-245. doi: 10.1080/14992027.2018.1554912. PMID: 30900518. Buhl M, Warzybok A, Schädler MR, Majdani O, Kollmeier B. Common Audiological Functional Parameters (CAFPAs) for single patient cases: deriving statistical models from an expert-labelled data set. Int J Audiol. 2020 Jul;59(7):534-547. doi: 10.1080/14992027.2020.1728401. Epub 2020 Feb 24. PMID: 32091289. Saak SK, Hildebrandt A, Kollmeier B, Buhl M. Predicting Common Audiological Functional Parameters (CAFPAs) as Interpretable Intermediate Representation in a Clinical Decision-Support System for Audiology. Front Digit Health. 2020 Dec 15;2:596433. doi: 10.3389/fdgth.2020.596433. PMID: 34713064; PMCID: PMC8521966. Buhl M, Akin G, Saak S, Eysholdt U, Radeloff A, Kollmeier B, Hildebrandt A. Expert validation of prediction models for a clinical decision-support system in audiology. Front Neurol. 2022 Aug 23;13:960012. doi: 10.3389/fneur.2022.960012. PMID: 36081868; PMCID: PMC9446152., current_contact=Mareike Buhl, Institut de l'Audition, mareike.buhl@pasteur.fr, original_namespace=org.highmed, original_publisher=HiGHmed, custodian_namespace=org.highmed, MD5-CAM-1.0.1=D655E3AB1111C2DACFAF7B0783FB1F1B, build_uid=65914547-77cc-4b1f-b237-642e088cdaf9, revision=3.0.0-alpha}
Keywords	audiology, hearing loss, functional aspect, abstract representation, ...
Lifecycle	in_development
UID	cfef84ea-5157-42c9-a749-e2d11b2f4e6d
Language used	en
Citeable Identifier	1246.145.2160
Revision Number	3.0.0-alpha
All	Archetype [runtimeNameConstraintForConceptName=null, archetypeConceptBinding=null, archetypeConceptDescription=A set of functional parameters that provides an abstract description of all relevant functional aspects of the human auditory system, with interpretation ranging from "normal" (0) to "maximally impaired" (1). The list of possible functional aspects corresponds to the definition of Buhl et al. (2019). , archetypeConceptComment=null, otherContributors=, originalLanguage=en, translators=, subjectOfData=unconstrained, archetypeTranslationTree=null, topLevelToAshis={state=[], content=[], source=[], events=[ResourceSimplifiedHierarchyItem [path=/data[at0001]/events[at0002], code=at0002, itemType=EVENT, level=2, text=Any event, description=, comment=null, uncommonOntologyItems=null, occurencesFormal=0.., occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=EVENT, bindings=null, values=null, extendedValues=null]], capabilities=[], details=[], protocol=[ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0018], code=at0018, itemType=ELEMENT, level=2, text=Estimation, description=Procedure how CAFPAs were estimated, i.e., by experts (Buhl et al., 2020), by prediction (Saak et al., 2020), or by expert validation (Buhl et al., 2022). , comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_CODED_TEXT, bindings=null, values= at0019::Expert estimation [CAFPA value estimated by an expert, given audiological test results for a patient] at0020::Prediction [CAFPA value estimated by a prediction algorithm, given audiological test results for a patient] at0021::Expert validation [CAFPA value estimated by an expert, by checking and updating existing CAFPA values given audiological test results and predicted CAFPAs for a patient] , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0167], code=at0167, itemType=SLOT, level=2, text=Expert, description=Expert information as required in loaded archetype. , comment=Only required for expert estimation or expert validation., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Include:* .* or openEHR-EHR-CLUSTER.cafpaexpert.v0, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0169], code=at0169, itemType=ELEMENT, level=2, text=Database ID, description=ID of the database based on which CAFPAs were estimated (referring to an internal database containing more information about database)., comment=Could in the future be extended to a more exhaustive database description, for which a cluster (or cluster archetype) has to be defined. , uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_IDENTIFIER, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0042], code=at0042, itemType=CLUSTER, level=2, text=Expert procedure, description=Describes procedure for CAFPA estimation (only for expert estimation or expert validation), including instructions and methodological aspects. , comment=Only required for expert estimation or expert validation., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=1.., cardinalityText= (Cardinality: 1.., unordered), subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0042]/items[at0049], code=at0049, itemType=ELEMENT, level=3, text=Instructions, description=Instructions given to the expert (only for expert estimation or expert validation). , comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_CODED_TEXT, bindings=null, values= at0050::Text at0051::Video at0052::Personal explanation at0053::CAFPAs already familiar [Instructions not necessary for the respective expert] , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0042]/items[at0043], code=at0043, itemType=ELEMENT, level=3, text=Survey medium, description=Medium used for survey. , comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_CODED_TEXT, bindings=null, values= at0044::Paper sheet [CAFPA estimation performed on paper] at0045::Digital form [CAFPA estimation performed on a digital device, e.g., computer, tablet, etc.] , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0042]/items[at0171], code=at0171, itemType=ELEMENT, level=3, text=Survey version, description=Version number of the employed expert survey., comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0042]/items[at0046], code=at0046, itemType=ELEMENT, level=3, text=Patient contact, description=Describes if the expert met the patient during CAFPA estimation. , comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_CODED_TEXT, bindings=null, values= at0047::No [Default (so far only No)] at0048::Yes [Patient (and data) seen while estimating CAFPAs] Assumed value: No, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0024], code=at0024, itemType=CLUSTER, level=2, text=Prediction, description=Describes procedure used for CAFPA prediction. , comment=Only required if CAFPAs were estimated by prediction., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=1.., cardinalityText= (Cardinality: 1.., unordered), subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0024]/items[at0034], code=at0034, itemType=ELEMENT, level=3, text=Prediction model, description=Prediction model used., comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_CODED_TEXT, bindings=null, values= at0035::Random Forest at0036::Lasso Regression at0037::Elastic Net , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0024]/items[at0038], code=at0038, itemType=ELEMENT, level=3, text=Code version, description=Code version of prediction model. , comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0024]/items[at0168], code=at0168, itemType=ELEMENT, level=3, text=URL, description=Link to repository including the code. , comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0005]/items[at0031], code=at0031, itemType=ELEMENT, level=2, text=Measurement status, description=Specify if CAFPAs were estimated based on unaided or aided measurements (AG and speech test)., comment=(... needs more info if aided: which device, which ear etc. -> refer to archetypes for audiogram and speech test, respectively) (too much to include this information in the CAFPA archetype?) , uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_CODED_TEXT, bindings=null, values= at0032::Unaided [Measurements without hearing device (default)] at0033::Aided [Measurements with hearing device] Assumed value: Unaided, extendedValues=null]], provider=[], data=[ResourceSimplifiedHierarchyItem [path=/data[at0001]/events[at0002]/data[at0003]/items[at0073], code=at0073, itemType=CLUSTER, level=4, text=CAFPA, description=CAFPA value describing the status of a functional aspect of the human auditory system., comment=null, uncommonOntologyItems=null, occurencesFormal=1..10, occurencesText=Mandatory, cardinalityFormal=1.., cardinalityText= (Cardinality: 1.., unordered), subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/events[at0002]/data[at0003]/items[at0073]/items[at0151], code=at0151, itemType=ELEMENT, level=5, text=CAFPA name, description=Name of respective CAFPA according to definition of Buhl et al. (2019). , comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_CODED_TEXT, bindings=null, values= at0157::CA1 [Threshold, low frequencies] at0158::CA2 [Threshold, low-to-middle frequencies] at0159::CA3 [Threshold, middle-to-high frequencies] at0160::CA4 [Threshold, high frequencies] at0161::CU1 [Supra-threshold, low frequencies] at0162::CU2 [Supra-threshold, high frequencies] at0163::CB [Binaural] at0164::CN [Neural] at0165::CC [Cognitive] at0166::CE [Socio-economic] , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/events[at0002]/data[at0003]/items[at0073]/items[at0074], code=at0074, itemType=ELEMENT, level=5, text=CAFPA value, description=CAFPA value describing the status of a functional aspect of the human auditory system; from 0 "normal" to 1 "maximally impaired". , comment=(add additional reasons for null?) , uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Proportion Units: 0.0..1.0 , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/events[at0002]/data[at0003]/items[at0073]/items[at0075], code=at0075, itemType=ELEMENT, level=5, text=Certainty, description=Certainty of CAFPA estimation, indicated by expert or prediction model., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Proportion Units: 0.0..1.0 , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/events[at0002]/data[at0003]/items[at0073]/items[at0172], code=at0172, itemType=ELEMENT, level=5, text=Comment, description=Comment given by expert while estimating the CAFPA. , comment=Could be moved to the level of the complete CAFPA set for a certain patient, but this needs to be done on template level., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/archetype_details, code=null, itemType=UNSUPPORTEDTOPLEVELATTRIBUTE, level=0, text=Archetype Details, description=, comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=UNSUPPORTEDTOPLEVELATTRIBUTE, bindings=null, values=null, extendedValues=null]], activities=[], contacts=[], identities=[], relationships=[], description=[], ism_transition=[], target=[], credentials=[], items=[], context=[], other_participations=[]}, topLevelItems={protocol=ResourceSimplifiedHierarchyItem [path=ROOT_/protocol[at0005], code=at0005, itemType=ITEM_TREE, level=0, text=null, description=null, comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=0..1, cardinalityText=optional, subCardinalityFormal=0.., subCardinalityText=Minimum of 0 items (Cardinality: 0.., unordered), dataType=ITEM_TREE, bindings=null, values=null, extendedValues=null], data=ResourceSimplifiedHierarchyItem [path=ROOT_/data[at0001]/events[at0002]/data[at0003], code=at0003, itemType=ITEM_TREE, level=2, text=null, description=null, comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=0..1, cardinalityText=optional, subCardinalityFormal=0.., subCardinalityText=Minimum of 0 items (Cardinality: 0.., unordered), dataType=ITEM_TREE, bindings=null, values=null, extendedValues=null]}, addHierarchyItemsTo=data, currentHierarchyItemsForAdding=[ResourceSimplifiedHierarchyItem [path=/data[at0001]/events[at0002]/data[at0003]/items[at0073], code=at0073, itemType=CLUSTER, level=4, text=CAFPA, description=CAFPA value describing the status of a functional aspect of the human auditory system., comment=null, uncommonOntologyItems=null, occurencesFormal=1..10, occurencesText=Mandatory, cardinalityFormal=1.., cardinalityText= (Cardinality: 1.., unordered), subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/events[at0002]/data[at0003]/items[at0073]/items[at0151], code=at0151, itemType=ELEMENT, level=5, text=CAFPA name, description=Name of respective CAFPA according to definition of Buhl et al. (2019). , comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_CODED_TEXT, bindings=null, values= at0157::CA1 [Threshold, low frequencies] at0158::CA2 [Threshold, low-to-middle frequencies] at0159::CA3 [Threshold, middle-to-high frequencies] at0160::CA4 [Threshold, high frequencies] at0161::CU1 [Supra-threshold, low frequencies] at0162::CU2 [Supra-threshold, high frequencies] at0163::CB [Binaural] at0164::CN [Neural] at0165::CC [Cognitive] at0166::CE [Socio-economic] , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/events[at0002]/data[at0003]/items[at0073]/items[at0074], code=at0074, itemType=ELEMENT, level=5, text=CAFPA value, description=CAFPA value describing the status of a functional aspect of the human auditory system; from 0 "normal" to 1 "maximally impaired". , comment=(add additional reasons for null?) , uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Proportion Units: 0.0..1.0 , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/events[at0002]/data[at0003]/items[at0073]/items[at0075], code=at0075, itemType=ELEMENT, level=5, text=Certainty, description=Certainty of CAFPA estimation, indicated by expert or prediction model., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Proportion Units: 0.0..1.0 , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/events[at0002]/data[at0003]/items[at0073]/items[at0172], code=at0172, itemType=ELEMENT, level=5, text=Comment, description=Comment given by expert while estimating the CAFPA. , comment=Could be moved to the level of the complete CAFPA set for a certain patient, but this needs to be done on template level., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/archetype_details, code=null, itemType=UNSUPPORTEDTOPLEVELATTRIBUTE, level=0, text=Archetype Details, description=, comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=UNSUPPORTEDTOPLEVELATTRIBUTE, bindings=null, values=null, extendedValues=null]], minIndents={}, termBindingRetrievalErrorMessage=null]