org.dcm4che2.iod.module.dx
Class DXPositioningModule

java.lang.Object
  org.dcm4che2.iod.module.Module
      org.dcm4che2.iod.module.dx.DXPositioningModule

public class DXPositioningModule
extends Module

Table C.8-72 contains IOD Attributes that describe the positioning used in acquiring Digital X-Ray Images.

Version:

$Revision: 720 $ $Date: 2006-11-26 18:40:54 +0100 (Sun, 26 Nov 2006) $

Author:

Antonio Magni , Gunter Zeilinger

Field Summary

Fields inherited from class org.dcm4che2.iod.module.Module

dcmobj

Constructor Summary

DXPositioningModule(DicomObject dcmobj)

Method Summary

float	getBodyPartThickness()
float	getColumnAngulation()
float	getCompressionForce()
float	getDetectorPrimaryAngle()
float	getDetectorSecondaryAngle()
float	getDistanceSourceToDetector()
float	getDistanceSourceToPatient()
float	getEstimatedRadiographicMagnificationFactor()
Code	getPatientGantryRelationshipCode()
PatientOrientationCode	getPatientOrientationCode()
java.lang.String	getPatientPosition()
float	getPositionerPrimaryAngle()
float	getPositionerSecondaryAngle()
java.lang.String	getPositionerType()
Code	getProjectionEponymousNameCode()
float	getTableAngle()
java.lang.String	getTableType()
ViewCode	getViewCode()
java.lang.String	getViewPosition()
void	setBodyPartThickness(float f) The average thickness in mm of the body part examined when compressed, if compression has been applied during exposure.
void	setColumnAngulation(float f) Angle of the X-Ray beam in degree relative to an orthogonal axis to the detector plane.
void	setCompressionForce(float f) The compression force applied to the body part during exposure, measured in Newtons.
void	setDetectorPrimaryAngle(float f) Angle of the X-Ray beam in the row direction in degrees relative to the normal to the detector plane.
void	setDetectorSecondaryAngle(float f) Angle of the X-Ray beam in the column direction in degrees relative to the normal to the detector plane.
void	setDistanceSourceToDetector(float f) Distance in mm from source to detector center.
void	setDistanceSourceToPatient(float f) Distance in mm from source to the table, support or bucky side that is closest to the Imaging Subject, as measured along the central ray of the X-Ray beam.
void	setEstimatedRadiographicMagnificationFactor(float f) Factor Ratio of Source Image Receptor Distance (SID) over Source Object Distance (SOD).
void	setPatientGantryRelationshipCode(Code code) Sequence Sequence which describes the orientation of the patient with respect to the gantry.
void	setPatientOrientationCode(PatientOrientationCode code)
void	setPatientPosition(java.lang.String cs) Description of imaging subjectÕs position relative to the equipment.
void	setPositionerType(java.lang.String cs) Defined Terms: CARM COLUMN MAMMOGRAPHIC PANORAMIC CEPHALOSTAT RIGID NONE Notes: The term CARM can apply to any positioner with 2 degrees of freedom of rotation of the X-Ray beam about the Imaging Subject.
void	setPositonerPrimaryAngle(float f) Position of the X-Ray beam about the patient from the RAO to LAO direction where movement from RAO to vertical is positive, if Positioner Type (0018,1508) is CARM.
void	setPositonerSecondaryAngle(float f) Position of the X-Ray beam about the patient from the CAU to CRA direction where movement from CAU to vertical is positive, if Positioner Type (0018,1508) is CARM.
void	setProjectionEponymousNameCode(Code code) Sequence A Sequence that describes the radiographic method of patient, tube and detector positioning to achieve a well described projection or view.
void	setTableAngle(float f) Angle of table plane in degrees relative to horizontal plane [Gravity plane].
void	setTableType(java.lang.String cs) Defined Terms: FIXED TILTING NONE
void	setViewCode(ViewCode code)
void	setViewPosition(java.lang.String cs) Radiographic view of the image relative to the imaging subjectÕs orientation.

Methods inherited from class org.dcm4che2.iod.module.Module

getDicomObject, getType1Tags, getType2Tags, init, updateSequence, updateSequence, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DXPositioningModule

public DXPositioningModule(DicomObject dcmobj)

Method Detail

setProjectionEponymousNameCode

public void setProjectionEponymousNameCode(Code code)

Sequence A Sequence that describes the radiographic method of patient, tube and detector positioning to achieve a well described projection or view.

Only a single Item shall be permitted in this Sequence.

Shall be consistent with the other Attributes in this Module, if present, but may more specifically describe the image acquisition.

Parameters:

codes -

getProjectionEponymousNameCode

public Code getProjectionEponymousNameCode()

setPatientPosition

public void setPatientPosition(java.lang.String cs)

Description of imaging subjectÕs position relative to the equipment.

See C.7.3.1.1.2 for Defined Terms and further explanation.

If present, shall be consistent with Patient Gantry Relationship Code Sequence (0054,0414) and Patient Orientation Modifier Code Sequence (0054,0412).

Type 3

Parameters:

cs -

getPatientPosition

public java.lang.String getPatientPosition()

setViewPosition

public void setViewPosition(java.lang.String cs)

Radiographic view of the image relative to the imaging subjectÕs orientation.

Shall be consistent with View Code Sequence (0054,0220). See C.8.11.5.1.1 for further explanation.

Type 3

Parameters:

cs -

getViewPosition

public java.lang.String getViewPosition()

setViewCode

public void setViewCode(ViewCode code)

getViewCode

public ViewCode getViewCode()

setPatientOrientationCode

public void setPatientOrientationCode(PatientOrientationCode code)

getPatientOrientationCode

public PatientOrientationCode getPatientOrientationCode()

setPatientGantryRelationshipCode

public void setPatientGantryRelationshipCode(Code code)

Sequence Sequence which describes the orientation of the patient with respect to the gantry.

Only a single Item shall be permitted in this Sequence.

Type 3

getPatientGantryRelationshipCode

public Code getPatientGantryRelationshipCode()

setDistanceSourceToPatient

public void setDistanceSourceToPatient(float f)

Distance in mm from source to the table, support or bucky side that is closest to the Imaging Subject, as measured along the central ray of the X-Ray beam.

Note:

1. This definition is less useful in terms of estimating geometric magnification than a measurement to a defined point within the Imaging Subject, but accounts for what is realistically measurable in an automated fashion in a clinical setting.
2. This measurement does not take into account any air gap between the Imaging Subject and the ÒfrontÓ of the table or bucky.
3. If the detector is not mounted in a table or bucky, then the actual position relative to the patient is implementation or operator defined.
4. This value is traditionally referred to as Source Object Distance (SOD).

See C.8.11.7 Mammography Image Module for explanation if Positioner Type (0018,1508) is MAMMOGRAPHIC.

Type 3

Parameters:

f -

getDistanceSourceToPatient

public float getDistanceSourceToPatient()

setDistanceSourceToDetector

public void setDistanceSourceToDetector(float f)

Distance in mm from source to detector center.

Note: This value is traditionally referred to as Source Image Receptor Distance (SID).

See C.8.11.7 Mammography Image Module for explanation if Positioner Type (0018,1508) is MAMMOGRAPHIC.

Type 3

Parameters:

f -

getDistanceSourceToDetector

public float getDistanceSourceToDetector()

setEstimatedRadiographicMagnificationFactor

public void setEstimatedRadiographicMagnificationFactor(float f)

Factor Ratio of Source Image Receptor Distance (SID) over Source Object Distance (SOD).

Type 3

Parameters:

f -

getEstimatedRadiographicMagnificationFactor

public float getEstimatedRadiographicMagnificationFactor()

setPositionerType

public void setPositionerType(java.lang.String cs)

Defined Terms: CARM COLUMN MAMMOGRAPHIC PANORAMIC CEPHALOSTAT RIGID NONE Notes:

1. The term CARM can apply to any positioner with 2 degrees of freedom of rotation of the X-Ray beam about the Imaging Subject.
2. The term COLUMN can apply to any positioner with 1 degree of freedom of rotation of the X-Ray beam about the Imaging Subject.

Type 3

Parameters:

cs -

getPositionerType

public java.lang.String getPositionerType()

setPositonerPrimaryAngle

public void setPositonerPrimaryAngle(float f)

Position of the X-Ray beam about the patient from the RAO to LAO direction where movement from RAO to vertical is positive, if Positioner Type (0018,1508) is CARM.

See C.8.7.5 XA Positioner Module for further explanation if Positioner Type (0018,1508) is CARM.

See C.8.11.7 Mammography Image Module for explanation if Positioner Type (0018,1508) is MAMMOGRAPHIC.

Type 3

Parameters:

f -

getPositionerPrimaryAngle

public float getPositionerPrimaryAngle()

setPositonerSecondaryAngle

public void setPositonerSecondaryAngle(float f)

Position of the X-Ray beam about the patient from the CAU to CRA direction where movement from CAU to vertical is positive, if Positioner Type (0018,1508) is CARM.

See C.8.7.5 XA Positioner Module for further explanation if Positioner Type (0018,1508) is CARM.

See C.8.11.7 Mammography Image Module for explanation if Positioner Type (0018,1508) is MAMMOGRAPHIC.

Type 3

Parameters:

f -

getPositionerSecondaryAngle

public float getPositionerSecondaryAngle()

setDetectorPrimaryAngle

public void setDetectorPrimaryAngle(float f)

Angle of the X-Ray beam in the row direction in degrees relative to the normal to the detector plane. Positive values indicate that the X-Ray beam is tilted toward higher numbered columns. Negative values indicate that the X-Ray beam is tilted toward lower numbered columns.

See C.8.7.5 XA Positioner Module for further explanation.

See C.8.11.7 Mammography Image Module for explanation if Positioner Type (0018,1508) is MAMMOGRAPHIC.

Type 3

Parameters:

f -

getDetectorPrimaryAngle

public float getDetectorPrimaryAngle()

setDetectorSecondaryAngle

public void setDetectorSecondaryAngle(float f)

Angle of the X-Ray beam in the column direction in degrees relative to the normal to the detector plane. Positive values indicate that the X-Ray beam is tilted toward lower numbered rows. Negative values indicate that the X-Ray beam is tilted toward higher numbered rows.

See C.8.7.5 XA Positioner Module for further explanation.

See C.8.11.7 Mammography Image Module for explanation if Positioner Type (0018,1508) is MAMMOGRAPHIC.

Type 3

Parameters:

f -

getDetectorSecondaryAngle

public float getDetectorSecondaryAngle()

setColumnAngulation

public void setColumnAngulation(float f)

Angle of the X-Ray beam in degree relative to an orthogonal axis to the detector plane. Positive values indicate that the tilt is toward the head of the table.

Note: The detector plane is assumed to be parallel to the table plane.

Only meaningful if Positioner Type (0018,1508) is COLUMN.

Type 3

Parameters:

f -

getColumnAngulation

public float getColumnAngulation()

setTableType

public void setTableType(java.lang.String cs)

Defined Terms: FIXED TILTING NONE

Type 3

Parameters:

cs -

getTableType

public java.lang.String getTableType()

setTableAngle

public void setTableAngle(float f)

Angle of table plane in degrees relative to horizontal plane [Gravity plane]. Positive values indicate that the head of the table is upward.

Only meaningful if Table Type (0018,113A) is TILTING.

Type 3

Parameters:

f -

getTableAngle

public float getTableAngle()

setBodyPartThickness

public void setBodyPartThickness(float f)

The average thickness in mm of the body part examined when compressed, if compression has been applied during exposure.

Type 3

Parameters:

f -

getBodyPartThickness

public float getBodyPartThickness()

setCompressionForce

public void setCompressionForce(float f)

The compression force applied to the body part during exposure, measured in Newtons.

Type 3

Parameters:

f -

getCompressionForce

public float getCompressionForce()