Description
Lossy Compression Service. The Lossy Compression Service supports delayed, JPEG Lossy compression of received images.
Attributes
Name
The class name of the MBean
State
The status of the MBean
StateString
The status of the MBean in text form
SourceFileSystemGroupID
Group ID of file systems which are scanned for image files to compress in configured TaskInterval.
Default Value: ONLINE_STORAGE
DestinationFileSystemGroupID
Group ID of writable file systems to which lossy compressed images are stored.
Default Value: LOSSY_STORAGE
TaskInterval
Interval in which the database is checked for image files located on file systems of the configured SourceFileSystemGroupID to compress.
Format: interval[!from-to] or NEVER
interval = poll interval in seconds (##s), minutes (##m) or hours (##h).
from = start hour (0-23) when no compression should be performed
to = end hour (0-23) when no compression should be performed
NEVER = disable automatic compression
Example: 10s!9-17
means every 10 seconds, poll the database and check for images to compress, except between the hours of 9:00am and 5:00pm.
By setting this type of TaskInterval, you can ensure compression of images happens outside of peak imaging hours.
Default Value: NEVER
isRunning
Current state if compression task is running. Used to avoid concurrency!
LimitNumberOfFilesPerTask
Maximum number of files that are compressed in one task.
Default Value: 1000
CompressionRules
Specifies compression rules for particular SOP Class, Body Part Examined, Source AE Title.
Format: sop-class-name-or-uid:body-part:source-aet:delay:quality:description:ratio:near
with
sop-class-name-or-uid = the UID of the SOP class, or a string name defined in the dictionary.xml file under uids type="SOPClass"
body-part = Body Part Examined or '*'
source-aet = Source AE Title
delay = compression delay in minutes (##m), hours (##h) or days (##d)
quality = compression quality between 0 (= lowest image quality / highest compression ratio) and 1.0 (= highest quality / lowest compression ratio)
description = description stored in attribute Derivation Description (0008,2111) of compressed DICOM image
ratio = estimated compression ratio stored in attribute Lossy Image Compression Ratio (0028,2112) of compressed DICOM image
near = maximal absolute derivation of pixel sample values by lossy compression+decompression. -1 = disables validation of compressed images
Default Value:
ComputedRadiographyImageStorage:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
DigitalXRayImageStorageForPresentation:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
DigitalXRayImageStorageForProcessing:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
DigitalMammographyXRayImageStorageForPresentation:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
DigitalMammographyXRayImageStorageForProcessing:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
CTImageStorage:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
MRImageStorage:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
UltrasoundImageStorage:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
UltrasoundMultiframeImageStorage:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
UltrasoundImageStorageRetired:*:MOD_AET:5d:0.75:5.0:64
UltrasoundMultiframeImageStorageRetired:*:MOD_AET:5d:0.75:5.0:64
SecondaryCaptureImageStorage:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
XRayAngiographicImageStorage:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
XRayRadiofluoroscopicImageStorage:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
NuclearMedicineImageStorage:*:MOD_AET:5d:0.75:JPEG Lossy Compression with quality=0.75:5.0:64
ExternalRetrieveAETitle
Constrains lossy compression to objects which are external retrievable from specified Application Entity.
'-' = no such constrain..
Default Value: -
CopyOnOtherFileSystemGroupID
Constrains lossy compression to objects for which there is a copy available on a file system of the specified file system group. Only effective if ExternalRetrieveAETitle = '-'.
'-' = no such constrain.
Default Value: -
SourceAETitle
Source AE Title used by operation compressSeriesJPEGLossy for new created Series.
Default Value: DCM4CHEE
SeriesDescription
Series Description used by operation compressSeriesJPEGLossy for new created Series. '{}' will be replaced by Series Description of uncompressed objects.
Default Value: JPEG Lossy compressed {}
BufferSize
Size of write byte buffer.
Default Value: 8192
TempDirectory
Directory to spool decompressed already lossless compressed files for its lossy compression. Relative path names are resolved relative to $DCM4CHEE_HOME/server/default/.
Default Value: tmp
StoreScpServiceName
Used internally. Do NOT modify.
SchedulerServiceName
Used internally. Do NOT modify.
FileSystemMgtServiceNamePrefix
Used internally. Do NOT modify.
TimerIDCheckFilesToCompress
Used internally. Do NOT modify.
Operations
create
Standard MBean lifecycle method
start
The start lifecycle operation
stop
The stop lifecycle operation
destroy
The destroy lifecycle operation
jbossInternalLifecycle
The detyped lifecycle operation (for internal use only)
compressFileJPEGLossy
Compress specified file JPEG Lossy with specified quality. Prompts Compression Ratio, measured on file length and on bits per pixel.
compressSeriesJPEGLossy
Compress specified Series located on file systems of the configured SourceFileSystemGroupID JPEG Lossy with specified quality. Prompts number of compressed images and minimum/average/maximum Compression Ratio, measured on file length and on bits per pixel. If decompress = True, also prompts minimum/average/maximum of maximal absolute derivation of pixel sample values in decompressed images.
checkForFilesToCompress
Checked for image files located on file systems of the configured SourceFileSystemGroupID to compress according the configured CompressionRules.