archetype (adl_version=1.4)
	openEHR-EHR-CLUSTER.lymph_node_metastases.v1

concept
	[at0000]	-- Tumour- Lymph node metastases
language
	original_language = <[ISO_639-1::en]>
description
	original_author = <
		["name"] = <"Dr Ian McNicoll">
		["organisation"] = <"Ocean Informatics, Scotland">
		["email"] = <"ian.mcnicoll@oceaninformatics.com">
		["date"] = <"17/05/2009">
	>
	details = <
		["en"] = <
			language = <[ISO_639-1::en]>
			purpose = <"To record detailed findings of lymph node metastases as part of microscopic histopathological examination of tissue. ">
			use = <"To record detailed findings about lymph node metastases as part of microscopic examination of tissue. 
Use as a component archetype in the context of a suite of archetypes that make up a histopathology report ie OBSERVATION.lab_test.histopathology.">
			keywords = <"tumour", "lymph node", "metastases", "pathology", "histopathology", "cancer", "malignancy">
			misuse = <"Not designed to be used within any other archetype other than OBSERVATION.lab_test.histopathology.">
			copyright = <"copyright (c) 2010 openEHR foundation">
		>
	>
	lifecycle_state = <"Initial">
	other_contributors = <>
	other_details = <
		["MD5-CAM-1.0.1"] = <"D90E73A53BAC2504891ADC7C748B3DF4">
		["references"] = <"">
	>

definition
	CLUSTER[at0000] matches {	-- Tumour- Lymph node metastases
		items cardinality matches {1..*; unordered} matches {
			ELEMENT[at0041] occurrences matches {0..1} matches {	-- Lymph node site name
				value matches {
					DV_TEXT matches {*}
				}
			}
			allow_archetype CLUSTER[at0010] occurrences matches {0..1} matches {	-- Lymph node site location     
				include
					archetype_id/value matches {/openEHR-EHR-CLUSTER\.anatomical_location-precise\.v1/}
				exclude
					archetype_id/value matches {/.*/}
			}
			ELEMENT[at0044] occurrences matches {0..1} matches {	-- Tissue available
				value matches {
					DV_CODED_TEXT matches {
						defining_code matches {
							[local::
							at0049, 	-- Present
							at0050]	-- Absent
						}
					}
				}
			}
			ELEMENT[at0025] occurrences matches {0..1} matches {	-- Tumour involvement
				value matches {
					DV_CODED_TEXT matches {
						defining_code matches {
							[local::
							at0042, 	-- Present
							at0026, 	-- Present - left side nodes only
							at0027, 	-- Present - right side nodes only
							at0028, 	-- Present - bilateral nodes
							at0029, 	-- Absent
							at0030, 	-- Equivocal
							at0031]	-- Indeterminate
						}
					}
				}
			}
			ELEMENT[at0011] occurrences matches {0..1} matches {	-- Nature of involvement
				value matches {
					DV_CODED_TEXT matches {
						defining_code matches {
							[local::
							at0012, 	-- Focal
							at0013, 	-- Diffuse
							at0024, 	-- Complete
							at0033]	-- Indeterminate
						}
					}
				}
			}
			ELEMENT[at0046] occurrences matches {0..1} matches {	-- Route of involvement
				value matches {
					DV_CODED_TEXT matches {
						defining_code matches {
							[local::
							at0047, 	-- Direct spread
							at0048]	-- Metastasis
						}
					}
				}
			}
			ELEMENT[at0001] occurrences matches {0..1} matches {	-- Number of nodes examined
				value matches {
					DV_COUNT matches {
						magnitude matches {|>=0|}
					}
				}
			}
			ELEMENT[at0002] occurrences matches {0..1} matches {	-- Number of nodes with tumour
				value matches {
					DV_COUNT matches {
						magnitude matches {|>=0|}
					}
				}
			}
			ELEMENT[at0009] occurrences matches {0..1} matches {	-- Extent of tumour
				value matches {
					C_DV_QUANTITY <
						property = <[openehr::122]>
						list = <
							["1"] = <
								units = <"mm">
								magnitude = <|>=0.0|>
							>
						>
					>
				}
			}
			CLUSTER[at0039] occurrences matches {0..1} matches {	-- Extra-nodal extension
				items cardinality matches {1..*; unordered} matches {
					ELEMENT[at0034] occurrences matches {0..1} matches {	-- Extra-capsular extension
						value matches {
							DV_CODED_TEXT matches {
								defining_code matches {
									[local::
									at0035, 	-- Present
									at0036, 	-- Absent
									at0037, 	-- Equivocal
									at0038]	-- Indeterminate
								}
							}
						}
					}
					ELEMENT[at0014] occurrences matches {0..1} matches {	-- Extent of extranodal tumour
						value matches {
							C_DV_QUANTITY <
								property = <[openehr::122]>
								list = <
									["1"] = <
										units = <"mm">
										magnitude = <|>=0.0|>
									>
								>
							>
						}
					}
				}
			}
			ELEMENT[at0040] occurrences matches {0..1} matches {	-- Description
				value matches {
					DV_TEXT matches {*}
				}
			}
			ELEMENT[at0051] occurrences matches {0..1} matches {	-- Marker dye uptake
				value matches {
					DV_TEXT matches {*}
				}
			}
			allow_archetype CLUSTER[at0045] occurrences matches {0..*} matches {	-- Lymph node details
				include
					archetype_id/value matches {/openEHR-EHR-CLUSTER\.lymph_node_metastases\.v1/}
				exclude
					archetype_id/value matches {/.*/}
			}
			ELEMENT[at0052] occurrences matches {0..1} matches {	-- Radioactivity count
				value matches {
					C_DV_QUANTITY <
						property = <[openehr::382]>
						list = <
							["1"] = <
								units = <"/s">
								magnitude = <|>=0.0|>
								precision = <|0|>
							>
							["2"] = <
								units = <"/min">
								magnitude = <|>=0.0|>
								precision = <|0|>
							>
						>
					>
				}
			}
		}
	}

ontology
	term_definitions = <
		["en"] = <
			items = <
				["at0000"] = <
					text = <"Tumour- Lymph node metastases">
					description = <"To record findings of tumour metastases in lymph nodes.">
				>
				["at0001"] = <
					text = <"Number of nodes examined">
					description = <"Number of nodes examined.">
				>
				["at0002"] = <
					text = <"Number of nodes with tumour">
					description = <"Number of nodes which show tumour involvement.">
				>
				["at0009"] = <
					text = <"Extent of tumour">
					description = <"Extent of tumour expressed as a maximum length. Applies only to an individual node.">
				>
				["at0010"] = <
					text = <"Lymph node site location     ">
					description = <"The anatomical location of the lymph node or site being reported.">
				>
				["at0011"] = <
					text = <"Nature of involvement">
					description = <"Nature or grade of the tumour, if present.">
				>
				["at0012"] = <
					text = <"Focal">
					description = <"The tumour is of a focal nature.">
				>
				["at0013"] = <
					text = <"Diffuse">
					description = <"The tumour is of a diffuse nature.">
				>
				["at0014"] = <
					text = <"Extent of extranodal tumour">
					description = <"Extent of extranodal tumour expressed as a maximum length.">
				>
				["at0024"] = <
					text = <"Complete">
					description = <"The node is completely invaded by tumour.">
				>
				["at0025"] = <
					text = <"Tumour involvement">
					description = <"Findings of lymph node involvement with tumour.">
				>
				["at0026"] = <
					text = <"Present - left side nodes only">
					description = <"Tumour is present in left sided nodes only.">
				>
				["at0027"] = <
					text = <"Present - right side nodes only">
					description = <"Tumour is present in right side nodes only.">
				>
				["at0028"] = <
					text = <"Present - bilateral nodes">
					description = <"Tumour is present in nodes on both sides.">
				>
				["at0029"] = <
					text = <"Absent">
					description = <"Tumour is absent from the lymph node site.">
				>
				["at0030"] = <
					text = <"Equivocal">
					description = <"Lymph node involvement by tumour is equivocal.">
				>
				["at0031"] = <
					text = <"Indeterminate">
					description = <"Llymph node involvement by tumour has not been determined.">
				>
				["at0033"] = <
					text = <"Indeterminate">
					description = <"The nature of tumour has not been determnined.">
				>
				["at0034"] = <
					text = <"Extra-capsular extension">
					description = <"Findings of extension of tumour beyond a node capsule.">
				>
				["at0035"] = <
					text = <"Present">
					description = <"Extra-capsular involvement by tumour is present.">
				>
				["at0036"] = <
					text = <"Absent">
					description = <"Extra-capsular involvement by tumour is absent.">
				>
				["at0037"] = <
					text = <"Equivocal">
					description = <"Extra-capsular involvement by tumour is equivocal.">
				>
				["at0038"] = <
					text = <"Indeterminate">
					description = <"Extra-capsular involvement by tumour has not been determined.">
				>
				["at0039"] = <
					text = <"Extra-nodal extension">
					description = <"Findings related to extension of tumour external to the nodal capsule.">
				>
				["at0040"] = <
					text = <"Description">
					description = <"A text description of lymph node involvement by tumour.">
				>
				["at0041"] = <
					text = <"Lymph node site name">
					description = <"The name for the lymph node site being reported. May be a general location e.g. 'Axillary nodes', a relative site e.g. 'Sentinel nodes' or a individual node.">
				>
				["at0042"] = <
					text = <"Present">
					description = <"Lymph node involvement with tumour is present.">
				>
				["at0044"] = <
					text = <"Tissue available">
					description = <"Has the appropriate lymph node tissue been made available for examination?">
				>
				["at0045"] = <
					text = <"Lymph node details">
					description = <"Further details of lymph node metastasis at this site e.g individual nodes or further levels">
				>
				["at0046"] = <
					text = <"Route of involvement">
					description = <"The route by which the tumour became involved in lymph node tissue.">
				>
				["at0047"] = <
					text = <"Direct spread">
					description = <"The tumour involved the lymph node by direct spread.">
				>
				["at0048"] = <
					text = <"Metastasis">
					description = <"The tumour involved the lymph node by metastasis.">
				>
				["at0049"] = <
					text = <"Present">
					description = <"Lymph node tissue is present.">
				>
				["at0050"] = <
					text = <"Absent">
					description = <"Lymph node tissue is absent.">
				>
				["at0051"] = <
					text = <"Marker dye uptake">
					description = <"Findings of whether marker dye has been taken up by the lymph node or lymph node group.">
				>
				["at0052"] = <
					text = <"Radioactivity count">
					description = <"Radioactivity count measured after use of radiocolloid. ">
				>
			>
		>
	>