# doc-cache created by Octave 11.1.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





