Class NIFTIImage

java.lang.Object
com.xinapse.multisliceimage.MultiSliceImage
com.xinapse.multisliceimage.analyze.ANZImage
com.xinapse.multisliceimage.analyze.NIFTIImage
All Implemented Interfaces:
ReadableImage, WritableImage, InfoStorer, AutoCloseable
Direct Known Subclasses:
NIFTI2Image
public class NIFTIImage extends ANZImage implements InfoStorer, AutoCloseable
This class is a representation of a multi-dimensional image in the NIFTI-1 format (see The Neuroimaging Informatics Technology Initiative), an extension of the original Analyze 7.5 format (see The Biomedical Imaging Resource). A NIFTIImage Object can be created either from two data sources (one for the header, the other for the image data), one data source (a combined header/image source), or it can be created afresh.

Both big-endian and little-endian byte ordering are implemented and supported. When reading existing images, the byte order is auto detected. When existing images are copied or modified, the original byte order is retained. For images newly-created from scratch by this package, the byte ordering the native byte order.

N.B. The Analyze format requires that for BINARY images, individual slices must begin on a byte boundary. In this implementation, that restriction is removed. If you wish to maintain compatibility with Analyze and other programs that maintain this restriction, ensure that a multi-slice/multi-frame images have slices with a number of pixels that is a multiple of 8 (bits).

N.B. When the pixel values are returned by methods such as MultiSliceImage.getPix(boolean) and MultiSliceImage.getSlice(int), the intensities are scaled according to the intensity rescaling factors that are part of the NIFTI-1 standard.

  • Field Details

    • DEFAULT_NIFTI_ONE_FILE

      public static final boolean DEFAULT_NIFTI_ONE_FILE
      Whether to store NIFTI images in one file (.nii) by default.
      See Also:

    • DEFAULT_COMPRESSED

      public static final boolean DEFAULT_COMPRESSED
      Whether to store NIFTI images compressed by default.
      See Also:

    • EXTENSION

      public static final String EXTENSION
      The file extension for NIFTI image files.
      See Also:

    • UPPERCASE_EXTENSION

      public static final String UPPERCASE_EXTENSION
      The file extension for NIFTI image files in upper case form.

    • COMPRESSED_EXTENSION

      public static final String COMPRESSED_EXTENSION
      The file extension for compressed NIFTI image files.
      See Also:

    • UPPERCASE_COMPRESSED_EXTENSION

      public static final String UPPERCASE_COMPRESSED_EXTENSION
      The file extension for compressed NIFTI image files in upper case form.

  • Constructor Details

    • NIFTIImage

      public NIFTIImage()
      Creates an uninitialised instance of a NIFTIImage. Needed so that newInstance() method can be called on the class.

    • NIFTIImage

      public NIFTIImage(short nCols, short nRows, short nSlices, short nFrames, ANZPixFormat dataType) throws ANZException
      Creates a new NIFTIImage. This image exists in memory, and will only be written with an explicit write() method call.
      Parameters:
      nCols - the number of columns in the image x-direction.
      nRows - the number of rows in the image y-direction.
      nSlices - the number of slice in the image.
      nFrames - the number of frames (time points) in the image.
      dataType - the ANZPixFormat for the image.
      Throws:
      ANZException - if the image cannot be created.

    • NIFTIImage

      public NIFTIImage(ANZPixFormat dataType, Short... dims) throws ANZException
      Creates a new NIFTIImage. This image exists in memory, and will only be written with an explicit write() method call.
      Parameters:
      dataType - an ANZPixFormat.
      dims - the number of samples in each of the image dimensions. The number of arguments supplied determines the dimensionality of the image.
      Throws:
      ANZException - if the header cannot be created.

    • NIFTIImage

      public NIFTIImage(NIFTIImage im)
      Creates a new NIFTIImage, copying it from an existing one.
      Parameters:
      im - the image to copy.

    • NIFTIImage

      public NIFTIImage(String fileName, FileAccessMode mode) throws InvalidImageException, IOException
      Opens an existing NIFTIImage, with pixel data remaining on disk until requested.
      Parameters:
      fileName - the name of the image file.
      mode - the access mode for the image.
      Throws:
      InvalidImageException - if the image cannot be opened or loaded, or if mode is invalid.
      FileNotFoundException - if the image file doesn't exist.
      IOException - if an I/O error occurs.

  • Method Details

    • getNIFTIOneFile

      public static boolean getNIFTIOneFile()
      Returns whether NIFTI images should be stored in two separate files (.hdr and .hdr) or one (.nii).

      If the system property "nifti.onefile" exists, and the property value is either "true" or "false", then the user's preference is overridden by the property value.

      Returns:
      true if NIFTI-compliant images are to be stored in one .nii file; false otherwise.

    • getPreferredNIFTIOneFile

      public static boolean getPreferredNIFTIOneFile()
      Returns the user's preference about whether NIFTI images should be stored in two separate files (.hdr and .hdr) or one (.nii).
      Returns:
      true if the user prefers to store NIFTI-compliant images in one .nii file; false otherwise.

    • savePreferredNIFTIOneFile

      public static void savePreferredNIFTIOneFile(boolean oneFile)
      Sets the user's preference about whether NIFTI images should be stored in two separate files (.hdr and .hdr) or one (.nii).
      Parameters:
      oneFile - true if the user prefers to store NIFTI-compliant images in one .nii file; false otherwise.

    • getSaveCompressed

      public static boolean getSaveCompressed()
      Returns whether Analyze 7.5 images should be stored compressed. The value is obtained either from the System Property "analyze.compressed" (preferentially) or the user's preference.
      Returns:
      true if the Analyze 7.5 images should be stored compressed; false otherwise.

    • getPreferredCompressed

      public static boolean getPreferredCompressed()
      Returns the user's preference about whether NIFTI images should be stored compressed.

      If the system property "nifti.compressed" exists, and the property value is either "true" or "false", then the user's preference is overridden by the property value.

      Returns:
      true if the user prefers to store NIFTI-compliant images compressed; false otherwise.

    • savePreferredCompressed

      public static void savePreferredCompressed(boolean compressed)
      Sets the user's preference about whether NIFTI images should be stored compressed.
      Parameters:
      compressed - true if the user prefers to store NIFTI-compliant images compressed.

    • getCopy

      public NIFTIImage getCopy()
      Creates a copy of this NIFTIImage.
      Specified by:
      getCopy in interface ReadableImage
      Specified by:
      getCopy in interface WritableImage
      Returns:
      a copy of this NIFTIImage.

    • imageExists

      public static boolean imageExists(String fileName)
      Tests whether a NIFTIImage with the given name already exists on disk. File extensions are handled in a smart and case-insensitive way.
      Parameters:
      fileName - the name of the image file to test for existence.
      Returns:
      true if either:
      • a pair of NIFTIImages .img and .hdr with the specified name exist on disk;
      • a single NIFTIImage with extension .nii exists on disk.
      false otherwise.

    • getPreviewIcon

      public static PreviewIcon getPreviewIcon(File f, boolean withImageIcon)
      Returns the PreviewIcon for an NIFTIImage, or null if the supplied File does not represent a NIFTI image.
      Parameters:
      f - the File to be tested.
      withImageIcon - whether a image preview is to be generated. Generating an image preview will take longer than not generating one.
      Returns:
      PreviewIcon if the File produces an NIFTIImage; null otherwise.

    • write

      public String write(String root) throws IOException, InvalidImageException
      Writes this NIFTIImage to disk. This method will either:
      • write that header to a .hdr file, and the image data to a .img file, or
      • write the image data to the same file as the header information in a .nii file.
      The choice depends on the magic number set in the image header (i.e., a magic number the "n+1" for a .nii file, and "ni1" for separate .hdr and .img files).
      Specified by:
      write in interface WritableImage
      Overrides:
      write in class ANZImage
      Parameters:
      root - the root of the NIFTI fileName. Will be appended with ".hdr", ".img", ".nii", ".hdr.gz", ".img.gz" or ".nii.gz" as appropriate to create the full file name(s).
      Returns:
      the actual file name used to write the image, including any added extension.
      Throws:
      InvalidImageException - if the image cannot be written.
      IOException - if an I/O error occurs.

    • getImagePositionPatient

      public org.jogamp.vecmath.Point3f getImagePositionPatient(int slice) throws IndexOutOfBoundsException
      Description copied from interface: ReadableImage
      Returns the coordinates of the center of the first pixel of the specified slice of this image, in mm, in patient coordinates.
      Specified by:
      getImagePositionPatient in interface ReadableImage
      Overrides:
      getImagePositionPatient in class ANZImage
      Parameters:
      slice - the slice number (indexed from 0) for which to return the pixel coordinates.
      Returns:
      the Left,Posterior,Superior (LPS) coordinates of the first pixel in the specified slice of this image. Returns null if the position cannot be retrieved from this image.
      Throws:
      IndexOutOfBoundsException - if the slice number is bad for this image.

    • setImagePositionPatient

      public void setImagePositionPatient(org.jogamp.vecmath.Point3f position, int slice)
      Description copied from interface: WritableImage
      Sets the coordinates of the center of the first pixel of the image, in mm, in patient (LPS) coordinates, for one slice of this image.
      Specified by:
      setImagePositionPatient in interface WritableImage
      Parameters:
      position - the Left,Posterior,Superior (LPS) coordinates of the first pixel of this specified slice in the image data matrix.
      slice - the slice for which to set the position.

    • getImageOrientationPatient

      public org.jogamp.vecmath.Vector3f[] getImageOrientationPatient(int slice) throws IndexOutOfBoundsException
      Description copied from interface: ReadableImage
      Returns the direction cosines of the row, column and slice directions (for increasing row, column and slice) of the image, in patient coordinates.
      Specified by:
      getImageOrientationPatient in interface ReadableImage
      Overrides:
      getImageOrientationPatient in class ANZImage
      Parameters:
      slice - the slice for which to return the image orientation.
      Returns:
      a Vector3f[], corresponding to the direction cosines of the image row, column and slice directions in Left,Posterior,Superior (LPS) coordinates. Returns null if the direction cosines cannot be retrieved from this image.
      Throws:
      IndexOutOfBoundsException - if the image does not have the right dimensionality or the slice number is inappropriate for this image.

    • setImageOrientationPatient

      public void setImageOrientationPatient(org.jogamp.vecmath.Vector3f[] orientation, int slice) throws IndexOutOfBoundsException
      Description copied from class: MultiSliceImage
      Sets the direction cosines of the row, column and slice directions (for increasing row, column and slice) of the image, in patient (LPS) coordinates.

      If the orientation cannot be set for this image, this method does nothing.

      Specified by:
      setImageOrientationPatient in interface WritableImage
      Specified by:
      setImageOrientationPatient in class MultiSliceImage
      Parameters:
      orientation - the direction cosines of the image row, column and (optionally) slice directions respectively in Left,Posterior,Superior (LPS) coordinates.
      slice - the slice for which to set the orientation.
      Throws:
      IndexOutOfBoundsException - if the cosines array does not have the correct dimensions.

    • supportsIntensityRescaling

      public boolean supportsIntensityRescaling()
      Returns true because NIFTI-1 images support intensity rescaling.
      Specified by:
      supportsIntensityRescaling in interface WritableImage
      Returns:
      true.

    • getIntensityRescale

      public float[] getIntensityRescale()
      Description copied from interface: ReadableImage
      Returns the values m and b in the relationship between pixel intensity (I) values and the output units specified in getRescaleUnits() in the expression:
      Output units = m*I + b.
      Specified by:
      getIntensityRescale in interface ReadableImage
      Returns:
      an array will be of length 2 where the first element is m and the second is b.

    • setIntensityRescale

      public void setIntensityRescale(float rescaleSlope, float rescaleIntercept)
      Description copied from interface: WritableImage
      Sets the values m and b in the relationship between pixel intensity (I) values and the output units specified in WritableImage.setRescaleUnits(com.xinapse.dicom.RescaleUnits) in the expression:
      Output units = m*I + b.
      Specified by:
      setIntensityRescale in interface WritableImage
      Parameters:
      rescaleSlope - the value of m in the expression above.
      rescaleIntercept - the value of b in the expression above.

    • getRescaleUnits

      public com.xinapse.dicom.RescaleUnits getRescaleUnits()
      Returns RescaleUnits.US.
      Specified by:
      getRescaleUnits in interface ReadableImage
      Overrides:
      getRescaleUnits in class ANZImage
      Returns:
      com.xinapse.dicom.RescaleUnits.US.

    • setRescaleUnits

      public void setRescaleUnits(com.xinapse.dicom.RescaleUnits units)
      Description copied from interface: WritableImage
      Sets the rescale units.
      Specified by:
      setRescaleUnits in interface WritableImage
      Parameters:
      units - the rescale units.

    • getCommonName

      public static String getCommonName()
      Returns the common name for this type of image.
      Returns:
      the String "NIFTI-1".

    • getImageTypeName

      public String getImageTypeName()
      Returns the human readable name for this type of image.
      Specified by:
      getImageTypeName in interface WritableImage
      Returns:
      a String like "NIFTI-1" or "NIFTI-2".

    • getQForm

      public NIFTIXForm getQForm()
      Returns the qForm in this NIFTIImage.
      Returns:
      the qForm set in this NIFTIImage.

    • setQForm

      public void setQForm(NIFTIXForm qForm) throws ANZException
      Sets the qForm code in this NIFTIImage.
      Parameters:
      qForm - the qForm to set in this NIFTIImage.
      Throws:
      ANZException - if the qForm cannot be set.

    • getSForm

      public NIFTIXForm getSForm()
      Returns the sForm in this NIFTIImage.
      Returns:
      the sForm in this NIFTIImage.

    • setSForm

      public void setSForm(NIFTIXForm sForm) throws ANZException
      Sets the sForm code in this NIFTIImage.
      Parameters:
      sForm - the sForm to set in this NIFTIImage.
      Throws:
      ANZException - if the sForm cannot be set.

    • getSFormAffineTransform

      public AffineTransform3D getSFormAffineTransform() throws ParameterNotSetException
      Returns the general (sForm) AffineTransform3D that will transform the pixel indices (colIdx, rowIdx, sliceIdx) to a position in space in a patient-centric coordinate system.
      N.B. Note: the patient-centric coordinate system is different from that defined in the NIFTI-1 standard. Jim's coordinate system is a left-handed system, with:
      • The first coordinate increasing to the patient left (L).
      • The second coordinate increasing to the patient posterior (P).
      • The third coordinate increasing to the patient superior (S).
      This is the standard radiological coordinate system, and is different from NIFTI's.
      Returns:
      the AffineTransform3D that will transform the pixel indices (colIdx, rowIdx, sliceIdx) to a position in space in the patient-centric coordinate system. The pixel indices can be transformed to the (L,P,S) coordinate by applying: 
      // Create a point for the pixel indices.
Point3f ijk = new Point3f(i, j, k);
Point3f lps = new Point3f();
// The lps coordinate of the point is returned.
Point3f lps = header.getAffineTransform().transform(ijk, lps);
      Throws:
      ParameterNotSetException - if the AffineTransform cannot be retrieved.

    • setSFormAffineTransform

      public void setSFormAffineTransform(AffineTransform3D tX) throws ANZException
      Sets the NIFTI sForm affine transform parameters to locate the image volume in patient-centred 3-dimensional space. The user supplies the AffineTransform3D that will transform the pixel indices (colIdx, rowIdx, sliceIdx) to a position in space in the patient-centric coordinate system.
      N.B. Note: the patient-centric coordinate system is different from that defined in the NIFTI-1 standard. Jim's coordinate system is a left-handed system, with:
      • The first coordinate increasing to the patient left (L).
      • The second coordinate increasing to the patient posterior (P).
      • The third coordinate increasing to the patient superior (S).
      This is the standard radiological coordinate system, and is different from NIFTI's. Note, however, that the qform parameters written to the NIFTIHeader will be correct according to the NIFTI-1 standard, ensuring compatibility with other NIFTI-aware that use the images.
      Parameters:
      tX - the AffineTransform3D that will transform pixel indices to patient-centred 3-dimensional (L,P,S) space.
      Throws:
      ANZException - if the transform cannot be set.

    • getIntent

      public NIFTIIntent getIntent()
      Returns the NIFTIIntent in this NIFTIImage.
      Returns:
      the NIFTIIntent set in this NIFTIImage.

    • setIntent

      public void setIntent(NIFTIIntent intent) throws ANZException
      Sets the NIFTIIntent in this NIFTIImage.
      Parameters:
      intent - the NIFTIIntent to set in this NIFTIImage.
      Throws:
      ANZException - if the intent cannot be set.

    • getPatientPosition

      public PatientPosition getPatientPosition()
      Description copied from interface: ReadableImage
      Returns the position in which the patient is lying in the scanning equipment. For example, PatientPosition.HFS (head-first supine).
      Specified by:
      getPatientPosition in interface ReadableImage
      Returns:
      the position in which the patient is lying in the scanning equipment, or null if the patient position cannot be determined.

    • setPatientPosition

      public void setPatientPosition(PatientPosition position)
      Description copied from interface: WritableImage
      Sets the position in which the patient is lying in the scanning equipment for this WritableImage.
      Specified by:
      setPatientPosition in interface WritableImage
      Parameters:
      position - the position in which the patient is lying in the scanning equipment. e.g. PatientPosition.HFS (head-first supine).

    • setScanDate

      public void setScanDate(Date scanDate)
      Description copied from interface: WritableImage
      Sets the scan date/time for this image.
      Specified by:
      setScanDate in interface WritableImage
      Parameters:
      scanDate - the new scan date/time to be assigned to this image.

    • setPulseSequence

      public void setPulseSequence(String seqName)
      Description copied from interface: WritableImage
      Sets the pulse sequence name for this image.
      Specified by:
      setPulseSequence in interface WritableImage
      Parameters:
      seqName - the new name of the pulse sequence to be assigned to this image.

    • setScanningSequence

      public void setScanningSequence(PulseSequenceType seq)
      Description copied from interface: WritableImage
      Sets the DICOM scanning sequence for this image.
      Specified by:
      setScanningSequence in interface WritableImage
      Parameters:
      seq - the new scanning sequence to be assigned to this image.

    • setSequenceVariant

      public void setSequenceVariant(PulseSequenceVariant seqVar)
      Description copied from interface: WritableImage
      Sets the DICOM scanning sequence variant for this image.
      Specified by:
      setSequenceVariant in interface WritableImage
      Parameters:
      seqVar - the new scanning sequence variant to be assigned to this image.

    • setSeriesNumber

      public void setSeriesNumber(Integer seriesNumber)
      Description copied from interface: WritableImage
      Sets the series number for this image.
      Specified by:
      setSeriesNumber in interface WritableImage
      Parameters:
      seriesNumber - the new series number to be assigned to this image.

    • setSeriesDescription

      public void setSeriesDescription(String description)
      Description copied from interface: WritableImage
      Sets a short description of the series (scan).
      Specified by:
      setSeriesDescription in interface WritableImage
      Parameters:
      description - the new short description of the series, or null if none is available.

    • getSliceThickness

      public Float getSliceThickness()
      Description copied from interface: ReadableImage
      Returns the slice thickness (in mm). This method is necessary because the slice thickness may not be the same as the inter-slice pixel spacing, if there is a gap between slices.
      Specified by:
      getSliceThickness in interface ReadableImage
      Returns:
      the slice thickness in mm, or null if the slice thickness is not set, or its value is corrupt.

    • setSliceThickness

      public void setSliceThickness(Float thickness)
      Description copied from interface: WritableImage
      Sets the slice thickness (in mm). This method is necessary because the slice thickness may not be the same as the inter-slice pixel spacing, if there is a gap between slices.
      Specified by:
      setSliceThickness in interface WritableImage
      Parameters:
      thickness - the slice thickness in mm, or null to remove the slice thickness information.

    • getBodyPart

      public com.xinapse.dicom.BodyPart getBodyPart()
      Description copied from class: MultiSliceImage
      By default, body part recording is not supported, so this method always returns null.
      Specified by:
      getBodyPart in interface ReadableImage
      Overrides:
      getBodyPart in class MultiSliceImage
      Returns:
      null.

    • setBodyPart

      public void setBodyPart(com.xinapse.dicom.BodyPart bodyPart)
      Description copied from class: MultiSliceImage
      By default, body part recording is not supported, so this method does nothing.
      Specified by:
      setBodyPart in interface WritableImage
      Overrides:
      setBodyPart in class MultiSliceImage
      Parameters:
      bodyPart - body the imaged body part.

    • getLaterality

      public com.xinapse.dicom.Laterality getLaterality()
      Description copied from class: MultiSliceImage
      By default, laterality recording is not supported, so this method returns Laterality.BOTH.
      Specified by:
      getLaterality in interface ReadableImage
      Overrides:
      getLaterality in class MultiSliceImage
      Returns:
      Laterality.BOTH.

    • setLaterality

      public void setLaterality(com.xinapse.dicom.Laterality laterality)
      Description copied from class: MultiSliceImage
      By default, laterality recording is not supported, so this method does nothing.
      Specified by:
      setLaterality in interface WritableImage
      Overrides:
      setLaterality in class MultiSliceImage
      Parameters:
      laterality - the image laterality.

    • getScanTR

      public Float getScanTR()
      Returns the scan repetition time for this image.
      Specified by:
      getScanTR in interface ReadableImage
      Returns:
      the scan TR for this image.

    • setScanTR

      public void setScanTR(Float TR)
      Sets the scan repetition time for this image. N.B. For disk-based images, the changes in the scan TR will not be reflected on disk unless the close() method is called.
      Specified by:
      setScanTR in interface WritableImage
      Parameters:
      TR - the new scan TR to be assigned to this image.

    • getScanTI

      public Float getScanTI()
      Returns the scan inversion time for this image.
      Specified by:
      getScanTI in interface ReadableImage
      Returns:
      the scan TI for this image.

    • setScanTI

      public void setScanTI(Float TI)
      Sets the scan inversion time for this image. N.B. For disk-based images, the changes in the scan TI will not be reflected on disk unless the close() method is called.
      Specified by:
      setScanTI in interface WritableImage
      Parameters:
      TI - the new scan TI to be assigned to this image.

    • getScanTE

      public Float getScanTE()
      Returns the scan echo time for this image if it has a single echo-time.
      Specified by:
      getScanTE in interface ReadableImage
      Returns:
      the scan TE for this image.

    • setScanTE

      public void setScanTE(Float TE)
      Description copied from interface: WritableImage
      Sets the scan echo time for this image. No exception occurs if the image format does not support scan TE recording.
      Specified by:
      setScanTE in interface WritableImage
      Parameters:
      TE - the new scan TE to be assigned to this image. If null, the TE should be unset.

    • getFrameTE

      public Float getFrameTE(int frame) throws IndexOutOfBoundsException
      Description copied from interface: ReadableImage
      Returns the scan echo time for one dimension index of this image. For 3-D images, the dimension index is the slice dimension. For 4-D (or higher dimensionality) images, the dimension index is the frame dimension.
      Specified by:
      getFrameTE in interface ReadableImage
      Parameters:
      frame - the index for which to return the echo time.
      Returns:
      the TE for the specified frame of this image, or null if not set for this image.
      Throws:
      IndexOutOfBoundsException - if the index is bad for this image.

    • setFrameTE

      public void setFrameTE(Float TE, int frame)
      Description copied from interface: WritableImage
      Sets the scan echo time for one dimension index of this image. For 3-D images, the dimension index is the slice dimension. For 4-D (or higher dimensionality) images, the dimension index is the frame dimension. No exception occurs if the image format does not support a scan TE recording.
      Specified by:
      setFrameTE in interface WritableImage
      Parameters:
      TE - the new scan TE to be assigned to this image.
      frame - the index to the image frame for which to set the echo time. For 3-D images, this is the slice number; for 4-D images it is the frame number.

    • getDICOMImageType

      public String[] getDICOMImageType()
      Description copied from interface: ReadableImage
      Returns the DICOM image type this image.
      Specified by:
      getDICOMImageType in interface ReadableImage
      Returns:
      the DICOM image type for this image, or null if not set for this image.

    • setDICOMImageType

      public void setDICOMImageType(String[] imageTypes)
      Description copied from interface: WritableImage
      Sets the type of image, in the same way that a DICOM Element with Tag <0x0008, 0x0008> does. No exception occurs if the image format does not support setting of the image type.
      Specified by:
      setDICOMImageType in interface WritableImage
      Parameters:
      imageTypes - a String[] with the important image identification characteristics. If null, the image type should be unset.

    • getFrameDICOMImageType

      public String[] getFrameDICOMImageType(int index) throws IndexOutOfBoundsException
      Description copied from interface: ReadableImage
      Returns the DICOM image type for one dimension index of this image. For 3-D images, the dimension index is the slice dimension. For 4-D (or higher dimensionality) images, the dimension index is the frame dimension.
      Specified by:
      getFrameDICOMImageType in interface ReadableImage
      Parameters:
      index - the frame for which to return the image type.
      Returns:
      the image type for the specified index of this image, or null if not set for this image.
      Throws:
      IndexOutOfBoundsException - if the index is bad for this image.

    • setFrameDICOMImageType

      public void setFrameDICOMImageType(String[] imageTypes, int index)
      Description copied from interface: WritableImage
      Sets the type of image for one for one dimension index of this image, in the same way that a DICOM Element with Tag <0x0008, 0x0008> does. For 3-D images, the dimension index is the slice dimension. For 4-D (or higher dimensionality) images, the dimension index is the frame dimension. No exception occurs if the image format does not support setting of the image type.
      Specified by:
      setFrameDICOMImageType in interface WritableImage
      Parameters:
      imageTypes - a {link String}[] with the important image identification characteristics for the given farme. If null, the image type should be unset.
      index - the index to the image frame for which to set the image type. For 3-D images, this is the slice number; for 4-D images it is the frame number.

    • getSaturationFreqOffsetPPM

      public Float getSaturationFreqOffsetPPM()
      Returns the saturation pulse frequency offset for this image if it has a single saturation pulse frequency offset.
      Specified by:
      getSaturationFreqOffsetPPM in interface ReadableImage
      Returns:
      the saturation pulse frequency offset for this image, in PPM.

    • setSaturationFreqOffsetPPM

      public void setSaturationFreqOffsetPPM(Float freqOffset)
      Sets the saturation pulse frequency offset for this image, for images with a single saturation pulse frequency offset.
      N.B. For disk-based images, the changes in the saturation pulse frequency offset will not be reflected on disk unless the close() method is called.
      Specified by:
      setSaturationFreqOffsetPPM in interface WritableImage
      Parameters:
      freqOffset - the new saturation pulse frequency offset to be assigned to this image.

    • getFrameSaturationFreqOffsetPPM

      public Float getFrameSaturationFreqOffsetPPM(int index) throws IndexOutOfBoundsException
      Description copied from interface: ReadableImage
      Returns the scan saturation frequency offset for one dimension index of this image in parts-per-million. For 3-D images, the dimension index is the slice dimension. For 4-D (or higher dimensionality) images, the dimension index is the frame dimension.
      Specified by:
      getFrameSaturationFreqOffsetPPM in interface ReadableImage
      Parameters:
      index - the frame for which to return the saturation frequency offset.
      Returns:
      the scan TE for the specified index of this image, or null if not set for this image.
      Throws:
      IndexOutOfBoundsException - if the index is bad for this image.

    • setFrameSaturationFreqOffsetPPM

      public void setFrameSaturationFreqOffsetPPM(Float freqOffset, int index)
      Description copied from interface: WritableImage
      Sets the saturation frequency offset for one dimension index of this image. For 3-D images, the dimension index is the slice dimension. For 4-D (or higher dimensionality) images, the dimension index is the frame dimension. No exception occurs if the image format does not support saturation frequency offset recording.
      Specified by:
      setFrameSaturationFreqOffsetPPM in interface WritableImage
      Parameters:
      freqOffset - the new saturation frequency offset to be assigned to this image.
      index - the index to the image frame for which to set the saturation frequency offset. For 3-D images, this is the slice number; for 4-D images it is the frame number.

    • getEchoTrainLength

      public Integer getEchoTrainLength()
      Returns the echo train length for this image.
      Specified by:
      getEchoTrainLength in interface ReadableImage
      Returns:
      the echo train length for this image.

    • setEchoTrainLength

      public void setEchoTrainLength(Integer etl)
      Sets the echo train length for this image. N.B. For disk-based images, the changes in the echo train length will not be reflected on disk unless the close() method is called.
      Specified by:
      setEchoTrainLength in interface WritableImage
      Parameters:
      etl - the new echo train length to be assigned to this image; null if the echo train length is to be unassigned.

    • getFlipAngle

      public Float getFlipAngle()
      Returns the excitation pulse flip angle for this image.
      Specified by:
      getFlipAngle in interface ReadableImage
      Returns:
      the excitation pulse flip angle for this image.

    • setFlipAngle

      public void setFlipAngle(Float flipAngle)
      Sets the excitation pulse flip angle for this image.
      N.B. For disk-based images, the changes in the scan flip angle will not be reflected on disk unless the close() method is called.
      Specified by:
      setFlipAngle in interface WritableImage
      Parameters:
      flipAngle - the new scan flip angle to be assigned to this image.

    • getFrameDWbValue

      public Float getFrameDWbValue(int frame) throws IndexOutOfBoundsException
      Description copied from interface: ReadableImage
      Returns the diffusion-weighting b-value for one frame of this image.
      Specified by:
      getFrameDWbValue in interface ReadableImage
      Parameters:
      frame - the frame number for which to return the b-value.
      Returns:
      the diffusion-weighting b-value for the specified frame of this image, or null if the b-value cannot be found, or if the modality used to collect the image doesn't have a b-value defined
      Throws:
      IndexOutOfBoundsException - if the frame number is bad for this image.

    • setFrameDWbValue

      public void setFrameDWbValue(float bValue, int frame)
      Description copied from interface: WritableImage
      Sets the diffusion-weighting b-value for one "frame" of this image. No exception occurs if the image format does not support recording the b-value.
      Specified by:
      setFrameDWbValue in interface WritableImage
      Parameters:
      bValue - the new b-value to be assigned to this image.
      frame - the index to the image frame for which to set the b-value. For 3-D images, this is the slice number; for 4-D images it is the frame number.

    • getFrameDWGradientVector

      public org.jogamp.vecmath.Vector3f getFrameDWGradientVector(int frame) throws IndexOutOfBoundsException
      Description copied from interface: ReadableImage
      Returns the diffusion-weighting gradient-vector for one frame of this image.
      Specified by:
      getFrameDWGradientVector in interface ReadableImage
      Parameters:
      frame - the frame number for which to return the gradient-vector.
      Returns:
      the diffusion-weighting gradient-vector for the specified frame of this image, or null if the gradient vector cannot be found, or if the modality used to collect the image doesn't have a gradient vector defined.
      Throws:
      IndexOutOfBoundsException - if the frame number is bad for this image.

    • setFrameDWGradientVector

      public void setFrameDWGradientVector(org.jogamp.vecmath.Vector3f gradVec, int frame)
      Description copied from interface: WritableImage
      Sets the diffusion-weighting gradient vector for one "frame" of this image. No exception occurs if the image format does not support recording the gradient vector.
      Specified by:
      setFrameDWGradientVector in interface WritableImage
      Parameters:
      gradVec - the new gradient vector to be assigned to this image.
      frame - the index to the image frame for which to set the gradient vector. For 3-D images, this is the slice number; for 4-D images it is the frame number.

    • getFrameDWBMatrix

      public float[] getFrameDWBMatrix(int frame) throws IndexOutOfBoundsException
      Description copied from interface: ReadableImage
      Returns the diffusion-weighting b-matrix for one frame of this image.
      Specified by:
      getFrameDWBMatrix in interface ReadableImage
      Parameters:
      frame - the frame number for which to get the b-matrix.
      Returns:
      the diffusion-weighting b-matrix for this image if it is a magnetic resonance image, or null if the B-matrix cannot be found, or if the modality used to collect the image doesn't have a B-matrix defined. The 6 unique matrix elements are returned as a float[] with elements in the order bXX, bXY, bXZ, bYY, bYZ, bZZ.
      Throws:
      IndexOutOfBoundsException - if the frame number is bad for this image.

    • setFrameDWBMatrix

      public void setFrameDWBMatrix(float[] bMatrix, int frame)
      Description copied from interface: WritableImage
      Sets the diffusion-weighting B-matrix for one "frame" of this image. No exception occurs if the image format does not support recording the B-matrix.
      Specified by:
      setFrameDWBMatrix in interface WritableImage
      Parameters:
      bMatrix - the new B-matrix to be assigned to this image.
      frame - the index to the image frame for which to set the B-matrix. For 3-D images, this is the slice number; for 4-D images it is the frame number.

    • getFrameTriggerDelayMS

      public Float getFrameTriggerDelayMS(int frame) throws IndexOutOfBoundsException
      Description copied from interface: ReadableImage
      Returns the trigger delay, in milliseconds, for one frame of this image.
      Specified by:
      getFrameTriggerDelayMS in interface ReadableImage
      Parameters:
      frame - the frame number for which to get the trigger delay.
      Returns:
      the trigger delay (in milliseconds) for this image, or null if the trigger delay cannot be found.
      Throws:
      IndexOutOfBoundsException - if the frame number is bad for this image.

    • setFrameTriggerDelayMS

      public void setFrameTriggerDelayMS(float delay, int frame)
      Description copied from interface: WritableImage
      Sets the trigger delay (in milliseconds) for one "frame" of this image. No exception occurs if the image format does not support recording the trigger delay.
      Specified by:
      setFrameTriggerDelayMS in interface WritableImage
      Parameters:
      delay - the new trigger delay to be assigned to this image.
      frame - the index to the image frame for which to set the trigger delay. For 3-D images, this is the slice number; for 4-D images it is the frame number.

    • getPatientName

      public String getPatientName()
      Returns the patient name for this image.
      Specified by:
      getPatientName in interface ReadableImage
      Returns:
      the patient name for this image, or null if the patient name can't be found.

    • setPatientName

      public void setPatientName(String patientName)
      Description copied from interface: WritableImage
      Attempts to set the patient name for this image. If new patient name String is longer than is allowed by the image format, then it is truncated before being applied. No exception occurs if the image format does not support patient name recording.
      Specified by:
      setPatientName in interface WritableImage
      Parameters:
      patientName - the new patient name to be assigned to this image.

    • getPatientID

      public String getPatientID()
      Returns the patient ID for this image.
      Specified by:
      getPatientID in interface ReadableImage
      Returns:
      the patientID for this image, or null if the patientID can't be found.

    • setPatientID

      public void setPatientID(String patientID)
      Description copied from interface: WritableImage
      Sets the patient ID for this image. If the new patient ID String is longer than is allowed by the image format, then it is truncated before being applied. No exception occurs if the image format does not support patient ID recording.
      Specified by:
      setPatientID in interface WritableImage
      Parameters:
      patientID - the new patient ID to be assigned to this image.

    • getPatientDoB

      public Date getPatientDoB()
      Description copied from interface: ReadableImage
      Returns the patient date of birth for this image.
      Specified by:
      getPatientDoB in interface ReadableImage
      Returns:
      the patient's date of birth for this image, or null if the patient's dob can't be found.

    • setPatientDoB

      public void setPatientDoB(Date patientDoB)
      Description copied from interface: WritableImage
      Sets the patient's date of birth for this image. No exception occurs if the image format does not support patient date of birth recording.
      Specified by:
      setPatientDoB in interface WritableImage
      Parameters:
      patientDoB - the new patient date of birth to be assigned to this image.

    • getPatientSex

      public com.xinapse.dicom.Sex getPatientSex()
      Description copied from interface: ReadableImage
      Returns the patient sex for this image.
      Specified by:
      getPatientSex in interface ReadableImage
      Returns:
      the patient's sex image, or Sex.OTHER if the patient's sex can't be found.

    • setPatientSex

      public void setPatientSex(com.xinapse.dicom.Sex sex)
      Description copied from interface: WritableImage
      Sets the patient sex for this image.
      Specified by:
      setPatientSex in interface WritableImage
      Parameters:
      sex - the patient sex to be assigned to this image.

    • getStudyID

      public String getStudyID()
      Description copied from interface: ReadableImage
      Returns the study ID for this ReadableImage.
      Specified by:
      getStudyID in interface ReadableImage
      Returns:
      the study ID. Returns null if the study ID can't be found.

    • setStudyID

      public void setStudyID(String studyID)
      Description copied from interface: WritableImage
      Sets the study ID for this image.
      Specified by:
      setStudyID in interface WritableImage
      Parameters:
      studyID - the new study ID to be assigned to this image.

    • getScanDate

      public Date getScanDate()
      Returns the scan date for this image.
      Specified by:
      getScanDate in interface ReadableImage
      Returns:
      the date/time at which this scan was performed, or null if the scan date can't be found.

    • getPulseSequence

      public String getPulseSequence()
      Description copied from interface: ReadableImage
      Returns the name of the pulse sequence with which this image was collected.
      Specified by:
      getPulseSequence in interface ReadableImage
      Returns:
      the name of the pulse sequence used to collect this image.

    • getScanningSequence

      public PulseSequenceType getScanningSequence()
      Description copied from interface: ReadableImage
      Returns the DICOM Scanning Sequence with which this image was collected.
      Specified by:
      getScanningSequence in interface ReadableImage
      Returns:
      the DICOM Scanning Sequence used to collect this image, or null if the scanning sequence isn't available.

    • getSequenceVariant

      public PulseSequenceVariant getSequenceVariant()
      Description copied from interface: ReadableImage
      Returns the DICOM Scanning Sequence Variant with which this image was collected.
      Specified by:
      getSequenceVariant in interface ReadableImage
      Returns:
      the DICOM Scanning Sequence Variant used to collect this image, or null if the sequence variant isn't available.

    • getSeriesNumber

      public Integer getSeriesNumber()
      Description copied from interface: ReadableImage
      Returns the series number for this ReadableImage.
      Specified by:
      getSeriesNumber in interface ReadableImage
      Returns:
      the series number. Returns null if the series number can't be found.

    • getSeriesDescription

      public String getSeriesDescription()
      Description copied from interface: ReadableImage
      Returns a short description of the series (scan), such as is provided by the DICOM series description.
      Specified by:
      getSeriesDescription in interface ReadableImage
      Returns:
      a short description of the series, or null if none is available.

    • anonymise

      public void anonymise(String patientName, String patientID, Date birthDate, boolean patSex, String patAddr, String patInsurancePlanID, String accessionNumber, boolean patOther, String physicianName, String physicianAddr, String institutionName, String institutionAddr, String deptName, String stationName, String telNumber, boolean removePrivateElements)
      Description copied from interface: WritableImage
      Anonymise this WritableImage.
      Specified by:
      anonymise in interface WritableImage
      Overrides:
      anonymise in class ANZImage
      Parameters:
      patientName - if non-null, the patient name to substitute.
      patientID - if non-null, the patient ID to substitute.
      birthDate - if non-null, the birth date to substitute.
      patSex - if true, set the sex to "OTHER".
      patAddr - if non-null, the address to substitute.
      patInsurancePlanID - if non-null, the insurance plan ID to substitute.
      accessionNumber - if non-null, the accession number to substitute.
      patOther - if true, other patient-related items will be anonymised.
      physicianName - if non-null, the physician name to substitute.
      physicianAddr - if non-null, the physician's address to substitute.
      institutionName - if non-null, the institution name to substitute.
      institutionAddr - if non-null, the institution address to substitute.
      deptName - if non-null, the department name to substitute.
      stationName - if non-null, the station name to substitute.
      telNumber - if non-null, the telephone number to substitute for all telephone numbers.
      removePrivateElements - if true, all private DICOM elements will be removed.

    • appendAuditInfo

      public void appendAuditInfo(String name, String value)
      Appends audit trail information to this image.
      Specified by:
      appendAuditInfo in interface WritableImage
      Parameters:
      name - a String describing the name of the action that was performed on this image.
      value - a String describing the value of the action that was performed on this image.

    • putInfo

      public void putInfo(String name, int value)
      Description copied from interface: InfoStorer
      Adds an item to the general file info.
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the MultiSliceImage.close() method is called.
      Specified by:
      putInfo in interface InfoStorer
      Parameters:
      name - the name of the information field to put.
      value - an integer value to be associated with the name in the general file information.

    • putInfo

      public void putInfo(String name, float value)
      Description copied from interface: InfoStorer
      Adds an item to the general file info. If an info item with the same name exists, then then value will be overwritten.
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the MultiSliceImage.close() method is called.
      Specified by:
      putInfo in interface InfoStorer
      Parameters:
      name - the name of the information to put.
      value - a floating point value to be associated with the name in the general file information.

    • putInfo

      public void putInfo(String name, String value) throws IllegalStateException
      Description copied from interface: InfoStorer
      Adds an item to the general file info. If an info item with the same name exists, then then value will be overwritten.
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the MultiSliceImage.close() method is called.
      Specified by:
      putInfo in interface InfoStorer
      Parameters:
      name - the name of the information to put.
      value - a String to be associated with the name in the general file information.
      Throws:
      IllegalStateException

    • putInfo

      public void putInfo(String name, int value, int dim, int n)
      Description copied from interface: InfoStorer
      Adds an item to the dimension-specific information. If an info item with the same name exists, then then value will be overwritten.
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the MultiSliceImage.close() method is called.
      Specified by:
      putInfo in interface InfoStorer
      Parameters:
      name - the name of the information item to put.
      value - an integer value to be associated with the name in the general file information.
      dim - the dimension of this InfoStorer to put the information item. For example in a 3-dimensional image you would put to dimension 0 for slice-specific info.
      n - the element to put to. For example in a 3-dimensional image you would put to slice n to info that applied only to slice n.

    • putInfo

      public void putInfo(String name, float value, int dim, int n)
      Description copied from interface: InfoStorer
      Adds an item to the dimension-specific information. If an info item with the same name exists, then then value will be overwritten.
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the close() method is called.
      Specified by:
      putInfo in interface InfoStorer
      Parameters:
      name - the name of the information item to put.
      value - an floating-point value to be associated with the name in the dimension-specific information.
      dim - the dimension of this InfoStorer to put the information. For example in a 3-dimensional image you would put to dimension 0 for slice-specific info.
      n - the element to put to. For example in a 3-dimensional image you would put to slice n to info that applied only to slice n.

    • putInfo

      public void putInfo(String name, String value, int dim, int n)
      Description copied from interface: InfoStorer
      Adds an item to the dimension-specific information. If an info item with the same name exists, then then value will be overwritten.
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the close() method is called.
      Specified by:
      putInfo in interface InfoStorer
      Parameters:
      name - the name of the information item to put.
      value - a String value to be associated with the name in the dimension-specific information.
      dim - the dimension of this InfoStorer to put the information. For example in a 3-dimensional image you would put to dimension 0 for slice-specific info.
      n - the element to put to. For example in a 3-dimensional image you would put to slice n to info that applied only to slice n.

    • putSliceInfo

      public void putSliceInfo(InfoList infoList, int slice)
      Description copied from interface: InfoStorer
      Adds all the items in an InfoList to the slice-specific information. If an info item with the same name exists, then then value will be overwritten.

      The slice number is referenced from 0 to (number of slices - 1).
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the MultiSliceImage.close() method is called.

      Specified by:
      putSliceInfo in interface InfoStorer
      Parameters:
      infoList - the list of InfoItems to put.
      slice - the slice number.

    • putFrameInfo

      public void putFrameInfo(InfoList infoList, int frame)
      Description copied from interface: InfoStorer
      Adds all the items in an InfoList to the frame-specific information. If an info item with the same name exists, then the value will be overwritten.

      The frame number is referenced from 0 to (number of frames - 1).
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the MultiSliceImage.close() method is called.

      Specified by:
      putFrameInfo in interface InfoStorer
      Parameters:
      infoList - the list of InfoItems to put.
      frame - the frame number.

    • putSliceInfo

      public void putSliceInfo(String name, String value, int slice)
      Description copied from interface: InfoStorer
      Adds an item to the slice-specific information. If an info item with the same name exists, then then value will be overwritten.

      The slice number is referenced from 0 to (number of slices - 1).
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the MultiSliceImage.close() method is called.

      Specified by:
      putSliceInfo in interface InfoStorer
      Parameters:
      name - the name of the information item to put.
      value - a String to be associated with the name in the slice-specific info.
      slice - the slice number.

    • putFrameInfo

      public void putFrameInfo(String name, String value, int frame)
      Description copied from interface: InfoStorer
      Adds an item to the frame-specific information. If an info item with the same name exists, then then value will be overwritten.

      The frame number is referenced from 0 to (number of frames).
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the MultiSliceImage.close() method is called.

      Specified by:
      putFrameInfo in interface InfoStorer
      Parameters:
      name - the name of the information item to put.
      value - a String to be associated with the name in the frame-specific info.
      frame - the frame number.

    • getInfo

      public String getInfo(String name)
      Description copied from interface: InfoStorer
      Returns a string representing the value of an information item in the general image information.

      For example, if there is a item with a name "pixel_x_size" and a value "0.91162" in the general info, and name "pixel_x_size" is supplied, then this method will return "0.91162".

      Specified by:
      getInfo in interface InfoStorer
      Parameters:
      name - the name of an information field.
      Returns:
      a String representation of the value of an information field, or null if the name is not found in the general info.

    • getInfo

      public String getInfo(String name, int dim, int n)
      Description copied from interface: InfoStorer
      Returns a String representing the value of an information item in a particular dimension of this InfoStorer. For example, if there is a item "pixel_x_size=0.91162" in the info for the dimension, and a name "pixel_x_size" is supplied, then this method will return "0.91162".
      Specified by:
      getInfo in interface InfoStorer
      Parameters:
      name - the name of the information item.
      dim - the dimension of the image to look for the information. For example in a 3-dimensional image you would look in dimension 0 for slice-specific info.
      n - the element to look in. For example in a 3-dimensional image you would look in slice n to info that applied only to slice n.
      Returns:
      a String representation of the value of the information, or null if the name is not found in the dimension/element info.

    • getSliceInfo

      public String getSliceInfo(String name, int slice)
      Description copied from interface: InfoStorer
      Returns a String representing the value of the information item in a particular slice of this InfoStorer.

      The slice number is referenced from 0 to (number of slices - 1).

      Specified by:
      getSliceInfo in interface InfoStorer
      Parameters:
      name - the name of the information item.
      slice - the slice number.
      Returns:
      a String representation of the value of the information, or null if the name is not found for the specified slice.

    • getFrameInfo

      public String getFrameInfo(String name, int frame)
      Description copied from interface: InfoStorer
      Returns a String representing the value of the information item in a particular frame of this InfoStorer.

      The frame number is referenced from 0 to (number of frames - 1).

      Specified by:
      getFrameInfo in interface InfoStorer
      Parameters:
      name - the name of the information item.
      frame - the frame number.
      Returns:
      a String representation of the value of the information, or null if the name is not found for the specified frame.

    • removeInfo

      public void removeInfo(String name)
      Description copied from interface: InfoStorer
      Removes an item from the general file information. If an info item with the given name is not present in the general info, then this method does nothing.
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the MultiSliceImage.close() method is called.
      Specified by:
      removeInfo in interface InfoStorer
      Parameters:
      name - the name of the information item to be removed.

    • removeInfo

      public void removeInfo(String name, int dim, int n)
      Description copied from interface: InfoStorer
      Removes an item from the dimension-specific information. If an info item with the given name is not present in the dimension-specific, then this method does nothing.
      N.B. For disk-based images, the changes in the info will not be reflected on disk unless the MultiSliceImage.close() method is called.
      Specified by:
      removeInfo in interface InfoStorer
      Parameters:
      name - the name of the information item to put.
      dim - the dimension of this InfoStorer to from which to remove the information. For example in a 3-dimensional image you would put to dimension 0 for slice-specific info.
      n - the element to from which to remove the info item. For example in a 3-dimensional image you would put to slice n to info that applied only to slice n.

    • getInfoList

      public InfoList getInfoList()
      Description copied from interface: InfoStorer
      Returns an InfoList object which is the general info for this InfoStorer.
      Specified by:
      getInfoList in interface InfoStorer
      Returns:
      an InfoList which is the general file info for this InfoStorer.

    • setInfoList

      public void setInfoList(InfoList infoList)
      Description copied from interface: InfoStorer
      Sets a new InfoList to the general file info of this InfoStorer.
      Specified by:
      setInfoList in interface InfoStorer
      Parameters:
      infoList - the InfoList object to set to the general file info for this InfoStorer.

    • getInfoList

      public InfoList getInfoList(int dim, int n)
      Description copied from interface: InfoStorer
      Returns an InfoList object applying to a particular dimension/element for this InfoStorer.
      Specified by:
      getInfoList in interface InfoStorer
      Parameters:
      dim - the dimension for which to get the information list.
      n - the element for which to get the information list.
      Returns:
      an InfoList object from a particular dimension of the InfoStorer.

    • getSliceInfoList

      public InfoList getSliceInfoList(int slice)
      Description copied from interface: InfoStorer
      Returns an InfoList object applying to a particular slice of this InfoStorer.

      The slice number is referenced from 0 to (number of slices - 1).

      Specified by:
      getSliceInfoList in interface InfoStorer
      Parameters:
      slice - the slice number.
      Returns:
      an InfoList object from a particular slice of this InfoStorer.

    • getFrameInfoList

      public InfoList getFrameInfoList(int frame)
      Description copied from interface: InfoStorer
      Returns an InfoList object applying to a particular frame of this InfoStorer.

      The frame number is referenced from 0 to (number of frames - 1).

      Specified by:
      getFrameInfoList in interface InfoStorer
      Parameters:
      frame - the frame number.
      Returns:
      an InfoList object from a particular frame of this InfoStorer.

    • setInfoList

      public void setInfoList(InfoList infoList, int dim, int n)
      Description copied from interface: InfoStorer
      Sets a new InfoList a specific dimension of this InfoStorer.
      Specified by:
      setInfoList in interface InfoStorer
      Parameters:
      infoList - the InfoList to associate with this InfoStorer/dimension.
      dim - the dimension to which to set the information list.
      n - the element to which to set the information list.

    • setSliceInfoList

      public void setSliceInfoList(InfoList infoList, int slice)
      Description copied from interface: InfoStorer
      Sets a new InfoList a specific slice of this InfoStorer.
      Specified by:
      setSliceInfoList in interface InfoStorer
      Parameters:
      infoList - the InfoList to associate with this InfoStorer/slice.
      slice - the slice for which to set the information list.

    • setFrameInfoList

      public void setFrameInfoList(InfoList infoList, int frame)
      Description copied from interface: InfoStorer
      Sets a new InfoList a specific frame of this InfoStorer.
      Specified by:
      setFrameInfoList in interface InfoStorer
      Parameters:
      infoList - the InfoList to associate with this InfoStorer/frame.
      frame - the frame for which to set the information list.

    • appendInfoList

      public void appendInfoList(InfoList infoList)
      Description copied from interface: InfoStorer
      Appends an InfoList to the existing general file info of this InfoStorer.
      Specified by:
      appendInfoList in interface InfoStorer
      Parameters:
      infoList - the InfoList object to append to the general file info for this InfoStorer.

    • appendInfoList

      public void appendInfoList(InfoList infoList, int dim, int n) throws InvalidImageException
      Appends an InfoList to that for a particular dimension of this image.
      Specified by:
      appendInfoList in interface InfoStorer
      Parameters:
      infoList - ths list to append.
      dim - the diemension for which the InfoList will be appended.
      n - the element of that dimension for which the InfoList will be appended.
      Throws:
      InvalidImageException - if the InfoList cannot be appended.

    • addExtendedData

      public void addExtendedData(ExtendedData extendedData) throws ANZException
      Adds a block of ExtendedData to this NIFTIImage.
      Parameters:
      extendedData - the ExtendedData to add.
      Throws:
      ANZException - if the ExtendedData cannot be added.

    • getExtendedData

      public List<ExtendedData> getExtendedData()
      Returns a List of ExtendedData for this NIFTIImage.
      Returns:
      a List of ExtendedData, or null if there is no ExtendedData.

    • removeExtendedData

      public void removeExtendedData(ExtendedData extendedData) throws ANZException
      Removes a block of ExtendedData from this NIFTIImage. This method does nothing if the supplied ExtendedData is not present.
      Parameters:
      extendedData - the ExtendedData to remove.
      Throws:
      ANZException - if the extended data cannot be removed.

    • stripExtension

      public static String stripExtension(String fileName)
      Strips any ".img", ".img.gz", ".hdr", ".hdr.gz", ".nii", or ".nii.gz" extension (in upper or lowe case) from a file name.
      Parameters:
      fileName - the file name that may or may not have an extension.
      Returns:
      the stripped file name.

    • getFlatSliceDescription

      public String getFlatSliceDescription(int index, boolean html)
      Description copied from interface: ReadableImage
      Returns a String description of a slice of this image in HTML format.
      Specified by:
      getFlatSliceDescription in interface ReadableImage
      Overrides:
      getFlatSliceDescription in class ANZImage
      Parameters:
      index - the flat slice number to describe. The flat slice number is (frame * nSlices) + slice.For single-frame images, the flat slice number is just the slice number.
      html - whether in HTML format.
      Returns:
      a String describing this image slice.

    • main

      public static void main(String[] args)
      Run the self-test for the NIFTIImage class.
      Parameters:
      args - a list of images to try to open.