# doc-cache created by Octave 12.0.0
# name: cache
# type: cell
# rows: 3
# columns: 3
# name: <cell-element>
# type: sq_string
# elements: 1
# length: 15
dicomCollection


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 1272
 -- COLLECTION = dicomCollection(DIRECTORY)
 -- COLLECTION = dicomCollection(DICOMDIR)
 -- COLLECTION = dicomCollection(_, PROPERTYNAME, PROPERTYVALUE ...)
     Read a directory or DICOMDIR file and return a table or struct of the
     referenced files.

     Inputs
     ......

     DIRECTORY - directory to read.

     DICOMDIR - dicom DICOMDIR file to read.

     PROPERTYNAME, PROPERTYVALUE - Optional property name/value pairs.

     Known properties:

     IncludeSubFolders
          Boolean if set to true will also look in sub-folders when looking for
          dicom files
     DisplayWaitbar
          Boolean currently ignored in Octave

     Outputs
     .......

     COLLECTION - a table with fields Location and Value for each matched
     attribute.

     collection will be a struct array or a table if a struct2table function
     exists, with fields of:

     Filenames
     StudyDateTime
     SeriesDateTime
     PatientName
     PatientSex
     Modality
     Rows
     Columns
     Channels
     Frames
     StudyDescription
     SeriesDescription
     StudyInstanceUID
     SeriesInstanceUID

     Examples
     ........

          [dirname, ~] = fileparts(file_in_loadpath("imdata/rtstruct.dcm"));

          collection = dicomCollection(dirname);


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 80
Read a directory or DICOMDIR file and return a table or struct of the referen...



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 9
dicomfind


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 692
 -- ATTRINFO = dicomfind(FILENAME, ATTRIBUTE)
 -- ATTRINFO = dicomfind(INFO, ATTRIBUTE)
     Find the location and value of an attribute in a dicom file or info
     structure.

     Inputs
     ......

     FILENAME - filename to open.

     INFO - dicominfo struct.

     ATTRIBUTE - attribute name to find.

     Outputs
     .......

     ATTRINFO - a table with fields Location and Value for each matched
     attribute.

     The Location value will be the attribute position in dot notation to show
     its position in dicom info structure.

     Examples
     ........

          filename = file_in_loadpath("imdata/rtstruct.dcm");

          info = dicomfind(filename, "ROINumber");


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 78
Find the location and value of an attribute in a dicom file or info structure.



# name: <cell-element>
# type: sq_string
# elements: 1
# length: 11
dicomupdate


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 820
 -- INFO = dicomupdate(FILEINFO, ATTRIBUTE, VALUE)
 -- INFO = dicomupdate(INFO, ATTRINFO)
     Update a dicom struct with new values

     Inputs
     ......

     INFO - dicominfo struct.

     ATTRIBUTE - attribute name to find and change value of.

     VALUE - attribute value to set.

     ATTRINFO - a table with fields Location and Value for each matched
     attribute to change.

     Outputs
     .......

     INFO - dicominfo struct.

     Examples
     ........

          filename = file_in_loadpath("imdata/rtstruct.dcm");
          info = dicominfo(filename);

          % update specific values
          finfo = dicomfind(info, "ROINumber");
          finfo.Value{1} = 10;
          info = dicomupdate(info, finfo);

          % update all matching
          info = dicomupdate(info, "ROINumber", 100);


# name: <cell-element>
# type: sq_string
# elements: 1
# length: 37
Update a dicom struct with new values





