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.