Lossy Compression Service
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.