Image Action Set

Provides actions for image processing

loadImages Action

Loads images.

image.loadImages <result=results> <status=rc> /
addColumns={"CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH"} | {extendedAddColumnsParms},
caslib="string",
required parameter casOut
={
caslib="string",
compress=TRUE | FALSE,
indexVars={"variable-name-1" <, "variable-name-2", ...>},
label="string",
lifetime=64-bit-integer,
maxMemSize=64-bit-integer,
memoryFormat="DVR" | "INHERIT" | "STANDARD",
name="table-name",
onDemand=TRUE | FALSE,
promote=TRUE | FALSE,
replace=TRUE | FALSE,
replication=integer,
threadBlockSize=64-bit-integer,
timeStamp="string",
where={"string-1" <, "string-2", ...>}
},
decode=TRUE | FALSE,
distribution={type="RANDOM" | "ROUNDROBIN", type-specific-parameters},
labelLevels=integer,
path="string",
pathIsList=TRUE | FALSE,
quiet=TRUE | FALSE,
recurse=TRUE | FALSE,
repeat=TRUE | FALSE,
series
={
dicom=TRUE | FALSE,
reverse=TRUE | FALSE
}
;
indicates a required parameter

Summary: Output Tables

If a row includes a subparameter, you can specify the name, caslib, and so on in the subparameter. Otherwise, you can specify the name, caslib, and so on in the parameter.

Parameters for Creating Output Tables

Parameter

Subparameter

Description

required parametercasOut

—

specifies the settings for an output table.

Parameter Descriptions

addColumns={"CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH"} | {extendedAddColumnsParms}

specifies extra columns to add to the output table.

The extendedAddColumnsParms value can be one or more of the following:

dicomAttributes={dicomAttributesParms}

specifies parameters related to DICOM attributes.

The dicomAttributesParms value can be one or more of the following:

keywords={"string-1" <, "string-2", ...>}

specifies DICOM keywords.

RequirementThe specified values must be unique.
tags={"string-1" <, "string-2", ...>}

specifies DICOM tags.

RequirementThe specified values must be unique.
general={"CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH"}

specifies general columns applicable across image formats.

Range1–9 values
Default{''}
RequirementThe specified values must be unique.

caslib="string"

specifies the name of the caslib to load images from.

* casOut={casouttable}

specifies the settings for an output table.

For more information about specifying the casOut parameter, see the common casouttable parameter (Appendix A: Common Parameters).

AliasesoutputImages
outputImage

decode=TRUE | FALSE

when set to True, writes decoded images and metadata to the output table.

Aliasdecompress
DefaultFALSE

distribution={type="RANDOM" | "ROUNDROBIN", type-specific-parameters}

specifies the algorithm and parameters to be used to distribute loaded data to worker nodes.

The value that you specify for the type parameter determines the other parameters that apply.

DefaultROUNDROBIN

labelLevels=integer

specifies the maximum number of directory levels to include in the label.

Default0

path="string"

specifies the file or directory path to load images from.

pathIsList=TRUE | FALSE

when set to True, the path parameter specifies a list of paths to image files.

DefaultFALSE

quiet=TRUE | FALSE

when set to True, suppresses notes and warnings for successful operations.

Aliassilent
DefaultFALSE

recurse=TRUE | FALSE

when set to True, loads images in subdirectories recursively.

DefaultFALSE

repeat=TRUE | FALSE

when set to True, duplicates identical table rows on all worker nodes.

Aliasduplicate
DefaultFALSE

series={loadSeriesParms}

specifies the parameters to be used to load directory trees as image series.

The loadSeriesParms value can be one or more of the following:

dicom=TRUE | FALSE

when set to True, loads directory trees as DICOM series.

DefaultFALSE
reverse=TRUE | FALSE

when set to True, reverses the order of the image series.

DefaultFALSE

Parameters for type="RANDOM"

seed=integer

specifies the seed for the pseudorandom number generator.

DefaultTKZ_NEW_SEED

Parameters for type="ROUNDROBIN"

No parameters apply when you specify ROUNDROBIN.

loadImages Action

Loads images.

results, info = s:image_loadImages{
addColumns={"CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH"} | {extendedAddColumnsParms},
caslib="string",
required parameter casOut
={
caslib="string",
compress=true | false,
indexVars={"variable-name-1" <, "variable-name-2", ...>},
label="string",
lifetime=64-bit-integer,
maxMemSize=64-bit-integer,
memoryFormat="DVR" | "INHERIT" | "STANDARD",
name="table-name",
onDemand=true | false,
promote=true | false,
replace=true | false,
replication=integer,
threadBlockSize=64-bit-integer,
timeStamp="string",
where={"string-1" <, "string-2", ...>}
},
decode=true | false,
distribution={type="RANDOM" | "ROUNDROBIN", type-specific-parameters},
labelLevels=integer,
path="string",
pathIsList=true | false,
quiet=true | false,
recurse=true | false,
repeat=true | false,
series
={
dicom=true | false,
reverse=true | false
}
}
indicates a required parameter

Summary: Output Tables

If a row includes a subparameter, you can specify the name, caslib, and so on in the subparameter. Otherwise, you can specify the name, caslib, and so on in the parameter.

Parameters for Creating Output Tables

Parameter

Subparameter

Description

required parametercasOut

—

specifies the settings for an output table.

Parameter Descriptions

addColumns={"CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH"} | {extendedAddColumnsParms}

specifies extra columns to add to the output table.

The extendedAddColumnsParms value can be one or more of the following:

dicomAttributes={dicomAttributesParms}

specifies parameters related to DICOM attributes.

The dicomAttributesParms value can be one or more of the following:

keywords={"string-1" <, "string-2", ...>}

specifies DICOM keywords.

RequirementThe specified values must be unique.
tags={"string-1" <, "string-2", ...>}

specifies DICOM tags.

RequirementThe specified values must be unique.
general={"CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH"}

specifies general columns applicable across image formats.

Range1–9 values
Default{''}
RequirementThe specified values must be unique.

caslib="string"

specifies the name of the caslib to load images from.

* casOut={casouttable}

specifies the settings for an output table.

For more information about specifying the casOut parameter, see the common casouttable parameter (Appendix A: Common Parameters).

AliasesoutputImages
outputImage

decode=true | false

when set to True, writes decoded images and metadata to the output table.

Aliasdecompress
Defaultfalse

distribution={type="RANDOM" | "ROUNDROBIN", type-specific-parameters}

specifies the algorithm and parameters to be used to distribute loaded data to worker nodes.

The value that you specify for the type parameter determines the other parameters that apply.

DefaultROUNDROBIN

labelLevels=integer

specifies the maximum number of directory levels to include in the label.

Default0

path="string"

specifies the file or directory path to load images from.

pathIsList=true | false

when set to True, the path parameter specifies a list of paths to image files.

Defaultfalse

quiet=true | false

when set to True, suppresses notes and warnings for successful operations.

Aliassilent
Defaultfalse

recurse=true | false

when set to True, loads images in subdirectories recursively.

Defaultfalse

repeat=true | false

when set to True, duplicates identical table rows on all worker nodes.

Aliasduplicate
Defaultfalse

series={loadSeriesParms}

specifies the parameters to be used to load directory trees as image series.

The loadSeriesParms value can be one or more of the following:

dicom=true | false

when set to True, loads directory trees as DICOM series.

Defaultfalse
reverse=true | false

when set to True, reverses the order of the image series.

Defaultfalse

Parameters for type="RANDOM"

seed=integer

specifies the seed for the pseudorandom number generator.

DefaultTKZ_NEW_SEED

Parameters for type="ROUNDROBIN"

No parameters apply when you specify ROUNDROBIN.

loadImages Action

Loads images.

results=s.image.loadImages(
addColumns=["CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH"] | {extendedAddColumnsParms},
caslib="string",
required parameter casOut
={
"caslib":"string",
"compress":True | False,
"indexVars":["variable-name-1" <, "variable-name-2", ...>],
"label":"string",
"lifetime":64-bit-integer,
"maxMemSize":64-bit-integer,
"memoryFormat":"DVR" | "INHERIT" | "STANDARD",
"name":"table-name",
"onDemand":True | False,
"promote":True | False,
"replace":True | False,
"replication":integer,
"threadBlockSize":64-bit-integer,
"timeStamp":"string",
"where":["string-1" <, "string-2", ...>]
},
decode=True | False,
distribution={"type":"RANDOM" | "ROUNDROBIN", type-specific-parameters},
labelLevels=integer,
path="string",
pathIsList=True | False,
quiet=True | False,
recurse=True | False,
repeat=True | False,
series
={
"dicom":True | False,
"reverse":True | False
}
)
indicates a required parameter

Summary: Output Tables

If a row includes a subparameter, you can specify the name, caslib, and so on in the subparameter. Otherwise, you can specify the name, caslib, and so on in the parameter.

Parameters for Creating Output Tables

Parameter

Subparameter

Description

required parametercasOut

—

specifies the settings for an output table.

Parameter Descriptions

addColumns=["CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH"] | {extendedAddColumnsParms}

specifies extra columns to add to the output table.

The extendedAddColumnsParms value can be one or more of the following:

"dicomAttributes":{dicomAttributesParms}

specifies parameters related to DICOM attributes.

The dicomAttributesParms value can be one or more of the following:

"keywords":["string-1" <, "string-2", ...>]

specifies DICOM keywords.

RequirementThe specified values must be unique.
"tags":["string-1" <, "string-2", ...>]

specifies DICOM tags.

RequirementThe specified values must be unique.
"general":["CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH"]

specifies general columns applicable across image formats.

Range1–9 values
Default{''}
RequirementThe specified values must be unique.

caslib="string"

specifies the name of the caslib to load images from.

* casOut={casouttable}

specifies the settings for an output table.

For more information about specifying the casOut parameter, see the common casouttable parameter (Appendix A: Common Parameters).

AliasesoutputImages
outputImage

decode=True | False

when set to True, writes decoded images and metadata to the output table.

Aliasdecompress
DefaultFalse

distribution={"type":"RANDOM" | "ROUNDROBIN", type-specific-parameters}

specifies the algorithm and parameters to be used to distribute loaded data to worker nodes.

The value that you specify for the type parameter determines the other parameters that apply.

DefaultROUNDROBIN

labelLevels=integer

specifies the maximum number of directory levels to include in the label.

Default0

path="string"

specifies the file or directory path to load images from.

pathIsList=True | False

when set to True, the path parameter specifies a list of paths to image files.

DefaultFalse

quiet=True | False

when set to True, suppresses notes and warnings for successful operations.

Aliassilent
DefaultFalse

recurse=True | False

when set to True, loads images in subdirectories recursively.

DefaultFalse

repeat=True | False

when set to True, duplicates identical table rows on all worker nodes.

Aliasduplicate
DefaultFalse

series={loadSeriesParms}

specifies the parameters to be used to load directory trees as image series.

The loadSeriesParms value can be one or more of the following:

"dicom":True | False

when set to True, loads directory trees as DICOM series.

DefaultFalse
"reverse":True | False

when set to True, reverses the order of the image series.

DefaultFalse

Parameters for type="RANDOM"

"seed":integer

specifies the seed for the pseudorandom number generator.

DefaultTKZ_NEW_SEED

Parameters for type="ROUNDROBIN"

No parameters apply when you specify ROUNDROBIN.

loadImages Action

Loads images.

results <– cas.image.loadImages(s,
addColumns=list("CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH") | list(extendedAddColumnsParms),
caslib="string",
required parameter casOut
=list(
caslib="string",
compress=TRUE | FALSE,
indexVars=list("variable-name-1" <, "variable-name-2", ...>),
label="string",
lifetime=64-bit-integer,
maxMemSize=64-bit-integer,
memoryFormat="DVR" | "INHERIT" | "STANDARD",
name="table-name",
onDemand=TRUE | FALSE,
promote=TRUE | FALSE,
replace=TRUE | FALSE,
replication=integer,
threadBlockSize=64-bit-integer,
timeStamp="string",
where=list("string-1" <, "string-2", ...>)
),
decode=TRUE | FALSE,
distribution=list(type="RANDOM" | "ROUNDROBIN", type-specific-parameters),
labelLevels=integer,
path="string",
pathIsList=TRUE | FALSE,
quiet=TRUE | FALSE,
recurse=TRUE | FALSE,
repeat=TRUE | FALSE,
series
=list(
dicom=TRUE | FALSE,
reverse=TRUE | FALSE
)
)
indicates a required parameter

Summary: Output Tables

If a row includes a subparameter, you can specify the name, caslib, and so on in the subparameter. Otherwise, you can specify the name, caslib, and so on in the parameter.

Parameters for Creating Output Tables

Parameter

Subparameter

Description

required parametercasOut

—

specifies the settings for an output table.

Parameter Descriptions

addColumns=list("CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH") | {extendedAddColumnsParms}

specifies extra columns to add to the output table.

The extendedAddColumnsParms value can be one or more of the following:

dicomAttributes=list(dicomAttributesParms)

specifies parameters related to DICOM attributes.

The dicomAttributesParms value can be one or more of the following:

keywords=list("string-1" <, "string-2", ...>)

specifies DICOM keywords.

RequirementThe specified values must be unique.
tags=list("string-1" <, "string-2", ...>)

specifies DICOM tags.

RequirementThe specified values must be unique.
general=list("CHANNELCOUNT", "CHANNELTYPE", "DEPTH", "HEIGHT", "ORIENTATION", "POSITION", "SPACING", "SPAN", "WIDTH")

specifies general columns applicable across image formats.

Range1–9 values
Default{''}
RequirementThe specified values must be unique.

caslib="string"

specifies the name of the caslib to load images from.

* casOut=list(casouttable)

specifies the settings for an output table.

For more information about specifying the casOut parameter, see the common casouttable parameter (Appendix A: Common Parameters).

AliasesoutputImages
outputImage

decode=TRUE | FALSE

when set to True, writes decoded images and metadata to the output table.

Aliasdecompress
DefaultFALSE

distribution=list(type="RANDOM" | "ROUNDROBIN", type-specific-parameters)

specifies the algorithm and parameters to be used to distribute loaded data to worker nodes.

The value that you specify for the type parameter determines the other parameters that apply.

DefaultROUNDROBIN

labelLevels=integer

specifies the maximum number of directory levels to include in the label.

Default0

path="string"

specifies the file or directory path to load images from.

pathIsList=TRUE | FALSE

when set to True, the path parameter specifies a list of paths to image files.

DefaultFALSE

quiet=TRUE | FALSE

when set to True, suppresses notes and warnings for successful operations.

Aliassilent
DefaultFALSE

recurse=TRUE | FALSE

when set to True, loads images in subdirectories recursively.

DefaultFALSE

repeat=TRUE | FALSE

when set to True, duplicates identical table rows on all worker nodes.

Aliasduplicate
DefaultFALSE

series=list(loadSeriesParms)

specifies the parameters to be used to load directory trees as image series.

The loadSeriesParms value can be one or more of the following:

dicom=TRUE | FALSE

when set to True, loads directory trees as DICOM series.

DefaultFALSE
reverse=TRUE | FALSE

when set to True, reverses the order of the image series.

DefaultFALSE

Parameters for type="RANDOM"

seed=integer

specifies the seed for the pseudorandom number generator.

DefaultTKZ_NEW_SEED

Parameters for type="ROUNDROBIN"

No parameters apply when you specify ROUNDROBIN.

Last updated: February 09, 2023