<book xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0">
    <title>CP-1771</title>
    <subtitle>Update PS3.16 Context Group Table Conventions</subtitle>
    <chapter>
        <title/>
        <informaltable rules="all" frame="box">
            <tr>
                <td rowspan="1" colspan="1" valign="top"><para>Status</para></td>
                <td rowspan="1" colspan="1" valign="top"><para>March 2018 Voting Packet</para></td>
            </tr>
            <tr>
                <td rowspan="1" colspan="1" valign="top"><para>Date of Last Update</para></td>
                <td rowspan="1" colspan="1" valign="top"><para>2018/03/09</para></td>
            </tr>
            <tr>
                <td rowspan="1" colspan="1" valign="top"><para>Person Assigned</para></td>
                <td rowspan="1" colspan="1" valign="top"><para>David Clunie</para><para><link xl:href="mailto:dclunie@dclunie.com"/></para></td>
            </tr>
            <tr>
                <td rowspan="1" colspan="1" valign="top"><para>Submitter Name</para></td>
                <td rowspan="1" colspan="1" valign="top"><para>David Clunie</para><para><link xl:href="mailto:dclunie@dclunie.com"/></para></td>
            </tr>
            <tr>
                <td rowspan="1" colspan="1" valign="top"><para>Submission Date</para></td>
                <td rowspan="1" colspan="1" valign="top"><para>2017/12/05</para></td>
            </tr>
        </informaltable>
        <informaltable rules="all" frame="box">
            <tr>
                <td rowspan="1" colspan="1" valign="top"><para>Correction Number CP-1771</para></td>
            </tr>
            <tr>
                <td rowspan="1" colspan="1" valign="top"><para>Log Summary: Update PS3.16 Context Group Table Conventions</para></td>
            </tr>
            <tr>
                <td rowspan="1" colspan="1" valign="top">
                    <para>Name of Standard</para>
                    <para>PS3.16</para>
                </td>
            </tr>
            <tr>
                <td rowspan="1" colspan="1" valign="top"><para>Rationale for Correction:</para>
                    <para>Table conventions have evolved over time in various Supplements, CPs and editorial
                    changes adding preamble information such as UIDs and resource hyperlinks and columns
                    with specific functions. Update the Conventions section accordingly.</para>
                </td>
            </tr>
            <tr>
                <td rowspan="1" colspan="1" valign="top">Correction Wording:</td>
            </tr>
        </informaltable>
    </chapter>
    <chapter>
        <title/>
        
        <informaltable rules="all" frame="box">
            <tr>
                <td>
                    <para><emphasis role="italic">Amend DICOM PS3.16 as follows (changes to existing text are bold and <emphasis role="bold"><emphasis role="strikethrough">underlined</emphasis></emphasis> for additions and <emphasis role="bold"><emphasis role="strikethrough">struckthrough</emphasis></emphasis> for removals):</emphasis></para>
                </td>
            </tr>
        </informaltable>
        
        
        <section label="7" status="1" xml:id="chapter_7">
            <title>DCMR Context Group Specifications</title>
            <para xml:id="para_7b60da48-0a38-409e-9f31-e267e5d6e264">Context Groups specify Value Set restrictions for Code Value (0008,0100) (or Long Code Value (0008,0119) or URN Code Value (0008,0120)) and Code Meaning (0008,0104) of Code Sequence Attributes for given functional or operational contexts. This Section specifies the semantics of DCMR Context Group Tables.</para>
            <section label="7.1" status="2" xml:id="sect_7.1">
                <title>Context Group Table Field Definition</title>
                <para xml:id="para_d43ef242-8508-4d8e-8547-0b125f8fb81e">Context Groups are described using tables of the following form (optional columns are shown with italic column titles):</para>
                
                <variablelist spacing="compact">
                    <varlistentry>
                        <term>
                            <emphasis role="bold"><emphasis role="underline">Resources:</emphasis></emphasis>
                        </term>
                        <listitem>
                            <para>
                                <emphasis role="bold">
                                    <emphasis role="underline">HTML | FHIR JSON | FHIR XML | IHE SVS XML</emphasis>
                                </emphasis>
                            </para>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Type:</emphasis>
                        </term>
                        <listitem>
                            <para xml:id="para_2f8ab50c-2a0b-4f5f-8746-256b7f161884">
                                <emphasis role="bold">(Non-) Extensible</emphasis>
                            </para>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Version:</emphasis>
                        </term>
                        <listitem>
                            <para xml:id="para_4b33049a-76b3-4c3b-851c-664cb4220e9b">
                                <emphasis role="bold">&lt;yyyymmdd&gt;</emphasis>
                            </para>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold"><emphasis role="underline">UID:</emphasis></emphasis>
                        </term>
                        <listitem>
                            <para>
                                <emphasis role="bold"><emphasis role="underline">1.2.840.10008.6.1.uuuu</emphasis></emphasis>
                            </para>
                        </listitem>
                    </varlistentry>
                </variablelist>
                <table frame="box" label="CID &lt;#&gt;" rules="all">
                    <caption>&lt;Context Group Name&gt;</caption>
                    <thead>
                        <tr valign="top">
                            <th align="center" colspan="1" rowspan="1">
                                <para xml:id="para_f89a2f85-04d3-46cb-bdbe-16c2e2c9c1bb">Coding Scheme Designator</para>
                            </th>
                            <th align="center" colspan="1" rowspan="1">
                                <para xml:id="para_dcc83e03-3a66-45ce-8cb3-ae5d69a68c58">
                                    <emphasis role="italic">Coding Scheme Version</emphasis>
                                </para>
                            </th>
                            <th align="center" colspan="1" rowspan="1">
                                <para xml:id="para_ade1c4b9-18be-49d4-b1b7-eaa438f70808">Code Value</para>
                            </th>
                            <th align="center" colspan="1" rowspan="1">
                                <para xml:id="para_6a2d25ef-ab97-4cfd-b5cc-ac9cec9af74e">Code Meaning</para>
                            </th>
                            <th align="center" colspan="1" rowspan="1">
                                <para xml:id="para_1a429f4a-f643-4323-ae5b-ff8a2d5530aa">
                                    <emphasis role="italic">&lt;Reference Terminology&gt; Equivalent Value</emphasis>
                                </para>
                            </th>
                            <th>
                                <para>
                                    <emphasis role="italic"><emphasis role="underline">Units</emphasis></emphasis>
                                </para>
                            </th>
                        </tr>
                    </thead>
                    <tbody>
                        <tr valign="top">
                            <td align="center" colspan="1" rowspan="1">
                                <para xml:id="para_84b6a008-db63-4938-bb48-d9adcf3b8388">...</para>
                            </td>
                            <td align="center" colspan="1" rowspan="1">
                                <para xml:id="para_b57a17e2-1a50-4f9c-ad88-174c821e6729">...</para>
                            </td>
                            <td align="center" colspan="1" rowspan="1">
                                <para xml:id="para_34c3b9e7-6ff0-4415-a1b7-651825150a22">...</para>
                            </td>
                            <td align="center" colspan="1" rowspan="1">
                                <para xml:id="para_058a3805-9072-46ba-99f2-02a8baef20ea">...</para>
                            </td>
                            <td align="center" colspan="1" rowspan="1">
                                <para xml:id="para_ffbe8946-ef4a-4e8f-a6de-5f3d525f6125">...</para>
                            </td>
                            <td>
                                <para><emphasis role="bold"><emphasis role="underline">...</emphasis></emphasis></para>
                            </td>
                        </tr>
                        <tr valign="top">
                            <td align="center" colspan="1" rowspan="1">
                                <para xml:id="para_0f1affb1-3bca-4ccf-af1f-557c0b531f35">...</para>
                            </td>
                            <td align="center" colspan="1" rowspan="1">
                                <para xml:id="para_64c24369-afa5-4858-8bad-09b1d55da173">...</para>
                            </td>
                            <td align="center" colspan="1" rowspan="1">
                                <para xml:id="para_dac89174-1d63-47c7-b3d6-cf35acac00b4">...</para>
                            </td>
                            <td align="center" colspan="1" rowspan="1">
                                <para xml:id="para_0c1036b3-bf1c-43f0-b26e-b5c5bae195ed">...</para>
                            </td>
                            <td align="center" colspan="1" rowspan="1">
                                <para xml:id="para_0955cfe0-840e-4f34-8c17-402237b045a9">...</para>
                            </td>
                            <td>
                                <para><emphasis role="bold"><emphasis role="underline">...</emphasis></emphasis></para>
                            </td>
                        </tr>
                    </tbody>
                </table>
                <para xml:id="para_79b1ac80-fa8d-4633-a41f-b4c36708a76f">A row of a Context Group table specifies one coded concept. Each Context Group table is named by a title and identified by a CID number and version.</para>
                <para xml:id="para_ba7cff55-b0d0-4aa9-98f6-abfade735fad">The columns of the tables consist of:</para>
                <itemizedlist>
                    <listitem>
                        <para xml:id="para_57bf88d4-22d5-4a8e-9e7f-d7e0f9914e83">Coding Scheme Designator: the value of Coding Scheme Designator (0008,0102)</para>
                    </listitem>
                    <listitem>
                        <para xml:id="para_cfe96806-cd2f-4e80-b9e9-12451117df47">Code Value: the value of Code Value (0008,0100) or Long Code Value (0008,0119) or URN Code Value (0008,0120)</para>
                    </listitem>
                    <listitem>
                        <para xml:id="para_e9a4b74b-2e00-4c73-bde0-35d25b932325">Coding Meaning: the value of Code Meaning (0008,0104)</para>
                    </listitem>
                </itemizedlist>
                <para xml:id="para_92bf91f5-20a0-422e-82a5-f569ef75056e">In those cases where it is necessary, Coding Scheme Version (the value of Coding Scheme Version (0008,0103)) may also be specified. This column may be absent if Coding Scheme Version is not required for any of the coded concepts in the Context Group.</para>
                <para xml:id="para_4dce29d6-e0e9-4158-8349-598b3d6c836d">The value specified in the Code Meaning field is an acceptable value for the specified code value, but does not preclude the use of other synonymous text in the same or other language.</para>
                <note>
                    <para xml:id="para_84791042-b65c-43c2-a32d-2470915e84ff">Some coding schemes such as LOINC do not specify the equivalent of a Code Meaning.</para>
                </note>
                <para xml:id="para_4d900fd4-659d-404f-a601-b87ed27bb39c">If further description of the concept represented by the code is required in the DCMR (rather than referring to an external coding scheme), it is included in a separate table.</para>
                <para xml:id="para_32b8ebee-184f-4386-a49d-ad2aa2b8c1e9">An optional column may provide an informative mapping from the coded concepts of the Context Group to a reference terminology specified in the column heading.<emphasis role="bold"><emphasis role="underline">Typical reference terminologies include SNOMED CT and UMLS.</emphasis></emphasis></para>
                <para><emphasis role="bold"><emphasis role="underline">An optional column may provide a normative baseline or defined set of units to use for numeric measurements using the concept, either as a single term (e.g., DT ({ratio}, UCUM, "ratio")), a list of such terms, or a reference to a Context Group (e.g., DCID 7277 "Units of Diffusion Rate Area Over Time").</emphasis></emphasis></para>
                <para xml:id="para_0289f923-a7b4-47f9-aa04-c1327eebb16d">A Context Group may alternatively be defined by narrative reference to an externally defined coding scheme.</para>
                <note>
                    <para xml:id="para_51d90a2d-1d17-4aad-b80a-367998cd89e2">See for instance CID 82 "Units of Measurement"<!--<xref linkend="sect_CID_82" xrefstyle="select: labelnumber quotedtitle nopage"/>-->.</para>
                </note>
            </section>
            <section label="7.2" status="2" xml:id="sect_7.2">
                <title>Special Conventions for Context Group Tables</title>
                <section label="7.2.1" status="3" xml:id="sect_7.2.1">
                    <title>Include Context Group</title>
                    <para xml:id="para_cf95ca57-a2cb-40ab-8e0f-cf073f74cc34">The 'Include Context Group' macro is a concise mechanism for including (by-reference) all of the rows of a specified Context Group in the invoking Context Group, effectively substituting the specified Context Group for the row where the macro is invoked. If an 'Include Context Group' is specified, it shall be specified in the Concept Name column of a Context Group Table. Table 7.2.1-1 specifies the syntax of the 'Include Context Group macro. Inclusion may be nested, in that included Context Groups may themselves include other Context Groups. This gives rise to the possibility of circular inclusion and multiple inclusion, in which case the Context Group shall consist of the transitive closure of the set of all coded concepts within the included Context Groups.</para>
                    <note>
                        <para xml:id="para_6699c5fc-4656-4b83-97b7-4d6966261442">For example, it is reasonable to have the following definitions for context groups:</para>
                        <itemizedlist>
                            <listitem>
                                <para xml:id="para_0580d732-e65a-4762-967b-b436fab46f3a">Context ID 1, includes Context IDs 2 and 3</para>
                            </listitem>
                            <listitem>
                                <para xml:id="para_e45facec-72de-4c9d-b93a-aa9df1e249ea">Context ID 2, includes Context IDs 4 and 5</para>
                            </listitem>
                            <listitem>
                                <para xml:id="para_5c60aa13-6e32-4ef9-bd5a-add0ebd0056a">Context ID 3, includes Context IDs 5 and 6</para>
                            </listitem>
                            <listitem>
                                <para xml:id="para_62b15e7f-8701-4541-b124-325a4278ecf3">Context ID 4 contains a, b, c</para>
                            </listitem>
                            <listitem>
                                <para xml:id="para_aaf06a8d-193e-4187-925a-432f1dda5546">Context ID 5 contains e, f, g</para>
                            </listitem>
                            <listitem>
                                <para xml:id="para_714dfb87-8b5e-4432-8df5-b1fd85ae5463">Context ID 6 contains a, h, i</para>
                            </listitem>
                        </itemizedlist>
                        <para xml:id="para_4adf1bfc-80db-440d-9d20-28b36339fa0a">The contents of Context ID 1 will be a, b, c, e, f, g, h, i.</para>
                    </note>
                    <table frame="box" label="7.2.1-1" rules="all" xml:id="table_7.2.1-1">
                        <caption>Include Context Group Macro</caption>
                        <thead>
                            <tr valign="top">
                                <th align="center" colspan="1" rowspan="1">
                                    <para xml:id="para_c815472b-1fad-40e8-95a3-e63496f81841">Coding Scheme Designator</para>
                                </th>
                                <th align="center" colspan="1" rowspan="1">
                                    <para xml:id="para_83b35564-2f46-4fbc-adcf-7598e5d79a82">Code Value</para>
                                </th>
                                <th align="center" colspan="1" rowspan="1">
                                    <para xml:id="para_d467c67f-6b3a-493c-82c6-4d5ddfd41bee">Code Meaning</para>
                                </th>
                            </tr>
                        </thead>
                        <tbody>
                            <tr valign="top">
                                <td align="center" colspan="1" rowspan="1">
                                    <para xml:id="para_8bd8183e-15e2-4f4a-a89d-bc00509a0c86">…</para>
                                </td>
                                <td align="center" colspan="1" rowspan="1">
                                    <para xml:id="para_cdd934cd-972f-4395-b54d-f6418891db02">…</para>
                                </td>
                                <td align="left" colspan="1" rowspan="1">
                                    <para xml:id="para_1eeb525c-1da7-49e4-a275-449efab110eb">…</para>
                                </td>
                            </tr>
                            <tr valign="top">
                                <td align="left" colspan="3" rowspan="1">
                                    <para xml:id="para_a18d52db-d96e-4052-8c95-1a331ab8b1cf">
                                        <emphasis role="italic">Include CID nnn</emphasis>
                                    </para>
                                </td>
                            </tr>
                            <tr valign="top">
                                <td align="center" colspan="1" rowspan="1">
                                    <para xml:id="para_d4991b09-fb3f-4ebe-8c2c-354479d4845c">…</para>
                                </td>
                                <td align="center" colspan="1" rowspan="1">
                                    <para xml:id="para_34f13335-f7c3-4a7c-b98a-1d6d81c0ba0a">…</para>
                                </td>
                                <td align="left" colspan="1" rowspan="1">
                                    <para xml:id="para_83e566a7-e4a4-49fa-aa53-1a6020aec64f">…</para>
                                </td>
                            </tr>
                        </tbody>
                    </table>
                </section>
                <section label="7.2.2" status="3" xml:id="sect_7.2.2">
                    <title>Units of Measurement</title>
                    <para xml:id="para_a92ec74c-b0fb-4537-9e0d-0213bce91064">Context Group 82 is defined to include all units of measurement relevant to DICOM IODs. In the past it was envisaged that an extensible list of pre-coordinated codes would be included in the mapping resource.</para>
                    <para xml:id="para_5579d69c-14ab-4f6a-a4cb-5836a9bd992d">DICOM has now adopted the Unified Codes for Units of Measurement (UCUM) standard for all units of measurement. This coding scheme allows for the "construction" of pre-coordinated codes from atomic components.</para>
                    <para xml:id="para_319481f7-5126-45e6-974e-d307a8937bcb">The specialization of the UCUM standard as it is used in DICOM involves the following rules:</para>
                    <itemizedlist>
                        <listitem>
                            <para xml:id="para_ce59b92f-30e4-482d-81e8-470067f36249">the Coding Scheme Designator is specified as "UCUM"</para>
                        </listitem>
                        <listitem>
                            <para xml:id="para_3eb47571-ddfa-45d5-b086-2cedc69bd1c1">the version of UCUM from which a code is constructed is not required, as it is not needed to resolve ambiguity in the Code Value or Code Meaning; however, there is no restriction on the version being specified in Coding Scheme Version</para>
                        </listitem>
                        <listitem>
                            <para xml:id="para_26febbb4-fa3d-4849-9b84-cc991e3d631a">the Code Value will be constructed from UCUM and make use of the "case-sensitive" form of UCUM code (e.g., "ml/s")</para>
                        </listitem>
                        <listitem>
                            <para xml:id="para_8aeb5075-aba3-4759-83d5-1c43406e147f">the Code Meaning for other than UCUM unity may be one of the following:</para>
                            <itemizedlist>
                                <listitem>
                                    <para xml:id="para_534f93cc-aca7-4755-8a13-b0df31407aa9">the "print" value specified in UCUM (e.g., "mmHg" for Code Value mm[Hg])</para>
                                </listitem>
                                <listitem>
                                    <para xml:id="para_86ec86a3-fbdb-4a73-81f8-402f7f12b846">the same string as sent in the Code Value (e.g., "ml/s")</para>
                                </listitem>
                                <listitem>
                                    <para xml:id="para_dc53bd58-7fbf-47cd-b6b1-38c02f6b447c">constructed from the "names" of individual components using the Americanized form of name (e.g., "milliliters/second")</para>
                                </listitem>
                                <listitem>
                                    <para xml:id="para_611952cc-ef9d-4c0c-8405-e1e7b9a637ca">constructed from the "names" of individual components using the European form of name (e.g., "<foreignphrase xml:lang="en-GB">millilitres</foreignphrase>/second")</para>
                                </listitem>
                            </itemizedlist>
                        </listitem>
                        <listitem>
                            <para xml:id="para_5db73b35-62b5-46b4-9436-acb29489cab4">In the case of UCUM unity ("1", or curly braces expression) it is forbidden to use "1" as a Code Meaning. Annex G<!--<xref linkend="chapter_G" xrefstyle="template:Annex %n"/>--> provides Code Meanings for a Code Value (0008,0100) of 1. A Template or Context Group may constrain the Code Meaning according to the following rules:</para>
                            <itemizedlist>
                                <listitem>
                                    <para xml:id="para_6dfe7eff-908a-4aef-ac63-1500f97e001e">UCUM default unit 1 shall use one of the Code Meaning synonyms specified in Annex G<!--<xref linkend="chapter_G" xrefstyle="template:Annex %n"/>-->
                                    </para>
                                </listitem>
                                <listitem>
                                    <para xml:id="para_20e5493f-af13-42e3-ba3c-c21980801165">ratios of identically dimensioned values may use ({ratio}, UCUM, "ratio")</para>
                                </listitem>
                                <listitem>
                                    <para xml:id="para_945ea154-8a14-4e68-a7f4-3df63a9f0e3d">unitless numeric scores may use ({M:N}, UCUM, "range: M:N") to specify the minimum and maximum value, for example, ({0:10}, UCUM, "range: 0:10")</para>
                                </listitem>
                                <listitem>
                                    <para xml:id="para_bd032db3-228d-48d0-8570-f8b933073429">counts using UCUM annotation shall always use the text within the curly braces as the Code Meaning, for example, ({masses}, UCUM, "masses")</para>
                                </listitem>
                                <listitem>
                                    <para xml:id="para_a5bf59e2-0125-4fb2-aa34-c3ce7113a3b9">compositions of a curly braces expression with other UCUM values may use a conventional clinical representation, for example, ({H.B.}/min, UCUM, "BPM")</para>
                                </listitem>
                            </itemizedlist>
                        </listitem>
                    </itemizedlist>
                    <para xml:id="para_e16c21d5-586d-489f-9c74-f9fdfb25097e">The UCUM standard states that the preferred display values for codes deg (degrees of
                        plane angle) and Cel (degrees Celsius) are "°" and "°C". However, the character ° does not
                        have a representation in the DICOM default character set (ASCII, ISO-IR 6). The Code
                        Meaning specified in this Part therefore uses "deg" and "C". SOP Instances that specify a
                        Specific Character Set that allows the character ° may use Code Meanings "°" and
                        "°C".</para>
                    <note>
                        <orderedlist numeration="arabic">
                            <listitem>
                                <para xml:id="para_ffab4057-eac8-4493-9194-69f924f63059">Code Meaning "C" formally conflicts with the Code Meaning for Coulomb. In the context of DICOM use, the possibility of confusion to a user based on the display of the Code Meaning is considered remote, as there is little use of Coulomb in imaging, and the context of the displayed item Concept Name would resolve between temperature and electric charge. Automated processing based on the Code Values should not face an issue as the Code Values differ.</para>
                            </listitem>
                            <listitem>
                                <para xml:id="para_a9ffa14c-6e07-45b8-aca5-6745f97e0274">The character ° has Unicode code point U+00B0, and is represented as 0xB0 in ISO-IR 100 (Latin-1), ISO-IR 101 (Latin-2), ISO-IR 109 (Latin-3), ISO-IR 110 (Latin-4), ISO-IR 126 (Greek), ISO-IR 138 (Hebrew), and ISO-IR 148 (Latin-5). It is not encodable in ISO-IR 13 (Katakana), ISO-IR 144 (Cyrillic), ISO-IR 127 (Arabic), or ISO-IR 166 (Thai).</para>
                            </listitem>
                        </orderedlist>
                    </note>
                </section>
                <section label="7.2.3" status="3" xml:id="sect_7.2.3">
                    <title>Extension of Context Groups</title>
                    <para xml:id="para_be6f9fe7-8445-4f73-b30a-5ca5f897714b">An Application may extend an Extensible Context Group by adding terms for new concepts. Applications may not substitute other terms of the same concept in the Context Group. Applications may not add a term that means "unspecified" or "missing" or "unknown" similar; if such a concept is intended to be permitted then the Standard will include it in the Context Group already. Such extension may be made without a change in Context Group Identifier, but with the specification of Context Group Extensions (see <olink targetdoc="PS3.3" targetptr="PS3.3" xrefstyle="select: labelnumber"/>).</para>
                    <para xml:id="para_ee77a9cf-af37-42f7-80d7-a0ef7c2c1ac6">Non-extensible Context Groups shall not be modified in an Application.</para>
                    <note>
                        <para xml:id="para_4f233c9e-3c13-44bd-a0b7-5309590bc31e">The set of concepts in either an Extensible or a Non-extensible Context Group may be changed in subsequent editions of the Standard, in accordance with the procedures of the DICOM Standards Committee.</para>
                    </note>
                </section>
            </section>
        </section>
        
        
        
        
        
        
        
        
        
        
    </chapter>
</book>
