Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: spell check fixes

Virtual Medical Record for Clinical Decision Support panel HL7.VMR-CDS https://s.details.loinc.org/LOINC/74028-2.html?sections=ComprehensiveThis appendix make use of aspects from "HL7 Version 2 Implementation Guide: Implementing the

Table of Contents

 

A9.1 Introduction

The HL7v2 Virtual Medical Record (VMR) is a way to implement a structured information atomically in a series of HL7 OBX segments following a template methodology. 

It is based upon the HL7 Publication "HL7 Version 2 Implementation Guide: Implementing the Virtual Medical Record for Clinical Decision Support (vMR-CDS), Release 1 " (you may need an account with HL7 International to download).

 

...

Suggested

OBX-5 Observation value

or

Value Set or Constraint

...

Refer to that document for a deeper understanding and discussion of the methodology. This appendix will simply provide a prescription for its implementation in a simple way.

The HL7v2 Virtual Medical Record is also defined by the LOINC as "Virtual Medical Record for Clinical Decision Support panel HL7.VMR-CDS" (74028-2). The panel definition can be viewed at the following URL: https://s.details.loinc.org/LOINC/74028-2.html?sections=Comprehensive

A9.2 Implementing the HL7v2 Virtual Medical Record with OBX segments

A9.2.1 Specifying the HL7v2 VMR is in use.

When using the HL7v2 VMR a header OBX must be present which indicates that a report template is in use. In the header, OBX-3 field must have the value "74028-2^Report template ID^LN", and the template that is in use OBX-5 must, and also specify an OBX-4 sub-ID which must be a dotted decimal value (for simplicity "1" has been specified as the root sub ID). This header OBX must have a OBX-2 Datatype field value of "RP" (See 3.20 RP - Reference Pointer). OBX-5 must be valued as "HL7V2-VMR.v1^HL7V2 VMR&99A-9AAC5A649D18B6F2&L^TX^Octet-stream".

Subsequently all other OBX segments present that form part of the HL7.VMR must have dotted sub id based on this OBX-4 sub-ID this header OBX.

Therefore as an example, the first OBX is static and must be as follows:

Code Block
OBX|1|RP|74028-2^Report template ID^LN|1|HL7V2-VMR.v1^HL7V2 VMR&99A-9AAC5A649D18B6F2&L^TX^Octet-stream||||||F

A9.2.2 Implementing each element of the HL7v2 VMR

The HL7v2 VMR OBX implementation table below defines the elements of the VMR and provides values that must be used in various OBX fields as indicated by the column headings. 

Each VMR element must be implemented as an OBX, the values of which will be discussed following the table.

When the row in the table has a VMR Datatype column of ENTRY, SECTION, STRUCTURAL, COLLECTION then the prescribed values in the table must be used. 

Technically, OBX for VMR Data SECTIOHTTPAccessControlAllowOriginManagerN, STRUCTURAL and COLLECTION are optional as the structure is implied by the dotted decimal structured OBX-4 Observation sub-ID. However, including these OBX segments can be useful to viewers of the atomic data but non-essential for computed interpretation of the actual content.

A9.2.2.1 HL7v2 VMR OBX implementation table

Refer to the legend table that follows after this table which explains the colours used. The colours are redundant and are indicative of certain values in the VMR Datatype column.

Anchor
A9.T.1
A9.T.1
A9.T.1 HL7v2 VMR OBX implementation table

Chief Complaint
Section Heading or ElementOBX-2 DataTypeOBX-3 ValueOBX-4 Observation sub-ID

Suggested

OBX-5 Observation value

or

Value Set or Constraint

OBX-14 Date/time of the observation is valued

(Y=Yes, N=No)

OCCURENCESVMR DATATYPE
Report template IDRP 1HL7V2-VMR.v1^HL7V2 VMR&99A-9AAC5A649D18B6F2&L^TX^Octet-stream 1ENTRY
History of Presenting ComplaintCWE73983-9^^LN1.134046-3^History of Presenting Complaint^LN 0..1SECTION
Chief ComplaintCWE10154-3^Chief Complaint^LN1.1.1Constraint (Child of Snomed-CT term 404684003 | Clinical finding (finding)) 0..1CODEDVALUE
Date of OnsetTS11368-8^Date of Onset^LN1.1.2  0..1DATETIME
NotesFT8251-1^Notes^LN1.1.3  0..1STRING
History of Past IllnessCWE73983-9^^LN1.211348-0^History of Past Illness^LN^417662000^History of Past Illness^SCT 0..1SECTION
Past Illness- 1.2.1.RepeatOf[CLUSTER -- Past Illness]  0..*STRUCTURAL
Past IllnessCWE11349-8^Past Illness^LN1.2.1.RepeatOf[CLUSTER -- Past Illness].1Constraint (Child of Snomed-CT term 404684003 | Clinical finding (finding)) 0..1CODEDVALUE
Temporal ContextCWE408731000^Temporal Context^SCT1.2.1.RepeatOf[CLUSTER -- Past Illness].2

Value Set (

15240007^Current^SCT

410511007^Current or past^SCT

410587003^Past - specified^SCT

410588008^Past - unspecified^SCT

410589000^All times past^SCT

6493001^Recent^SCT

)

 

If the temporal context is unspecified, then 410511007^Current or past^SCT is the assumed value.

 0..1CODEDVALUE
Illness DatesDR11368-8^Illness Dates^LN1.2.1.RepeatOf[CLUSTER -- Past Illness].3  0..1DATERANGE
Notes on IllnessFT8251-1^Notes on Illness^LN1.2.1.RepeatOf[CLUSTER -- Past Illness].4  0..1STRING
ProceduresCWE73983-9^^LN1.347519-4^^LN^416940007 0..1SECTION
Procedure-71388002^Procedure^SCT1.3.1.RepeatOf[CLUSTER -- Procedure]  0..*STRUCTURAL
Procedure PerformedCWE29300-1^Procedure Performed^LN1.3.1.RepeatOf[CLUSTER -- Procedure].1Constraint (Child of Snomed-CT term 71388002 | Procedure (procedure) |)Y0..1CODEDVALUE
Notes on ProcedureFT8251-1^Notes on Procedure^LN1.3.1.RepeatOf[CLUSTER -- Procedure].2  0..1STRING
Family HistoryCWE73983-9^^LN1.410157-6^Family History^LN 0..1SECTION
Patients Family Tree IDST74027-4^Patients Family Tree ID^LN1.4.1  0..1STRING
Natural Father IDST74026-6^Natural Father ID^LN1.4.2  0..1STRING
Natural Mother IDST74025-8^Natural Mother ID^LN1.4.3  0..1STRING
RelativesCWE73983-9^^LN1.4.4224086007^Relatives^SCT 0..1SECTION
Relative- 1.4.4.1.RepeatOf[CLUSTER -- Relative]  0..*STRUCTURAL
Relative NameST54138-3^Relative Name^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].1  0..1STRING
RelationshipCWE44767-2^Relationship^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].2

Constraint (HL7 v3 FamilyMember Value set = Child of Role Code _PersonalRelationshipRoleType FAMMEMB)

Use "ROLECODE" for Name of Coding System component of CWE

See Table HL7 v3 FamilyMember Value set below

 0..1CODEDVALUE
Relative IDST74024-1^Relative ID^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].3  0..1STRING
Natural Father IDST74026-6^Natural Father ID^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].4  0..1STRING
Natural Mother IDST74025-8^Natural Mother ID^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].5  0..1STRING
deceasedEstimatedAgeST39016-1^Deceased Estimated Age^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].6  0..1REAL
LivingEstimatedAgeST21612-7^Living Estimated Age^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].7  0..1REAL
Clinical Genomic ChoiceCWE73983-9^^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice]  0..*COLLECTION
Clinical ObservationCWE74023-3^Clinical Observation^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice].1  1..1CODEDVALUE
Negation IndicatorCWE74022-5^Negation Indicator^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice].2

Value Set (

31874001^True^SCT

64100000^False^SCT

64957009^Uncertain^SCT

)

 0..1
SECTIONLN
BOOLEAN
Cause of DeathCWE
10154-3Chief Complaint
74044-9^Cause of Death^LN1.4.
1.1Constraint (Child of Snomed-CT term 404684003 | Clinical finding (finding))
4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice].3

Value Set (

31874001^True^SCT

64100000^False^SCT

64957009^Uncertain^SCT

)

 0..1
CODEDVALUEDate of OnsetTS11368-8Date of OnsetLN1.1.2
BOOLEAN
DataEstimatedAgeST21611-9^Data Estimated Age^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice].4  0..1
DATETIME
REAL
Notes
Genetic Loci
FT1.1.3
ST
8251-1NotesLN
48018-6^Genetic Loci^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice].5.RepeatOf[ELEMENT -- Genetic Loci]  0..
1
*STRING
History of Past Illness
Genetic RisksCWE73983-9
 LN
^^LN1.4.
211348-0^History of Past Illness^LN^417662000^History of Past Illness^SCT
5106221001^Genetic Risks^SCT 0..1SECTION
Past Illness
Pedigree Analysis Results -
   
47708004^Pedigree Analysis Results^SCT1.
2.1.RepeatOf[CLUSTER -- Past Illness]  0..*STRUCTURALPast IllnessCWE11349-8Past IllnessLN1.2.
4.5.1.RepeatOf[CLUSTER --
Past Illness].1Constraint (Child of Snomed-CT term 404684003 | Clinical finding (finding))
Pedigree Analysis Results]  0..
1Temporal Context
*
CODEDVALUESCT
STRUCTURAL
Genetic Disease AssessedCWE
408731000Temporal Context
51967-8^Genetic Disease Assessed^LN1.4.
2
5.1.RepeatOf[CLUSTER --
Past Illness].2

Value Set (

15240007^Current^SCT

410511007^Current or past^SCT

410587003^Past - specified^SCT

410588008^Past - unspecified^SCT

410589000^All times past^SCT

6493001^Recent^SCT

)

 

If this field is unvalued, then 410511007^Current or past^SCT is the assumed value.

Pedigree Analysis Results].1  0..1CODEDVALUE
Illness Dates
Input Parameters
DRLN
CWE
11368-8Illness Dates
73983-9^^LN1.4.
2
5.1.RepeatOf[CLUSTER --
Past Illness
Pedigree Analysis Results].
3 1.2
273983-9^Input Parameters^LN 0..1
DATERANGENotes on IllnessFT8251-1Notes on IllnessLN
SECTION
Genetic Algorithm UsedCWE74021-7^Genetic Algorithm Used^LN1.4.5.1.RepeatOf[CLUSTER --
Past Illness].4
Pedigree Analysis Results].2.1  0..1
STRING
CODEDVALUE
Procedures
Sensitivity
CWE
NM
73983
74020-9
 LN1.347519-4^^LN^416940007Procedure-   1.3
^Sensitivity^LN1.4.5.1.RepeatOf[CLUSTER -- Pedigree Analysis Results].2.2  0..1PHYSICALQUANTITY
SECTION
Probability of DiseaseST74019-1^Probability of Disease^LN1.4.5.1.RepeatOf[CLUSTER -- Pedigree Analysis Results].3.RepeatOf[ELEMENT --
Procedure
Probability of Disease]  0..*
STRUCTURAL
REAL
Procedure PerformedLN
Pregnancy HistoryCWE
29300-1Procedure Performed
73983-9^^LN1.
3.1.RepeatOf[CLUSTER -- Procedure].1Constraint (Child of Snomed-CT term 71388002 | Procedure (procedure) |)Y
511449-6^Pregnancy History^LN 0..1
CODEDVALUE
SECTION
Notes on Procedure
Gravida
FT
NM
8251-
11996-6^Gravida^LN1.5.1
Notes on Procedure
 
LN
 
1
0.
3.1.RepeatOf[CLUSTER -- Procedure]
.1INTEGER
ParityNM11977-6^Parity^LN1.5.2  0..1
STRING
INTEGER
Family History
Miscarriages
CWELN
NM
73983-9 
11614-5^Miscarriages^LN1.5.
410157-6^Family History^LN1.4.1
3  0..1
SECTIONPatients Family Tree IDST74027-4Patients Family Tree IDLNNatural Father IDST74026-6Natural Father IDLN1.4.2
INTEGER
TerminationsNM11613-7^Terminations^LN1.5.4  0..1
STRING 
INTEGER
Social HistoryCWE73983-9^^LN1.629762-2^Social History^LN 0..1SECTION
Social SituationFT10166-7^Social Situation^LN1.6.1  0..1STRING
Natural Mother IDST74025-8Natural Mother IDLN1.4.3
Substance UseCWE73983-9^^LN1.718663-5^Substance Use^LN 0..1
STRING
SECTION
Relatives
Smoking HistoryCWE73983-9
 
^^LN
LN
1.
4
7.
4224086007^Relatives^SCT
111367-0^Smoking History^LN 0..1SECTION
Relative-   
Tobacco use and exposureCWE63638-1^Tobacco use and exposure^LN1.
4
7.
4
1.1
.RepeatOf[CLUSTER -- Relative] 

Value Set (

8517006^Ex-smoker^SCT

 43381005^Passive smoker^SCT

77176002^Smoker^SCT

8392000^Non-smoker^SCT

)

 0..
*1.4.4.1.RepeatOf[CLUSTER -- Relative].1
1
STRUCTURALRelative NameST54138-3Relative NameLN
CODEDVALUE
Tobacco smoking consumptionNM63858-5^Tobacco smoking consumption^LN1.7.1.2  0..1
STRING
PHYSICALQUANTITY
Relationship
Lifetime Intake
CWELN
NM
44767-2Relationship
74011-8^Lifetime Intake^LN1.
4.4
7.1.
RepeatOf[CLUSTER -- Relative].2

Constraint (HL7 v3 FamilyMember Value set = Child of Role Code _PersonalRelationshipRoleType FAMMEMB)

Use "ROLECODE" for Name of Coding System component of CWE

See Table HL7 v3 FamilyMember Value set below

3  0..1
CODEDVALUE
PHYSICALQUANTITY
Relative ID
Date Ceased
ST1.4.4.1.RepeatOf[CLUSTER -- Relative].3
DT
74024-1Relative IDLNLN
74010-0^Date Ceased^LN1.7.1.4  0..1
STRINGNatural Father IDST74026-6Natural Father ID
DATETIME
Alcohol IntakeCWE73983-9^^LN1.
4.4.1.RepeatOf[CLUSTER -- Relative].4 Natural Mother IDST74025-8Natural Mother IDLN
7.211330-8^Alcohol Intake^LN 0..1
STRING
SECTION
Alcohol IntakeCWE11331-6^Alcohol Intake^LN1.
4
7.
4
2.1
.RepeatOf[CLUSTER -- Relative].5 

Value Set (

82581004^Ex-drinker^SCT

105542008^Non - drinker^SCT

219006^Current drinker^SCT

)

 0..1
STRING
CODEDVALUE
deceasedEstimatedAge
Last Drank Alcohol
STLN
DT
39016-1deceasedEstimatedAge
74014-2^Last Drank Alcohol^LN1.
4
7.
4.1.RepeatOf[CLUSTER -- Relative].6LivingEstimatedAgeST LivingEstimatedAgeLN
2.2  0..1
REAL
DATETIME
30 day quantity and frequencyCWE73983-9^^LN1.
4
7.
4.1.RepeatOf[CLUSTER -- Relative].7 
2.3030301^30 day quantity and frequency^PHENX 0..1
REALClinical Genomic ChoiceCWE74042-3Clinical Genomic ChoiceLN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice]
SECTION
Number of days alcohol consumedNM63597-9^Number of days alcohol consumed^LN1.7.2.3.1  0..
*Clinical ObservationCWE74023-3Clinical ObservationLN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice].1
1
COLLECTION
INTEGER
Standard drinks per day on a drinking day in last 30 daysNM63598-7^Standard drinks per day on a drinking day in last 30 days^LN1.7.2.3.2  
1
0..1
CODEDVALUENegation IndicatorCWE74022-5Negation IndicatorLN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice].2
INTEGER
Average Daily Alcohol IntakeNM74013-4^Average Daily Alcohol Intake^LN1.7.2.4  0..1
BOOLEANCause of DeathCWE74044-9Cause of DeathLN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice].3
PHYSICALQUANTITY
Maximum Daily Standard DrinksNM63591-2^Maximum Daily Standard Drinks^LN1.7.2.5  0..1
BOOLEAN
PHYSICALQUANTITY
DataEstimatedAge
Years Alcohol Consumed
STLN
NM
21611-9DataEstimatedAge
74012-6^Years Alcohol Consumed^LN1.
4
7.
4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice].4 
2.6  0..1
REALGenetic LociST48018-6Genetic LociLN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice].5.RepeatOf[ELEMENT -- Genetic Loci]
PHYSICALQUANTITY
Alcohol abuse or dependence (e.g. DSM IV)CWE74043-1^Alcohol abuse or dependence (e.g. DSM IV)^LN1.7.2.7

Value Set (

31874001^True^SCT

64100000^False^SCT

64957009^Uncertain^SCT

)

 0..
*Genetic Risks
1
STRING
BOOLEAN
Other substance UseCWE73983-9
 
^^LN
LN
1.
4
7.
5106221001^Genetic Risks^SCT 
311342-3^Other substance Use^LN 0..1SECTION
Pedigree Analysis Results -  
Drug misuse detailsCWE228366006^Drug misuse details^SCT1.
4
7.
5
3.1.RepeatOf[
CLUSTER
ELEMENT --
Pedigree Analysis Results]  0..*STRUCTURALGenetic Disease AssessedCWE51967-8Genetic Disease AssessedLN1.4.5.1.RepeatOf[CLUSTER -- Pedigree Analysis Results].1 
Drug misuse details]

Value Set (

428659002^Amphetamine misuse^SCT

429179002^Antidepressant misuse^SCT

428623008^Barbiturate misuse^SCT

428823006^Cannabis misuse^SCT

429782000^Cocaine misuse^SCT

307052004^Illicit drug use^SCT

228376009^Inhales drugs^SCT

226034001^Injecting drug user^SCT

70545002^Narcotic drug user^SCT

105546006^Occasional drug abuser^SCT

228372006^Poly-drug misuser^SCT

428495004^Solvent misuse^SCT

228381000^Sniffs drugs^SCT

429512006^Methadone misuse^SCT

)

 0..
1
*CODEDVALUE
Input Parameters
Exercise HistoryCWE73983-9
 LN
^^LN1.
4.5.1.RepeatOf[CLUSTER -- Pedigree Analysis Results].273983-9^Input Parameters^LN
8266930008^Exercise History^SCT 0..1SECTION
Genetic Algorithm UsedLN
Currently ExercisingCWE
74021-7Genetic Algorithm Used
74008-4^Exercise intensity^LN1.
4.5.1.RepeatOf[CLUSTER -- Pedigree Analysis Results].2.1 
8.1

Value Set (

 160635005^Exercise grading unknown^SCT

160633003^Enjoys heavy exercise^SCT

160645007^Enjoys intermediate exercise^SCT

228446001^Gets little exercise^SCT

228445002^Gets no exercise^SCT

160631001^Enjoys light exercise^SCT

160632008^Enjoys moderate exercise^SCT

102533007^Excessive exercise^SCT

)

 0..1CODEDVALUE
Sensitivity
Exercise Type
NMLN
CWE
74020-9Sensitivity
55410-5^Exercise Type^LN1.
4.5.1.RepeatOf[CLUSTER -- Pedigree Analysis Results].2.2 
8.2

Value Set (

229072005^Aerobic^SCT

)

 0..1
PHYSICALQUANTITYProbability of DiseaseST74019-1Probability of DiseaseLN1.4.5.1.RepeatOf[CLUSTER -- Pedigree Analysis Results].3.RepeatOf[ELEMENT -- Probability of Disease]
CODEDVALUE
Time Spent ExercisingNM74009-2^Time Spent Exercising^LN1.8.3  0..
*
1
REAL
PHYSICALQUANTITY
Pregnancy History
VitalsCWE73983-9
 LN
^^LN1.
5
9
11449
8716-
6^Pregnancy History^LN
3^Vitals^LN 0..1SECTION
Gravida
Blood Pressure
NM
CWE
11996
73983-
6GravidaLN
9^^LN1.
5
9.1
 
.RepeatOf[CLUSTER -- Blood Pressure]55417-0^Blood Pressure^LN 0..
1
*
INTEGER
COLLECTION
Parity
Systolic PressureNM
11977
8480-6
ParityLN1.5.2
^Systolic Pressure^LN1.9.1.RepeatOf[CLUSTER -- Blood Pressure].1 
 
Y0..1
INTEGER
PHYSICALQUANTITY
Miscarriages
Diastolic PressureNM
11614
8462-
5MiscarriagesLN1.5.3
4^Diastolic Pressure^LN1.9.1.RepeatOf[CLUSTER -- Blood Pressure].2  0..1
INTEGER
PHYSICALQUANTITY
Terminations
Patient Position
NM
CWE
11613
8361-
7TerminationsLN1.5.4 
8^Patient Position^LN1.9.1.RepeatOf[CLUSTER -- Blood Pressure].3

Value Set (

33586001^Sitting^SCT

102538003^Lying^SCT

272580008^Semi-recumbent^SCT

10904000^Standing^SCT

)

 0..1
INTEGER
CODEDVALUE
Social History
Pulse rate
CWE 
NM
73983-9 LN1.629762-2^Social History^LN
8893-0^Pulse rate^LN1.9.2.RepeatOf[ELEMENT -- Pulse rate] Y0..
1
*
SECTION
PHYSICALQUANTITY
Social Situation
Weight
FT
NM
10166
29463-7
Social SituationLN
^Weight^LN1.9.
6.1
3.RepeatOf[ELEMENT -- Weight] 
 
Y0..
1
*
STRING
PHYSICALQUANTITY
Substance Use
BMI
CWE 
NM
73983-9 LN1.718663-5^Substance Use^LN
39156-5^BMI^LN1.9.4.RepeatOf[ELEMENT -- BMI] Y0..
1SECTIONSmoking HistoryCWE73983-9 LN1.7.111367-0^Smoking History^LN 
*PHYSICALQUANTITY
Oxygen SaturationNM59408-5^Oxygen Saturation^LN1.9.5.RepeatOf[ELEMENT -- Oxygen Saturation] Y0..
1LN
*
SECTIONTobacco use and exposureCWE63638-1Tobacco use and exposure
PHYSICALQUANTITY
HeightNM8302-2^Height^LN1.
7
9.
1.1

Suggested Value Set (

8517006^Ex-smoker^SCT

 43381005^Passive smoker^SCT

77176002^Smoker^SCT

8392000^Non-smoker^SCT

)

 0..1CODEDVALUETobacco smoking consumptionNM63858-5Tobacco smoking consumptionLN1.7.1.2  0..1PHYSICALQUANTITYLifetime IntakeNM74011-8Lifetime IntakeLN1.7.1.3
6.RepeatOf[ELEMENT -- Height] Y0..*PHYSICALQUANTITY
TemperatureNM8310-5^Temperature^LN1.9.7.RepeatOf[ELEMENT -- Temperature] Y0..*PHYSICALQUANTITY
Respiratory rateNM9279-1^Respiratory rate^LN1.9.8.RepeatOf[ELEMENT -- Respiratory rate]  0..
1
*PHYSICALQUANTITY
Date Ceased
Alerts
DTLN
CWE
74010-0Date Ceased
73983-9^^LN1.
7.1.4 
1044944-7^Alerts^LN 0..1
DATETIME73983-9
SECTION
Alcohol IntakeCWE
Alert - 
LN
1.10.
7.211330-8^Alcohol Intake^LN
1.RepeatOf[CLUSTER -- Alert]  0..
1
*
SECTION
STRUCTURAL
Alcohol IntakeLN
Alert TypeCWE
11331-6Alcohol Intake
74018-3^Alert Type^LN1.10.
7.2
1.RepeatOf[CLUSTER -- Alert].1
Suggested

Value Set (

82581004^Ex-drinker^SCT

105542008^Non - drinker^SCT

219006^Current drinker^SCT

129697009^Psychosocial^SCT

307824009^Administrative^SCT

281694009^Clinical^SCT

102487004^Environmental^SCT

78648007^Infection risk^SCT

405145004^Safety and security^SCT

363871006^Special Mental Health^SCT

315638005^Special needs and/or preferences^SCT

)

 0..1CODEDVALUE
Last Drank Alcohol
Active
DTLN
CWE
74014-2Last Drank Alcohol
74017-5^Active^LN1.10.
7.2.2 
1.RepeatOf[CLUSTER -- Alert].2

Value Set (

31874001^True^SCT

64100000^False^SCT

64957009^Uncertain^SCT

)

 0..1
DATETIME30 day quantity and frequencyLN
BOOLEAN
Specific AlertCWE
73983-9 
44944-7^Specific Alert^LN1.
7
10.
2.373983-9^30 day quantity and frequency^LN 0..1SECTIONNumber of days alcohol consumedNM63597-9Number of days alcohol consumedLN1.7.2.3.1 Standard drinks per day on a drinking day in last 30 daysNM63598-7Standard drinks per day on a drinking day in last 30 daysLN1.7.2.3.2  0..1INTEGERAverage Daily Alcohol IntakeNM74013-4Average Daily Alcohol IntakeLN1.7.2.4 
1.RepeatOf[CLUSTER -- Alert].3

Suggested Value Set (

40739000^Has difficulty swallowing^SCT

224331001^Known to police^SCT

224347004^Has enduring power of attorney^SCT

310301000^Has advance health directive^SCT

)

 0..1
INTEGERMaximum Daily Standard DrinksNM63591-2Maximum Daily Standard DrinksLN1.7.2
CODEDVALUE
Reported byCWE48766-0^Reported by^LN1.10.1.RepeatOf[CLUSTER -- Alert].4

Value Set (

116154003^Subject of care^SCT

229774002^Carer^SCT

223366009^Health worker^SCT

307982007^Social services provider^SCT

14406004^Police^SCT

303071001^Family member^SCT

113163005^Friend^SCT

)

 0..1
PHYSICALQUANTITY
CODEDVALUE
Recorded dateDT74015-9^Recorded date^LN1.10.1.RepeatOf[CLUSTER -- Alert].5  0..1
PHYSICALQUANTITYYears Alcohol ConsumedNM74012-6Years Alcohol ConsumedLN1.7.2.6  0..1PHYSICALQUANTITYAlcohol abuse or dependence (eg DSM IV)CWE74043-1Alcohol abuse or dependence (eg DSM IV)LN1.7.2.7  0..1BOOLEANOther substance UseCWE73983-9 LN1.7.311342-3^Other substance Use^LN 0..1SECTIONDrug misuse detailsCWE228366006Drug misuse detailsSCT1.7.3.1.RepeatOf[ELEMENT -- Drug misuse details]

Suggested Value Set (

428659002^Amphetamine misuse^SCT

429179002^Antidepressant misuse^SCT

428623008^Barbiturate misuse^SCT

428823006^Cannabis misuse^SCT

429782000^Cocaine misuse^SCT

307052004^Illicit drug use^SCT

228376009^Inhales drugs^SCT

226034001^Injecting drug user^SCT

70545002^Narcotic drug user^SCT

105546006^Occasional drug abuser^SCT

228372006^Poly-drug misuser^SCT

428495004^Solvent misuse^SCT

228381000^Sniffs drugs^SCT

429512006^Methadone misuse^SCT

)

 0..*CODEDVALUEExercise HistoryCWE73983-9 LN1.8266930008^Exercise History^SCT 0..1SECTIONCurrently ExercisingCWE74008-4Currently ExercisingLN1.8.1

Suggested Value Set (160635005^Exercise grading unknown^SCT

160633003^Enjoys heavy exercise^SCT

160645007^Enjoys intermediate exercise^SCT

228446001^Gets little exercise^SCT

228445002^Gets no exercise^SCT

160631001^Enjoys light exercise^SCT

160632008^Enjoys moderate exercise^SCT

102533007^Excessive exercise^SCT

)

 0..1CODEDVALUEExercise TypeCWE73986-2Exercise TypeLN1.8.2

Suggested value Set (

229072005^Aerobic^SCT

)

 0..1CODEDVALUETime Spent ExercisingNM74009-2Time Spent ExercisingLN1.8.3  0..1PHYSICALQUANTITYVitalsCWE73983-9 LN1.98716-3^Vitals^LN 0..1SECTIONBlood PressureCWE73983-9 LN1.9
DATETIME

Legend:

Item TypeRow Colour
ElementWhite
SectionBlue
Structural NodeRed
Collection NodeYellow

A9.2.2.2 OBX-2 DataType (ID)

Each OBX must have it's OBX-2 value as specified exactly as per the HL7v2 VMR OBX implementation table.

A9.2.2.3 OBX-3 Observation Identifier (CE)

The OBX-3 values used by the HL7v2 VMR are defined by the LOINC Virtual Medical Record for Clinical Decision Support panel HL7.VMR-CDS (74028-2). The panel definition can be viewed at the following URL: https://s.details.loinc.org/LOINC/74028-2.html?sections=Comprehensive

A9.2.3.4 OBX-4 Observation sub-ID (ST)

In the table A9.T.1 OBX-4 subIDs are dotted decimals that start with "1" which is the root OBX-4 subID for all elements of the HL7v2 Virtual Medical Record. The root value "1" has been specified in the above table to aid in simplicity. Theoretically other subID root values could be used instead of "1", but this value must be practical in most cases.

Observations which are not specified by the HL7v2 VMR must not have a OBX-4 subID sharing the same root.

Rows marked VMR DATATYPE column as STRUCTURAL (red rows) must not be written to OBX segments and are present in the table are purely virtual and are to assist with understanding the hierarchy. They must be allocated a dotted subID however, on which all child elements must be prefixed with this subID. 

A9.2.3.4.1 Example of use of Past Illness VMR elements

By example consider the history of past illness from the above table. Here is the subset for convenience.

Section Heading or ElementOBX-2 DataTypeOBX-3 ValueOBX-4 Observation sub-IDOCCURENCESVMR DATATYPE
History of Past IllnessCWE73983-9^^LN1.20..1SECTION
Past Illness- 1.2.1.RepeatOf[CLUSTER -- Past Illness]0..*STRUCTURAL
Past IllnessCWE11349-8^Past Illness^LN1.2.1.RepeatOf[CLUSTER --

...

Past Illness].10..

...

Suggested Value Set (

33586001^Sitting^SCT

102538003^Lying^SCT

272580008^Semi-recumbent^SCT

10904000^Standing^SCT

)

...

Suggested Value Set (

129697009^Psychosocial^SCT

307824009^Administrative^SCT

281694009^Clinical^SCT

102487004^Environmental^SCT

78648007^Infection risk^SCT

405145004^Safety and security^SCT

363871006^Special Mental Health^SCT

315638005^Special needs and/or preferences^SCT

)

...

1

...

CODEDVALUE

For items in the table with occurrences with an upper bound > 1 (e.g. 0..*) that element will have "RepeatOf[]"  specified in the OBX-4 Observation sub-ID. The "RepeatOf[]" must be substituted with the repeat index integer of the element/structural/section group. All child elements for the repeat index must be prefixed with this sub-ID value.

For example, the first instance of a past illness the OBX-4 sub-ID must be 1.2.1.1, for the second 1.2.1.2.

Based on this the Past Illness OBXes for the first illness must have a OBX-4 sub-ID value of 1.2.1.1.1, and for the second illness, the OBX-4 sub-ID value must be 1.2.1.2.1.

 

Code Block
titleExample of OBX segments with subIDs indicating 2 past illnesses
OBX|6|CE|70949-3^^LN|1.2|11348-0^History of Past Illness^LN^417662000^History of Past Illness^SCT||||||F
OBX|7|CE|11349-8^Past Illness^LN|1.2.1.1.1|50711007^Viral hepatitis C^SCT||||||F
OBX|8|CE|408731000^Temporal Context^SCT|1.2.1.1.2|410584005^Current - specified^SCT||||||F
OBX|9|DR|11368-8^Illness Dates^LN|1.2.1.1.3|20090107||||||F
OBX|10|CE|11349-8^Past Illness^LN|1.2.1.2.1|6142004^Influenza^SCT||||||F
OBX|11|CE|408731000^Temporal Context^SCT|1.2.1.2.2|410587003^Past - specified^SCT||||||F
OBX|12|DR|11368-8^Illness Dates^LN|1.2.1.2.3|20170131^20170318||||||F

OBXs with OBX-1 Set ID of 7,8,9 are part of the first illness as their OBX-4 subID is prefixed with 1.2.1.1.

OBX  with OBX-1 Set ID 10,11,12 are part of the second illness as their OBX-4 subID is prefixed with 1.2.1.2.

A9.2.3.4.2 Use of complex OBX-4 with multiple nested repeating elements

Structures may repeat at multiple levels. A complex example is the Genetic Loci element which may have many 0.* for each of the repeating Clinical Genomic Choice collection (0...*) for each relative. For convenience see the subset of the table here:

Section Heading or ElementOBX-2 DataTypeOBX-3 ValueOBX-4 Observation sub-IDOCCURENCESVMR DATATYPE
RelativesCWE73983-9^^LN1.4.40..1SECTION
Relative- 1.4.4.1.RepeatOf[CLUSTER --

...

Relative]0..

...

Suggested Value Set (

40739000^Has difficulty swallowing^SCT

224331001^Known to police^SCT

224347004^Has enduring power of attorney^SCT

310301000^Has advance health directive^SCT

)

...

*STRUCTURAL
...     
Clinical Genomic ChoiceCWE73983-9^^LN1.4.4.1.RepeatOf[CLUSTER --

...

Relative]

...

Suggested Value Set (

116154003^Subject of care^SCT

229774002^Carer^SCT

223366009^Health worker^SCT

307982007^Social services provider^SCT

14406004^Police^SCT

303071001^Family member^SCT

113163005^Friend^SCT

)

...

.8.RepeatOf[CLUSTER -- Clinical Genomic Choice]0..*COLLECTION
Clinical ObservationCWE74023-3^Clinical Observation^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER -- Clinical Genomic Choice].11..1CODEDVALUE

...

Genetic Loci

...

ST48018-6^Genetic Loci^LN1.4.4.1.RepeatOf[CLUSTER -- Relative].8.RepeatOf[CLUSTER --

...

Clinical Genomic Choice].5

...

.RepeatOf[ELEMENT -- Genetic Loci]0..

...

 

Nodes marked VMR STRUCTURAL should not be written to OBX segments and are present in the table to assist with understanding the hierarchy.

The Report Template OBX must be specified and its OBX-4 column SubID must be a dotted decimal value, for this profile "1" has been specified as the root sub ID. All other HL7.VMR OBX subID should have dotted sub id based on this.

 

The first OBX is static and should be as follows:

Code Block
OBX|1|RP|74028-2^Report template ID^LN|1|HL7V2-VMR.v1^HL7V2 VMR&99A-9AAC5A649D18B6F2&L^TX^Octet-stream||||||F

 

 

Code Block
OBX|2|CWE|73983-9^^LN^CLUSTER^^EN 13606|1.1|^History of Presenting Complaint||||||F

 

...

*

...

STRING

As an example the OBX-4 sub-ID value for the fourth Genetic Loci for the second relative's third clinical genomic choice would be (note the variable parts of the sub-ID are indicated bold): 1.4.4.1.2.8.3.5.4

A9.2.3.5 OBX-5 Observation value (*)

OBX-5 is a variable datatype and the datatype used in each instance as specified in OBX-2.

OBX-5 value domains in table A9.T.1 are suggested and recommended. Howevervalues only, sending systems should must use the values that they have available in their systems. If common standard terminologies are available, then those can be supplied as alternative code components of the CE/CWE/CNE if a standard terminology isn't used aren't the primary coding system. Where no codes is available then only the text component must be populated.

 

A9.3 Value Domain Tables

Anchor
Table-FAMMEMB
Table-FAMMEMB
Table HL7 v3 FamilyMember Value set
LevelCodeDisplayDefinition
1(_PersonalRelationshipRoleType) Abstract  
2  FAMMEMBfamily memberA relationship between two people characterizing their "familial" relationship
3    CHILDchildThe player of the role is a child of the scoping entity.
4      CHLDADOPTadopted childThe player of the role is a child taken into a family through legal means and raised by the scoping person (parent) as his or her own child.
5        DAUADOPTadopted daughterThe player of the role is a female child taken into a family through legal means and raised by the scoping person (parent) as his or her own child.
5        SONADOPTadopted sonThe player of the role is a male child taken into a family through legal means and raised by the scoping person (parent) as his or her own child.
4      CHLDFOSTfoster childThe player of the role is a child receiving parental care and nurture from the scoping person (parent) but not related to him or her through legal or blood ties.
5        DAUFOSTfoster daughterThe player of the role is a female child receiving parental care and nurture from the scoping person (parent) but not related to him or her through legal or blood ties.
5        SONFOSTfoster sonThe player of the role is a male child receiving parental care and nurture from the scoping person (parent) but not related to him or her through legal or blood ties.
4      DAUCdaughterDescription: The player of the role is a female child (of any type) of scoping entity (parent)
5        DAUADOPT  
5        DAUFOST  
5        DAUnatural daughterThe player of the role is a female offspring of the scoping entity (parent).
5        STPDAUstepdaughterThe player of the role is a daughter of the scoping person's spouse by a previous union.
4      NCHILDnatural childThe player of the role is an offspring of the scoping entity as determined by birth.
5        DAU  
5        SONnatural sonThe player of the role is a male offspring of the scoping entity (parent).
4      SONCsonDescription: The player of the role is a male child (of any type) of scoping entity (parent)
5        SONADOPT  
5        SONFOST  
5        SON  
5        STPSONstepsonThe player of the role is a son of the scoping person's spouse by a previous union.
4      STPCHLDstep childThe player of the role is a child of the scoping person's spouse by a previous union.
5        STPDAU  
5        STPSON  
3    EXTextended family memberDescription: A family member not having an immediate genetic or legal relationship e.g. Aunt, cousin, great grandparent, grandchild, grandparent, niece, nephew or uncle.
4      AUNTauntThe player of the role is a sister of the scoping person's mother or father.
5        MAUNTmaternal auntDescription: The player of the role is a biological sister of the scoping person's biological mother.
5        PAUNTpaternal auntDescription: The player of the role is a biological sister of the scoping person's biological father.
4      COUSNcousinThe player of the role is a relative of the scoping person descended from a common ancestor, such as a grandparent, by two or more steps in a diverging line.
5        MCOUSNmaternal cousinDescription: The player of the role is a biological relative of the scoping person descended from a common ancestor on the player's mother's side, such as a grandparent, by two or more steps in a diverging line.
5        PCOUSNpaternal cousinDescription: The player of the role is a biological relative of the scoping person descended from a common ancestor on the player's father's side, such as a grandparent, by two or more steps in a diverging line.
4      GGRPRNgreat grandparentThe player of the role is a parent of the scoping person's grandparent.
5        GGRFTHgreat grandfatherThe player of the role is the father of the scoping person's grandparent.
6          MGGRFTHmaternal great-grandfatherDescription: The player of the role is the biological father of the scoping person's biological mother's parent.
6          PGGRFTHpaternal great-grandfatherDescription: The player of the role is the biological father of the scoping person's biological father's parent.
5        GGRMTHgreat grandmotherThe player of the role is the mother of the scoping person's grandparent.
6          MGGRMTHmaternal great-grandmotherDescription: The player of the role is the biological mother of the scoping person's biological mother's parent.
6          PGGRMTHpaternal great-grandmotherDescription: The player of the role is the biological mother of the scoping person's biological father's parent.
5        MGGRPRNmaternal great-grandparentDescription: The player of the role is a biological parent of the scoping person's biological mother's parent.
6          MGGRFTH  
6          MGGRMTH  
5        PGGRPRNpaternal great-grandparentDescription: The player of the role is a biological parent of the scoping person's biological father's parent.
6          PGGRFTH  
6          PGGRMTH  
4      GRNDCHILDgrandchildThe player of the role is a child of the scoping person's son or daughter.
5        GRNDDAUgranddaughterThe player of the role is a daughter of the scoping person's son or daughter.
5        GRNDSONgrandsonThe player of the role is a son of the scoping person's son or daughter.
4      GRPRNgrandparentThe player of the role is a parent of the scoping person's mother or father.
5        GRFTHgrandfatherThe player of the role is the father of the scoping person's mother or father.
6          MGRFTHmaternal grandfatherDescription: The player of the role is the biological father of the scoping person's biological mother.
6          PGRFTHpaternal grandfatherDescription: The player of the role is the biological father of the scoping person's biological father.
5        GRMTHgrandmotherThe player of the role is the mother of the scoping person's mother or father.
6          MGRMTHmaternal grandmotherDescription: The player of the role is the biological mother of the scoping person's biological mother.
6          PGRMTHpaternal grandmotherDescription: The player of the role is the biological mother of the scoping person's biological father.
5        MGRPRNmaternal grandparentDescription: The player of the role is the biological parent of the scoping person's biological mother.
6          MGRFTH  
6          MGRMTH  
5        PGRPRNpaternal grandparentDescription: The player of the role is the biological parent of the scoping person's biological father.
6          PGRFTH  
6          PGRMTH  
4      INLAWinlawA relationship between an individual and a member of their spousal partner's immediate family.
5        CHLDINLAWchild-in-lawThe player of the role is the spouse of scoping person's child.
6          DAUINLAWdaughter in-lawThe player of the role is the wife of scoping person's son.
6          SONINLAWson in-lawThe player of the role is the husband of scoping person's daughter.
5        PRNINLAWparent in-lawThe player of the role is the parent of scoping person's husband or wife.
6          FTHINLAWfather-in-lawThe player of the role is the father of the scoping person's husband or wife.
6          MTHINLAWmother-in-lawThe player of the role is the mother of the scoping person's husband or wife.
5        SIBINLAWsibling in-lawThe player of the role is: (1) a sibling of the scoping person's spouse, or (2) the spouse of the scoping person's sibling, or (3) the spouse of a sibling of the scoping person's spouse.
6          BROINLAWbrother-in-lawThe player of the role is: (1) a brother of the scoping person's spouse, or (2) the husband of the scoping person's sister, or (3) the husband of a sister of the scoping person's spouse.
6          SISINLAWsister-in-lawThe player of the role is: (1) a sister of the scoping person's spouse, or (2) the wife of the scoping person's brother, or (3) the wife of a brother of the scoping person's spouse.
4      NIENEPHniece/nephewThe player of the role is a child of scoping person's brother or sister or of the brother or sister of the scoping person's spouse.
5        NEPHEWnephewThe player of the role is a son of the scoping person's brother or sister or of the brother or sister of the scoping person's spouse.
5        NIECEnieceThe player of the role is a daughter of the scoping person's brother or sister or of the brother or sister of the scoping person's spouse.
4      UNCLEuncleThe player of the role is a brother of the scoping person's mother or father.
5        MUNCLEmaternal uncleDescription: The player of the role is a biological brother of the scoping person's biological mother.
5        PUNCLEpaternal uncleDescription: The player of the role is a biological brother of the scoping person's biological father.
3    PRNparentThe player of the role is one who begets, gives birth to, or nurtures and raises the scoping entity (child).
4      ADOPTPadoptive parentThe player of the role (parent) has taken the scoper (child) into their family through legal means and raises them as his or her own child.
5        ADOPTFadoptive fatherThe player of the role (father) is a male who has taken the scoper (child) into their family through legal means and raises them as his own child.
5        ADOPTMadoptive motherThe player of the role (father) is a female who has taken the scoper (child) into their family through legal means and raises them as her own child.
4      FTHfatherThe player of the role is a male who begets or raises or nurtures the scoping entity (child).
5        ADOPTF  
5        FTHFOSTfoster fatherThe player of the role (parent) who is a male state-certified caregiver responsible for the scoper (child) who has been placed in the parent's care. The placement of the child is usually arranged through the government or a social-service agency, and temporary.
The state, via a jurisdiction recognized child protection agency, stands as in loco parentis to the child, making all legal decisions while the foster parent is responsible for the day-to-day care of the specified child.
5        NFTHnatural fatherThe player of the role is a male who begets the scoping entity (child).
6          NFTHFnatural father of fetusIndicates the biologic male parent of a fetus.
5        STPFTHstepfatherThe player of the role is the husband of scoping person's mother and not the scoping person's natural father.
4      MTHmotherThe player of the role is a female who conceives, gives birth to, or raises and nurtures the scoping entity (child).
5        ADOPTM  
5        GESTMgestational motherThe player is a female whose womb carries the fetus of the scoper. Generally used when the gestational mother and natural mother are not the same.
5        MTHFOSTfoster motherThe player of the role (parent) who is a female state-certified caregiver responsible for the scoper (child) who has been placed in the parent's care. The placement of the child is usually arranged through the government or a social-service agency, and temporary.
The state, via a jurisdiction recognized child protection agency, stands as in loco parentis to the child, making all legal decisions while the foster parent is responsible for the day-to-day care of the specified child.
5        NMTHnatural motherThe player of the role is a female who conceives or gives birth to the scoping entity (child).
6          NMTHFnatural mother of fetusThe player is the biologic female parent of the scoping fetus.
5        STPMTHstepmotherThe player of the role is the wife of scoping person's father and not the scoping person's natural mother.
4      NPRNnatural parent 
5        NFTH  
5        NMTH  
4      PRNFOSTfoster parentThe player of the role (parent) who is a state-certified caregiver responsible for the scoper (child) who has been placed in the parent's care. The placement of the child is usually arranged through the government or a social-service agency, and temporary.
The state, via a jurisdiction recognized child protection agency, stands as in loco parentis to the child, making all legal decisions while the foster parent is responsible for the day-to-day care of the specified child.
5        FTHFOST  
5        MTHFOST  
4      STPPRNstep parentThe player of the role is the spouse of the scoping person's parent and not the scoping person's natural parent.
5        STPFTH  
5        STPMTH  
3    SIBsiblingThe player of the role shares one or both parents in common with the scoping entity.
4      BRObrotherThe player of the role is a male sharing one or both parents in common with the scoping entity.
5        HBROhalf-brotherThe player of the role is a male related to the scoping entity by sharing only one biological parent.
5        NBROnatural brotherThe player of the role is a male having the same biological parents as the scoping entity.
6          TWINBROtwin brotherThe scoper was carried in the same womb as the male player and shares common biological parents.
7            FTWINBROfraternal twin brotherThe scoper was carried in the same womb as the male player and shares common biological parents but is the product of a distinct egg/sperm pair.
7            ITWINBROidentical twin brotherThe male scoper is an offspring of the same egg-sperm pair as the male player.
5        STPBROstepbrotherThe player of the role is a son of the scoping person's stepparent.
4      HSIBhalf-siblingThe player of the role is related to the scoping entity by sharing only one biological parent.
5        HBRO  
5        HSIShalf-sisterThe player of the role is a female related to the scoping entity by sharing only one biological parent.
4      NSIBnatural siblingThe player of the role has both biological parents in common with the scoping entity.
5        NBRO  
5        NSISnatural sisterThe player of the role is a female having the same biological parents as the scoping entity.
6          TWINSIStwin sisterThe scoper was carried in the same womb as the female player and shares common biological parents.
7            FTWINSISfraternal twin sisterThe scoper was carried in the same womb as the female player and shares common biological parents but is the product of a distinct egg/sperm pair.
7            ITWINSISidentical twin sisterThe female scoper is an offspring of the same egg-sperm pair as the female player.
5        TWINtwinThe scoper and player were carried in the same womb and shared common biological parents.
6          TWINBRO  
6          TWINSIS  
6          FTWINfraternal twinThe scoper and player were carried in the same womb and share common biological parents but are the product of distinct egg/sperm pairs.
7            FTWINBRO  
7            FTWINSIS  
6          ITWINidentical twinThe scoper and player are offspring of the same egg-sperm pair.
7            ITWINBRO  
7            ITWINSIS  
4      SISsisterThe player of the role is a female sharing one or both parents in common with the scoping entity.
5        HSIS  
5        NSIS  
5        STPSISstepsisterThe player of the role is a daughter of the scoping person's stepparent.
4      STPSIBstep siblingThe player of the role is a child of the scoping person's stepparent.
5        STPBRO  
5        STPSIS  
3    SIGOTHRsignificant otherA person who is important to one's well being; especially a spouse or one in a similar relationship. (The player is the one who is important)
4      DOMPARTdomestic partnerThe player of the role cohabits with the scoping person but is not the scoping person's spouse.
4      FMRSPSformer spousePlayer of the role was previously joined to the scoping person in marriage and this marriage is now dissolved and inactive.
Usage Note: This is significant to indicate as some jurisdictions have different legal requirements for former spouse to access the patient's record, from a general friend.
4      SPSspouseThe player of the role is a marriage partner of the scoping person.
5        HUSBhusbandThe player of the role is a man joined to a woman (scoping person) in marriage.
5        WIFEwifeThe player of the role is a woman joined to a man (scoping person) in marriage.