archetype (adl_version=1.4)
	openEHR-EHR-EVALUATION.risk-family_history.v1
specialise
	openEHR-EHR-EVALUATION.risk.v1

concept
	[at0000.1]	-- Risk of condition based on family history
language
	original_language = <[ISO_639-1::en]>
description
	original_author = <
		["name"] = <"Sam Heard">
		["organisation"] = <"Ocean Informatics">
		["email"] = <"sam.heard@oceaninformatics.com">
		["date"] = <"23/04/2006">
	>
	details = <
		["en"] = <
			language = <[ISO_639-1::en]>
			purpose = <"Record the assessed risk of having or developing a condition due to prevalence in relatives.">
			use = <"For recording information about the prevalence of the condition in relatives and quantifying risk to the subject of care.">
			misuse = <"Not for recording problems of individual relatives - use 'openEHR-EHR-EVALUATION.problem' and 'openEHR-EHR-EVALUATION.problem-diagnosis' and set the subject of data to the relative.">
			copyright = <"© openEHR Foundation">
		>
	>
	lifecycle_state = <"AuthorDraft">
	other_contributors = <>
	other_details = <
		["MD5-CAM-1.0.1"] = <"FD88DDB4CA8FED5B68B6F3F245C3B868">
	>

definition
	EVALUATION[at0000.1] matches {	-- Risk of condition based on family history
		data matches {
			ITEM_TREE[at0001] matches {	-- structure
				items cardinality matches {1..*; ordered} matches {
					ELEMENT[at0002] matches {	-- Index condition
						value matches {
							DV_TEXT matches {*}
						}
					}
					allow_archetype CLUSTER[at0.40] occurrences matches {0..*} matches {	-- Genetic loci
						include
							archetype_id/value matches {/.*/}
					}
					ELEMENT[at0.31] occurrences matches {0..1} matches {	-- Presence
						value matches {
							DV_BOOLEAN matches {
								value matches {True, False}
							}
						}
					}
					ELEMENT[at0003.1] occurrences matches {0..1} matches {	-- Assessed risk
						value matches {
							DV_CODED_TEXT matches {
								defining_code matches {
									[local::
									at0006, 	-- Not significant
									at0007, 	-- Minimal significance
									at0008, 	-- Significant
									at0009]	-- Highly significant
								}
							}
						}
					}
					CLUSTER[at0.34] occurrences matches {0..1} matches {	-- Detailed risk results
						items cardinality matches {1..*; unordered} matches {
							ELEMENT[at0.35] occurrences matches {0..1} matches {	-- Analysis result
								value matches {
									DV_TEXT matches {*}
								}
							}
							ELEMENT[at0.36] occurrences matches {0..1} matches {	-- Probability
								value matches {
									DV_PROPORTION matches {*}
								}
							}
							ELEMENT[at0.37] occurrences matches {0..1} matches {	-- Percentage risk
								value matches {
									DV_PROPORTION matches {*}
								}
							}
							ELEMENT[at0.38] occurrences matches {0..1} matches {	-- Relative risk
								value matches {
									DV_PROPORTION matches {*}
								}
							}
						}
					}
					CLUSTER[at0.39] occurrences matches {0..1} matches {	-- Family history
						items cardinality matches {1..*; unordered} matches {
							allow_archetype CLUSTER[at0.32] occurrences matches {0..*} matches {	-- Genetic relative
								include
									archetype_id/value matches {/openEHR-EHR-CLUSTER\.genetic_relative(-[a-zA-Z0-9_]+)*\.v1/}
							}
							CLUSTER[at0.14] occurrences matches {0..*} matches {	-- Affected ratio
								items cardinality matches {1..4; ordered} matches {
									ELEMENT[at0.15] occurrences matches {0..1} matches {	-- Degree
										value matches {
											DV_CODED_TEXT matches {
												defining_code matches {
													[local::
													at0.16, 	-- First degree relatives
													at0.17, 	-- Second degree relatives
													at0.18, 	-- Third degree relatives
													at0.19, 	-- Maternal relatives
													at0.20, 	-- Paternal relatives
													at0.21]	-- Family
												}
											}
										}
									}
									ELEMENT[at0.22] occurrences matches {0..1} matches {	-- Gender
										value matches {
											DV_CODED_TEXT matches {
												defining_code matches {
													[local::
													at0.23, 	-- Male
													at0.24, 	-- Female
													at0.25]	-- Male and female
												}
											}
										}
									}
									ELEMENT[at0.26] occurrences matches {0..1} matches {	-- Number unaffected
										value matches {
											DV_COUNT matches {
												magnitude matches {|0..100|}
											}
										}
									}
									ELEMENT[at0.29] matches {	-- Number affected
										value matches {
											DV_COUNT matches {
												magnitude matches {|0..100|}
											}
										}
									}
								}
							}
						}
					}
				}
			}
		}
		protocol matches {
			ITEM_LIST[at0010] matches {	-- List
				items cardinality matches {0..*; unordered} matches {
					ELEMENT[at0011] occurrences matches {0..1} matches {	-- Risk calculation
						value matches {
							DV_TEXT matches {*}
						}
					}
				}
			}
		}
	}

ontology
	term_definitions = <
		["en"] = <
			items = <
				["at0.1"] = <
					text = <"Affected relatives">
					description = <"The family members affected by the condition">
				>
				["at0.10"] = <
					text = <"Moderate">
					description = <"Significant morbidity and reduced capability">
				>
				["at0.11"] = <
					text = <"Severe">
					description = <"Major morbidity with significant social impact">
				>
				["at0.12"] = <
					text = <"Clinical description">
					description = <"A clinical description of the affected relatives condition">
				>
				["at0.13"] = <
					text = <"Genetic relative">
					description = <"A genetic relative of the data subject - not an adoptive relative">
				>
				["at0.14"] = <
					text = <"Affected ratio">
					description = <"A ratio of the affected to non-affected relatives of a particular type">
				>
				["at0.15"] = <
					text = <"Degree">
					description = <"The proximity or line of the relatives">
				>
				["at0.16"] = <
					text = <"First degree relatives">
					description = <"Relatives with 50% genetic share - parent, sibling, child">
				>
				["at0.17"] = <
					text = <"Second degree relatives">
					description = <"Relatives with 25% genetic share - grand parent, aunts and uncles, nieces and nephews, grand children">
				>
				["at0.18"] = <
					text = <"Third degree relatives">
					description = <"Relatives with 12.5% genetic share, great grand parents, great aunts and uncles, first cousins, children of neices and nephews, great grand children">
				>
				["at0.19"] = <
					text = <"Maternal relatives">
					description = <"Related through mother">
				>
				["at0.2"] = <
					text = <"Relative">
					description = <"Details about the affected relative">
				>
				["at0.20"] = <
					text = <"Paternal relatives">
					description = <"Related through father">
				>
				["at0.21"] = <
					text = <"Family">
					description = <"Entire family">
				>
				["at0.22"] = <
					text = <"Gender">
					description = <"The gender of the relatives included in the affected ratio">
				>
				["at0.23"] = <
					text = <"Male">
					description = <"Male gender">
				>
				["at0.24"] = <
					text = <"Female">
					description = <"Female gender">
				>
				["at0.25"] = <
					text = <"Male and female">
					description = <"Male and female relatives">
				>
				["at0.26"] = <
					text = <"Number unaffected">
					description = <"The number of relatives in this group unaffected by the index condition">
				>
				["at0.27"] = <
					text = <"Date of onset">
					description = <"Date of onset">
				>
				["at0.28"] = <
					text = <"More specific condition">
					description = <"A coded entry which is more specific than the index condition">
				>
				["at0.29"] = <
					text = <"Number affected">
					description = <"The number affected by the index condition">
				>
				["at0.3"] = <
					text = <"Name">
					description = <"Optional name of the person for future reference">
				>
				["at0.30"] = <
					text = <"Relationship">
					description = <"The relationship">
				>
				["at0.31"] = <
					text = <"Presence">
					description = <"Presence of condition in at least one related party">
				>
				["at0.32"] = <
					text = <"Genetic relative">
					description = <"Relevant family genetic history. ">
				>
				["at0.33"] = <
					text = <"Risk assessment">
					description = <"*">
				>
				["at0.34"] = <
					text = <"Detailed risk results">
					description = <"*">
				>
				["at0.35"] = <
					text = <"Analysis result">
					description = <"*">
				>
				["at0.36"] = <
					text = <"Probability">
					description = <"*">
				>
				["at0.37"] = <
					text = <"Percentage risk">
					description = <"*">
				>
				["at0.38"] = <
					text = <"Relative risk">
					description = <"*">
				>
				["at0.39"] = <
					text = <"Family history">
					description = <"Relevant history in genetic relatives.">
				>
				["at0.4"] = <
					text = <"Age at onset">
					description = <"The age at which the condition was apparent">
				>
				["at0.40"] = <
					text = <"Genetic loci">
					description = <"*">
				>
				["at0.5"] = <
					text = <"Age at death">
					description = <"The age at which this relative died">
				>
				["at0.6"] = <
					text = <"Date of death">
					description = <"The year or date of death">
				>
				["at0.7"] = <
					text = <"Index condition was cause of death">
					description = <"Indication that the index was a significant factor in the death of this relative">
				>
				["at0.8"] = <
					text = <"Severity">
					description = <"The severity of the condition for this relative">
				>
				["at0.9"] = <
					text = <"Mild">
					description = <"Little affect on lifestyle">
				>
				["at0000"] = <
					text = <"Evaluation of risk of condition">
					description = <"Evaluation to indicate that there is, or is not, a significant risk of this subject of care having, now or in the future, a condition.">
				>
				["at0000.1"] = <
					text = <"Risk of condition based on family history">
					description = <"Evaluation to indicate that there is, or is not, a significant risk of this subject of care having, now or in the future, a condition due to prior occurrence in a family member.">
				>
				["at0001"] = <
					text = <"structure">
					description = <"@ internal @">
				>
				["at0002"] = <
					text = <"Index condition">
					description = <"The condition on which the risk assessment is focussed">
				>
				["at0003"] = <
					text = <"Significance of risk">
					description = <"The likelihood that this person will develop this condition or suffer in this way in the future">
				>
				["at0003.1"] = <
					text = <"Assessed risk">
					description = <"The degree of risk conferred on the subject by the presence of this condition amongst relatives">
				>
				["at0006"] = <
					text = <"Not significant">
					description = <"The person is not assessed at being at higher risk than the general population">
				>
				["at0007"] = <
					text = <"Minimal significance">
					description = <"The person may be of somewhat greater risk of developing the condition ">
				>
				["at0008"] = <
					text = <"Significant">
					description = <"The person is considered to be more likely to develop the condition than the general population">
				>
				["at0009"] = <
					text = <"Highly significant">
					description = <"The person is considered to be likely to develop the condition">
				>
				["at0010"] = <
					text = <"List">
					description = <"@ internal @">
				>
				["at0011"] = <
					text = <"Risk calculation">
					description = <"The means of calculating the risk">
				>
			>
		>
		["sl"] = <
			items = <
				["at0.1"] = <
					text = <"*Affected relatives(en)">
					description = <"*The family members affected by the condition(en)">
				>
				["at0.10"] = <
					text = <"*Moderate(en)">
					description = <"*Significant morbidity and reduced capability(en)">
				>
				["at0.11"] = <
					text = <"*Severe(en)">
					description = <"*Major morbidity with significant social impact(en)">
				>
				["at0.12"] = <
					text = <"*Clinical description(en)">
					description = <"*A clinical description of the affected relatives condition(en)">
				>
				["at0.13"] = <
					text = <"*Genetic relative(en)">
					description = <"*A genetic relative of the data subject - not an adoptive relative(en)">
				>
				["at0.14"] = <
					text = <"*Affected ratio(en)">
					description = <"*A ratio of the affected to non-affected relatives of a particular type(en)">
				>
				["at0.15"] = <
					text = <"*Degree(en)">
					description = <"*The proximity or line of the relatives(en)">
				>
				["at0.16"] = <
					text = <"*First degree relatives(en)">
					description = <"*Relatives with 50% genetic share - parent, sibling, child(en)">
				>
				["at0.17"] = <
					text = <"*Second degree relatives(en)">
					description = <"*Relatives with 25% genetic share - grand parent, aunts and uncles, nieces and nephews, grand children(en)">
				>
				["at0.18"] = <
					text = <"*Third degree relatives(en)">
					description = <"*Relatives with 12.5% genetic share, great grand parents, great aunts and uncles, first cousins, children of neices and nephews, great grand children(en)">
				>
				["at0.19"] = <
					text = <"*Maternal relatives(en)">
					description = <"*Related through mother(en)">
				>
				["at0.2"] = <
					text = <"*Relative(en)">
					description = <"*Details about the affected relative(en)">
				>
				["at0.20"] = <
					text = <"*Paternal relatives(en)">
					description = <"*Related through father(en)">
				>
				["at0.21"] = <
					text = <"*Family(en)">
					description = <"*Entire family(en)">
				>
				["at0.22"] = <
					text = <"*Gender(en)">
					description = <"*The gender of the relatives included in the affected ratio(en)">
				>
				["at0.23"] = <
					text = <"*Male(en)">
					description = <"*Male gender(en)">
				>
				["at0.24"] = <
					text = <"*Female(en)">
					description = <"*Female gender(en)">
				>
				["at0.25"] = <
					text = <"*Male and female(en)">
					description = <"*Male and female relatives(en)">
				>
				["at0.26"] = <
					text = <"*Number unaffected(en)">
					description = <"*The number of relatives in this group unaffected by the index condition(en)">
				>
				["at0.27"] = <
					text = <"*Date of onset(en)">
					description = <"*Date of onset(en)">
				>
				["at0.28"] = <
					text = <"*More specific condition(en)">
					description = <"*A coded entry which is more specific than the index condition(en)">
				>
				["at0.29"] = <
					text = <"*Number affected(en)">
					description = <"*The number affected by the index condition(en)">
				>
				["at0.3"] = <
					text = <"*Name(en)">
					description = <"*Optional name of the person for future reference(en)">
				>
				["at0.30"] = <
					text = <"*Relationship(en)">
					description = <"*The relationship(en)">
				>
				["at0.31"] = <
					text = <"*Presence(en)">
					description = <"*Presence of condition in at least one related party(en)">
				>
				["at0.32"] = <
					text = <"*Cluster(en)">
					description = <"**(en)">
				>
				["at0.33"] = <
					text = <"*New cluster(en)">
					description = <"**(en)">
				>
				["at0.34"] = <
					text = <"*New cluster(en)">
					description = <"**(en)">
				>
				["at0.35"] = <
					text = <"*New element(en)">
					description = <"**(en)">
				>
				["at0.36"] = <
					text = <"*New element(en)">
					description = <"**(en)">
				>
				["at0.37"] = <
					text = <"*New element(en)">
					description = <"**(en)">
				>
				["at0.38"] = <
					text = <"*New element(en)">
					description = <"**(en)">
				>
				["at0.39"] = <
					text = <"*New cluster(en)">
					description = <"**(en)">
				>
				["at0.4"] = <
					text = <"*Age at onset(en)">
					description = <"*The age at which the condition was apparent(en)">
				>
				["at0.40"] = <
					text = <"*Cluster(en)">
					description = <"**(en)">
				>
				["at0.5"] = <
					text = <"*Age at death(en)">
					description = <"*The age at which this relative died(en)">
				>
				["at0.6"] = <
					text = <"*Date of death(en)">
					description = <"*The year or date of death(en)">
				>
				["at0.7"] = <
					text = <"*Index condition was cause of death(en)">
					description = <"*Indication that the index was a significant factor in the death of this relative(en)">
				>
				["at0.8"] = <
					text = <"*Severity(en)">
					description = <"*The severity of the condition for this relative(en)">
				>
				["at0.9"] = <
					text = <"*Mild(en)">
					description = <"*Little affect on lifestyle(en)">
				>
				["at0000"] = <
					text = <"*Evaluation of risk of condition(en)">
					description = <"*Evaluation to indicate that there is, or is not, a significant risk of this subject of care having, now or in the future, a condition.(en)">
				>
				["at0000.1"] = <
					text = <"*Risk of condition based on family history(en)">
					description = <"*Evaluation to indicate that there is, or is not, a significant risk of this subject of care having, now or in the future, a condition due to prior occurrence in a family member.(en)">
				>
				["at0001"] = <
					text = <"*structure(en)">
					description = <"*@ internal @(en)">
				>
				["at0002"] = <
					text = <"*Index condition(en)">
					description = <"*The condition on which the risk assessment is focussed(en)">
				>
				["at0003"] = <
					text = <"*Significance of risk(en)">
					description = <"*The likelihood that this person will develop this condition or suffer in this way in the future(en)">
				>
				["at0003.1"] = <
					text = <"*Assessed risk(en)">
					description = <"*The degree of risk conferred on the subject by the presence of this condition amongst relatives(en)">
				>
				["at0006"] = <
					text = <"*Not significant(en)">
					description = <"*The person is not assessed at being at higher risk than the general population(en)">
				>
				["at0007"] = <
					text = <"*Minimal significance(en)">
					description = <"*The person may be of somewhat greater risk of developing the condition (en)">
				>
				["at0008"] = <
					text = <"*Significant(en)">
					description = <"*The person is considered to be more likely to develop the condition than the general population(en)">
				>
				["at0009"] = <
					text = <"*Highly significant(en)">
					description = <"*The person is considered to be likely to develop the condition(en)">
				>
				["at0010"] = <
					text = <"*List(en)">
					description = <"*@ internal @(en)">
				>
				["at0011"] = <
					text = <"*Risk calculation(en)">
					description = <"*The means of calculating the risk(en)">
				>
			>
		>
	>
	constraint_definitions = <
		["en"] = <
			items = <
				["ac0.1"] = <
					text = <"Relationship with subject of entry">
					description = <"The relationship of the affected relative with the person of whom this is the family history">
				>
				["ac0000"] = <
					text = <"Relationship">
					description = <"The relationship of this relative to the subject">
				>
			>
		>
		["sl"] = <
			items = <
				["ac0.1"] = <
					text = <"*Relationship with subject of entry(en)">
					description = <"*The relationship of the affected relative with the person of whom this is the family history(en)">
				>
				["ac0000"] = <
					text = <"*Relationship(en)">
					description = <"*The relationship of this relative to the subject(en)">
				>
			>
		>
	>