<book xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0">
    <title>CP-2099</title>
    <subtitle>Clarify JPIP and Resource Category in DICOM Web Services Context</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>June 2021 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>2021/03/25</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>Mathieu Malaterre</para><para><link xl:href="mailto:mathieu.malaterre@gmail.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>2020/04/16</para></td>
            </tr>
        </informaltable>
        <informaltable rules="all" frame="box">
            <tr>
                <td rowspan="1" colspan="1" valign="top"><para>Correction Number CP-2099</para></td>
            </tr>
            <tr>
                <td rowspan="1" colspan="1" valign="top"><para>Log Summary: Clarify JPIP and Resource Category in DICOM Web Services Context</para></td>
            </tr>
            <tr>
                <td rowspan="1" colspan="1" valign="top">
                    <para>Name of Standard</para>
                    <para>PS3.18</para>
                </td>
            </tr>
            <tr>
                <td rowspan="1" colspan="1" valign="top"><para>Rationale for Correction:</para>
                    <para>The JPIP Transfer Syntax is not used in Web Services but there is no mention of that in PS3.18. need to clarify that a stored instance using JPIP is handled internally as Image (not as Resource Category: Text), by propagating a variant of the existing note in Section 8.7.3.4 to Section 8.7.2.</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.18 as follows (changes to existing text
              are bold and <emphasis role="bold"><emphasis role="underline">underlined</emphasis></emphasis> for additions and <emphasis role="bold"><emphasis role="strikethrough">struckthrough</emphasis></emphasis> for
              removals):</emphasis></para>
          </td>
        </tr>
      </informaltable>
        
        <section label="8.7.2" status="3" xml:id="sect_8.7.2">
            <title>DICOM Resource Categories</title>
            <para xml:id="para_df764a1b-162e-4493-a76b-96b889377159">
                <xref linkend="table_8.7.2-1" xrefstyle="select: label"/> defines Resource Categories that correspond to different SOP Classes. The following sections map each Resource Category to appropriate DICOM and Rendered media types.</para>
            <table frame="box" label="8.7.2-1" rules="all" xml:id="table_8.7.2-1">
                <caption>Resource Categories</caption>
                <thead>
                    <tr valign="top">
                        <th align="center" colspan="1" rowspan="1">
                            <para xml:id="para_0407bf09-fcdc-4e17-9ad4-0ae66ac44939">Resource Category</para>
                        </th>
                        <th align="center" colspan="1" rowspan="1">
                            <para xml:id="para_3750351b-0cdd-4807-8035-80033d6b560d">Definition</para>
                        </th>
                    </tr>
                </thead>
                <tbody>
                    <tr valign="top">
                        <td align="left" colspan="1" rowspan="1">
                            <para xml:id="para_cb243d5a-2c2e-4ef0-a098-dac14363b315">Single Frame Image</para>
                        </td>
                        <td align="left" colspan="1" rowspan="1">
                            <para xml:id="para_debdd8ad-401d-441a-bc30-5596cccac6a5">This category includes all resources that are:</para>
                            <orderedlist>
                                <listitem>
                                    <para xml:id="para_d55de232-c40d-4bb7-9618-6f892266ae6b">Instances of a single frame SOP Class, or</para>
                                </listitem>
                                <listitem>
                                    <para xml:id="para_e05eb134-2f4b-4c84-bd59-4ad56eeca611">Instances of a multi-frame SOP Class that contain only one frame, or</para>
                                </listitem>
                                <listitem>
                                    <para xml:id="para_61263468-341c-4772-aaaa-50f6ac487ee2">a single frame selected from an Instance of a multi-frame SOP Class.</para>
                                </listitem>
                            </orderedlist>
                        </td>
                    </tr>
                    <tr valign="top">
                        <td align="left" colspan="1" rowspan="1">
                            <para xml:id="para_cc07ac1d-b16e-41b8-8c38-47214d1a632b">Multi-Frame Image</para>
                        </td>
                        <td align="left" colspan="1" rowspan="1">
                            <para xml:id="para_41bd7a95-1b57-4d60-9a2e-26c515b2763b">This category includes all resources that are Instances of a multi-frame SOP Class, that are not Video and that contain more than one frame.</para>
                        </td>
                    </tr>
                    <tr valign="top">
                        <td align="left" colspan="1" rowspan="1">
                            <para xml:id="para_72e36123-7e56-4697-a167-a24d3d625094">Video</para>
                        </td>
                        <td align="left" colspan="1" rowspan="1">
                            <para xml:id="para_16180973-483e-4ab6-90e4-cacf163a7ca6">This category includes all resources that contain more than one frame and are:</para>
                            <orderedlist>
                                <listitem>
                                    <para xml:id="para_406b2729-e49f-4c0b-8e2b-4e2e81d541c6">Instances encoded in the MPEG family of Transfer Syntaxes (which includes MPEG2, MPEG-4 AVC/H.264 and HEVC/H.265), or</para>
                                </listitem>
                                <listitem>
                                    <para xml:id="para_542de4a2-475a-458b-9c22-18ff298f1ed3">time-based (motion) multi-frame images that the origin server is capable of encoding in the MPEG family.</para>
                                </listitem>
                            </orderedlist>
                        </td>
                    </tr>
                    <tr valign="top">
                        <td align="left" colspan="1" rowspan="1">
                            <para xml:id="para_c825a4bf-626d-4fa2-9ccd-1d660800ee8b">Text</para>
                        </td>
                        <td align="left" colspan="1" rowspan="1">
                            <para xml:id="para_b5394963-8f47-41a2-a7c2-2d27e193c34a">This category includes all resources that contain:</para>
                            <orderedlist>
                                <listitem>
                                    <para xml:id="para_00357013-9aee-4830-92d2-fc1de760da01">the SR Document Content Module (see <olink targetdoc="PS3.3" targetptr="sect_C.17.3" xrefstyle="template:Section %n “%t” in PS3.3"/>), such as narrative text, Structured Reports, CAD, measurement reports, and key object selection documents, or</para>
                                </listitem>
                                <listitem>
                                    <para xml:id="para_a47c0e83-fb34-4d74-a183-dab60549e535">the Encapsulated Document Module (see <olink targetdoc="PS3.3" targetptr="sect_C.24.2" xrefstyle="template:Section %n “%t” in PS3.3"/>).</para>
                                </listitem>
                            </orderedlist>
                        </td>
                    </tr>
                    <tr valign="top">
                        <td align="left" colspan="1" rowspan="1">
                            <para xml:id="para_73e87943-8263-4479-8e8a-f39de4cceedd">Other</para>
                        </td>
                        <td align="left" colspan="1" rowspan="1">
                            <para xml:id="para_fbac5ade-c4f4-4eac-9c3a-4412eb31ea15">This category includes all resources that are not included above, for example waveforms.</para>
                        </td>
                    </tr>
                </tbody>
            </table>
            <note>
                <para><emphasis role="bold"><emphasis role="underline">The Resource Category is independent of the Transfer Syntax used to natively encode or return the Resource. In particular, if the Transfer Syntax is  one of the JPIP Transfer Syntaxes, for which the pixel data is not included in the returned objects in but rather a URL of the JPIP provider for retrieving the pixel data is present in the metadata, the Resource Category will still be Single Frame Image or Multi-Frame Image, and not Text or Other.</emphasis></emphasis></para>
            </note>
        </section>

        <section label="8.7.3.4" status="4" xml:id="sect_8.7.3.4">
            <title>Transfer Syntax</title>
            <para xml:id="para_f66ec54d-5d7e-4c89-8620-036d2c60db62">The Default Transfer Syntax for DICOM objects contained in a payload shall be Explicit VR Little Endian Uncompressed "1.2.840.10008.1.2.1". If the Transfer Syntax is not specified in a message, then the Default Transfer Syntax shall be used, unless the origin server has only access to the pixel data in lossy compressed form or the pixel data in a lossless compressed form that is of such length that it cannot be encoded in the Explicit VR Little Endian Transfer Syntax.</para>
            <note>
                <orderedlist>
                    <listitem>
                        <para xml:id="para_1b43e82d-c76b-4b06-acd1-360407c287f1">This is different from the Default Transfer Syntax defined in <olink targetdoc="PS3.5" targetptr="sect_10.1" xrefstyle="template:Section %n “%t” in PS3.5"/>, which is Implicit VR Little Endian.</para>
                    </listitem>
                    <listitem>
                        <para xml:id="para_d8ccb50d-fcf2-4227-9874-c25b528bc842">Every origin server is required to be able to convert any Data Set it is going to return into the Explicit VR Little Endian Transfer Syntax, regardless of the form in which it originally received or stored the Data Set, except in the cases of when the decompressed Pixel Data is too large to encode in the Explicit VR Little Endian Transfer Syntax or is received in a lossy compressed form. In the case of lossy compressed Pixel Data, the origin server is permitted to return the lossy compressed Transfer Syntax appropriate to the lossy form that was received. In the case of lossless compressed Pixel Data that is too large to encode in the Explicit VR Little Endian Transfer Syntax, the origin server is permitted to return any appropriate lossless compression Transfer Syntax, not necessarily that in which the image was received, as an alternative to the Explicit VR Little Endian Transfer Syntax.</para>
                    </listitem>
                    <listitem>
                        <para xml:id="para_5f8f41c1-5912-4850-b485-d11072e77330">If transcoding to the Explicit VR Little Endian Transfer Syntax, a VR of UN may be needed for the encoding of Data Elements with explicit VR whose value length exceeds 65534 (2<superscript>16</superscript>-2) (FFFEH, the largest even length unsigned 16 bit number) but which are defined to have a 16 bit explicit VR length field. See <olink targetdoc="PS3.5" targetptr="sect_6.2.2" xrefstyle="select: docname label"/>.</para>
                    </listitem>
                </orderedlist>
            </note>
            <para xml:id="para_90b7dcf5-f060-4916-9471-2f96b11a11d1">Implicit VR Little Endian, or Explicit VR Big Endian shall not be used.</para>
            <para xml:id="para_f37a20de-8ca2-41fe-9454-cdc8deaabb87">The response payload encoding requirements are defined in <xref linkend="sect_8.7.8" xrefstyle="select: label"/>.</para>
            <note>
                <para xml:id="para_e0e47d13-5315-4a59-a2e5-fbeea529923e">The transfer syntax can be one of the JPIP Transfer Syntaxes, in which case the returned objects will contain the URL of the JPIP provider for retrieving the pixel data.</para>
            </note>
            <para xml:id="para_a705f977-f184-4c25-859f-d082edfc7d04">The origin server may support additional Transfer Syntaxes.</para>
        </section>
        

        
        
               
        
        
        
        
    </chapter>
</book>
