Package org.dcm4che.typeddicom.dataelements

Class PixelSpacing

  • All Implemented Interfaces:
    org.dcm4che.typeddicom.AttributesWrapper, org.dcm4che.typeddicom.DataElementWrapper, org.dcm4che.typeddicom.valuerepresentations.BytesDataElementWrapper, DecimalStringMultiWrapper, org.dcm4che.typeddicom.valuerepresentations.DoubleDataElementMultiWrapper, org.dcm4che.typeddicom.valuerepresentations.FloatDataElementMultiWrapper, org.dcm4che.typeddicom.valuerepresentations.StringDataElementMultiWrapper
    public class PixelSpacing
extends org.dcm4che.typeddicom.AbstractDataElementWrapper
implements DecimalStringMultiWrapper
    Name: Pixel Spacing
    Keyword: PixelSpacing
    Tag: (0028,0030)
    Value Representation: DecimalString
    Value Multiplicity: 2
    • Described in the contexts: as follows:
      Attribute Name: Pixel Spacing
      Type: 3
      Attribute Description:

      Physical distance in the imaging target (patient or specimen) between the center of each pixel, specified as a numeric pair - adjacent row spacing \ adjacent column spacing, in mm. See DICOM Standard Part 3 - Section 10.7.1.3.


    • Described in the contexts: as follows:
      Attribute Name: Pixel Spacing
      Type: 1
      Attribute Description:

      Physical distance in the patient between the center of each pixel, specified by a numeric pair - adjacent row spacing (delimiter) adjacent column spacing in mm. See DICOM Standard Part 3 - Section 10.7.1.3 for further explanation.


    • Described in the contexts: as follows:
      Attribute Name: Pixel Spacing
      Type: 1C
      Attribute Description:

      Physical distance in the imaging target (patient, specimen, or phantom) between the centers of each pixel, specified by a numeric pair - adjacent row spacing (delimiter) adjacent column spacing in mm. See DICOM Standard Part 3 - Section 10.7.1.3 for further explanation of the value order.

      Note

      1. In the case of CT images with an Acquisition Type (0018,9302) of CONSTANT_ANGLE, the pixel spacing is that in a plane normal to the central ray of the diverging X-Ray beam as it passes through the data collection center.

      2. In the case of Enhanced RT Image ("1.2.840.10008.5.1.4.1.1.481.23") or Enhanced Continuous RT Image ("1.2.840.10008.5.1.4.1.1.481.24") the pixel spacing is defined on the x/y plane at z = 0 of the Image Receptor Coordinate System.

      Required if:

      • Volumetric Properties (0008,9206) is other than DISTORTED or SAMPLED, and Image Type (0008,0008) Value 3 is not LABEL or OVERVIEW, or

      • SOP Class UID is Segmentation Storage ("1.2.840.10008.5.1.4.1.1.66.4") and Frame of Reference UID (0020,0052) is present, or

      • SOP Class UID is Ophthalmic Tomography Image Storage ("1.2.840.10008.5.1.4.1.1.77.1.5.4") and Ophthalmic Volumetric Properties Flag (0022,1622) is YES, or

      • SOP Class UID is Ophthalmic Optical Coherence Tomography B-scan Volume Analysis Storage ("1.2.840.10008.5.1.4.1.1.77.1.5.8"), or

      • SOP Class UID is Enhanced RT Image ("1.2.840.10008.5.1.4.1.1.481.23"), or

      • SOP Class UID is Enhanced Continuous RT Image ("1.2.840.10008.5.1.4.1.1.481.24").

      May be present otherwise.


    • Described in the contexts: as follows:
      Attribute Name: Pixel Spacing
      Type: 1
      Attribute Description:

      Nominal physical distance at the focal plane (in the retina) between the center of each pixel, specified by a numeric pair - adjacent row spacing (delimiter) adjacent column spacing in mm. See Section 10.7.1.3for further explanation of the value order.

      Note

      Since a patient's retina is curved and the image representation is planar, there can be an error in using Pixel Spacing (0028,0030) for measurements in the periphery of the image. En face imaging does not support wide field measurements.


    • Described in the contexts: as follows:
      Attribute Name: Pixel Spacing
      Type: 1C
      Attribute Description:

      Nominal physical distance at the focal plane (in the retina) between the center of each pixel, specified by a numeric pair - adjacent row spacing (delimiter) adjacent column spacing in mm. See DICOM Standard Part 3 - Section 10.7.1.3 for further explanation of the value order.

      Note

      These values are specified as nominal because the physical distance may vary across the field of the images and the lens correction is likely to be imperfect.

      Shall not be present when Two Dimensional to Three Dimensional Map Sequence (0022,1518) or X Coordinates Center Pixel View Angle (0022,1528) and Y Coordinates Center Pixel View Angle (0022,1529) are present. Otherwise, required when Acquisition Device Type Code Sequence (0022,0015) contains an Item with the value http://snomed.info/id/409898007(409898007, SCT, "Fundus Camera"). May be present otherwise.


    • Described in the contexts: as follows:
      Attribute Name: Pixel Spacing
      Type: 2
      Attribute Description:

      Physical distance in the patient between the center of each pixel, specified by a numeric pair - adjacent row spacing (delimiter) adjacent column spacing, in mm. See DICOM Standard Part 3 - Section 10.7.1.3 for further explanation of the value order.


    • Described in the contexts: as follows:
      Attribute Name: Pixel Spacing
      Type: 1C
      Attribute Description:

      Physical distance in the Patient between the center of each pixel, specified by a numeric pair - adjacent row spacing (delimiter) adjacent column spacing in mm. See DICOM Standard Part 3 - Section 10.7.1.1 and DICOM Standard Part 3 - Section 10.7.1.3. Required if the image has been calibrated. May be present otherwise.


    • Described in the contexts: as follows:
      Attribute Name: Pixel Spacing
      Type: 1
      Attribute Description:

      Physical distance in the patient between the center of each pixel, specified by a numeric pair - adjacent row spacing (delimiter) adjacent column spacing in mm.

      Note

      Since a patient's retina is curved, there can be a small error in using Pixel Spacing (0028,0030) for distance measurements in the periphery of the image.

      See DICOM Standard Part 3 - Section 10.7.1.3 for further explanation.


    • Constructor Summary

      Constructors 
      Constructor Description
      PixelSpacing()
      Creates a new Pixel Spacing object which wraps a new and empty Attributes object.
      PixelSpacing​(org.dcm4che3.data.Attributes attributes)
      Creates a new Pixel Spacing object which wraps the provided attributes.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      PixelSpacing copy()
      Returns a new Pixel Spacing which wraps a copy of the Attributes wrapped in this Pixel Spacing.
      java.lang.String getPrivateCreator()  
      int getTag()  

      • Methods inherited from class org.dcm4che.typeddicom.AbstractDataElementWrapper

        equals, exists, getValue, hashCode, toString

      • Methods inherited from class org.dcm4che.typeddicom.AbstractAttributesWrapper

        getAttributes

      • Methods inherited from class java.lang.Object

        clone, finalize, getClass, notify, notifyAll, wait, wait, wait

      • Methods inherited from interface org.dcm4che.typeddicom.AttributesWrapper

        copy, getAttributes, getKnownAttributeTags, getUnknownAttributeTags, isEmpty

      • Methods inherited from interface org.dcm4che.typeddicom.valuerepresentations.BytesDataElementWrapper

        getBytes, getSafeBytes, setBytes

      • Methods inherited from interface org.dcm4che.typeddicom.DataElementWrapper

        exists, getValue

      • Methods inherited from interface org.dcm4che.typeddicom.valuerepresentations.DoubleDataElementMultiWrapper

        getDouble, getDoubles, setDoubles

      • Methods inherited from interface org.dcm4che.typeddicom.valuerepresentations.FloatDataElementMultiWrapper

        getFloat, getFloats, setFloats

      • Methods inherited from interface org.dcm4che.typeddicom.valuerepresentations.StringDataElementMultiWrapper

        getString, getString, getStrings, setStrings

    • Constructor Detail

      • PixelSpacing

        public PixelSpacing​(org.dcm4che3.data.Attributes attributes)
        Creates a new Pixel Spacing object which wraps the provided attributes.
        Parameters:
        attributes - the Attributes object to be wrapped.

      • PixelSpacing

        public PixelSpacing()
        Creates a new Pixel Spacing object which wraps a new and empty Attributes object.

    • Method Detail

      • copy

        public PixelSpacing copy()
        Returns a new Pixel Spacing which wraps a copy of the Attributes wrapped in this Pixel Spacing. (see Attributes(Attributes)
        Returns:
        a new Pixel Spacing which wraps a copy of the Attributes wrapped in this Pixel Spacing.

      • getPrivateCreator

        public java.lang.String getPrivateCreator()
        Specified by:
        getPrivateCreator in interface org.dcm4che.typeddicom.DataElementWrapper

      • getTag

        public int getTag()
        Specified by:
        getTag in interface org.dcm4che.typeddicom.DataElementWrapper