dcmdspfn: exporter les courbes d'affichage standard vers un fichier texte

SYNOPSIS

dcmdspfn [options]

DESCRIPTION

Ce programme en ligne de commande convertit un fichier de caractéristiques DCMTK de moniteur / caméra / imprimante / scanner en un fichier texte délimité par des tabulations décrivant la courbe caractéristique (CC), la fonction d'affichage et la courbe post-standardisée (PSC) pour un affichage 8 bits. Les 256 valeurs de chaque courbe peuvent être visualisées avec un tableur courant. En outre, la courbe d'affichage (sans CC ni PSC) peut également être calculée pour une plage de luminance/OD spécifiée (min/max) et un certain nombre de Digital Driving Levels (DDL).

PARAMÈTRES

dcmfile-in  DICOM input filename to be dumped

OPTIONS

options générales

-h --help: affiche cette aide et quitte
--version: affiche les informations de version et quitte
--arguments: affiche les arguments de ligne de commande développés
-q --quiet: mode silencieux, n'affiche ni avertissements ni erreurs
-v --verbose: mode détaillé, affiche les détails du traitement
-d --debug: mode débogage, affiche les informations de débogage
-ll --log-level [l]evel: string constant: (fatal, error, warn, info, debug, trace) utilise le niveau l pour la journalisation
-lc --log-config [f]ilename: string: utilise le fichier de configuration f pour la journalisation

options d'entrée (mutuellement exclusives)

+Im --monitor-file [f]ilename: string: fichier texte décrivant les caractéristiques du moniteur
+Ic --camera-file [f]ilename: string: fichier texte décrivant les caractéristiques de la caméra
+Ip --printer-file [f]ilename: string: fichier texte décrivant les caractéristiques de l'imprimante
+Is --scanner-file [f]ilename: string: fichier texte décrivant les caractéristiques du scanner
+Il --lum-range [m]in max: float: luminance minimale et maximale (cd/m^2)
+Io --od-range [m]in max: float: densité optique (OD) minimale et maximale, convertie automatiquement en luminance

options de création

+Ca --ambient-light [a]mbient light: float: valeur de lumière ambiante (cd/m^2, par défaut : fichier f)
+Ci --illumination [i]llumination: float: valeur d'illumination (cd/m^2, par défaut : fichier f)
+Dn --min-density [m]inimum optical density: float: valeur Dmin (par défaut : off, uniquement avec +Ip et +Io)
+Dx --max-density [m]aximum optical density: float: valeur Dmax (par défaut : off, uniquement avec +Ip et +Io)
+Cd --ddl-count [n]umber of DDLs: integer: nombre de Digital Driving Levels (par défaut : 256, uniquement avec --lum/od-range)
+Cf --curve-fitting [n]umber: integer: utilise un algorithme d'ajustement de courbe polynomial d'ordre n (0..99, par défaut : réglage du fichier ou spline cubique)

options de sortie

+Og --gsdf [f]ilename: string: écrit les données de courbe GSDF dans le fichier f
+Oc --cielab [f]ilename: string: écrit les données de courbe CIELAB dans le fichier f

NOTES

Le fichier de sortie décrivant la CC, le GSDF ou le CIELAB, ainsi que la PSC, pour un système d'affichage 8 bits (moniteur, caméra, imprimante ou scanner) est un simple fichier texte. Les lignes commençant par un '#' sont considérées comme des commentaires et donc ignorées, tout comme les lignes vides. Un fichier d'entrée peut par exemple être créé avec l'outil en ligne de commande dconvlum.

La valeur de lumière ambiante éventuellement définie dans le fichier de caractéristiques est elle aussi utilisée pour le calcul. Dans ce cas, elle figure dans l'en-tête de commentaires du fichier, de même que le nombre de valeurs DDL (Digital Driving Level), la plage de luminance absolue (mesurée en candela par mètre carré) et, dans le cas du GSDF, la plage de l'indice JND (just noticeable difference, plus petite différence perceptible). La valeur de lumière ambiante peut également être indiquée au moyen d'une option de ligne de commande. Lorsque les deux valeurs de luminance sont définies au lieu de lire un fichier de caractéristiques de moniteur en entrée, la plage de luminance est divisée linéairement par le nombre de DDL.

Pour les imprimantes et les scanners, l'illumination peut être précisée en complément de la lumière ambiante réfléchie (aussi bien dans le fichier de caractéristiques que sur la ligne de commande). L'en-tête du fichier de sortie contient alors la densité optique (OD) minimale et maximale à la place de la plage de luminance. Notez que les valeurs d'OD du fichier d'entrée doivent être classées par ordre décroissant (contrairement aux valeurs de luminance utilisées pour les moniteurs et les caméras). La valeur DDL 0 désigne toujours le noir (la valeur la plus sombre) et la valeur DDL maximale désigne le blanc (la valeur la plus claire, film transparent).

Le répertoire data contient des exemples de fichiers de caractéristiques pour les moniteurs, les caméras, les imprimantes et les scanners. Consultez la partie 14 de la norme DICOM pour plus de détails sur l'étalonnage d'affichage et le modèle de Barten (y compris le GSDF).

JOURNALISATION

Le niveau de détail de la journalisation des différents outils en ligne de commande et des bibliothèques sous-jacentes peut être spécifié par l'utilisateur. Par défaut, seules les erreurs et les avertissements sont écrits dans le flux d'erreur standard. L'option –verbose permet également de signaler des messages d'information tels que les détails du traitement. L'option –debug permet d'obtenir plus de détails sur l'activité interne, par exemple à des fins de débogage. L'option –log-level permet de sélectionner d'autres niveaux de journalisation. En mode –quiet, seules les erreurs fatales sont signalées. Dans de tels cas d'erreur très graves, l'application se termine généralement. Pour plus de détails sur les différents niveaux de journalisation, consultez la documentation du module "oflog".

Si la sortie de la journalisation doit être écrite dans un fichier (éventuellement avec rotation des fichiers journaux), vers syslog (Unix) ou le journal des événements (Windows), l'option –log-config peut être utilisée. Ce fichier de configuration permet également de diriger uniquement certains messages vers un flux de sortie particulier et de filtrer certains messages en fonction du module ou de l'application qui les génère. Un exemple de fichier de configuration est fourni dans < etcdir>/logger.cfg.

LIGNE DE COMMANDE

Tous les outils en ligne de commande utilisent la notation suivante pour les paramètres : les crochets entourent les valeurs facultatives (0-1), trois points de suspension à la fin indiquent que plusieurs valeurs sont autorisées (1-n), et la combinaison des deux signifie de 0 à n valeurs.

Les options de la ligne de commande se distinguent des paramètres par un signe '+' ou '-' en tête. En général, l'ordre et la position des options de la ligne de commande sont arbitraires (c'est-à-dire qu'elles peuvent apparaître n'importe où). Toutefois, si des options s'excluent mutuellement, c'est la dernière occurrence, la plus à droite, qui est utilisée. Ce comportement est conforme aux règles d'évaluation standard des shells Unix courants.

De plus, un ou plusieurs fichiers de commandes peuvent être spécifiés en utilisant un signe '@' comme préfixe du nom de fichier (par exemple @command.txt). Un tel argument de commande est remplacé par le contenu du fichier texte correspondant (les espaces multiples sont traités comme un séparateur unique, sauf s'ils apparaissent entre deux guillemets) avant toute évaluation ultérieure. Notez qu'un fichier de commandes ne peut pas contenir un autre fichier de commandes. Cette approche simple mais efficace permet de regrouper des combinaisons courantes d'options/paramètres et évite des lignes de commande longues et peu lisibles (un exemple est fourni dans le fichier < datadir>/dumppat.txt).

FICHIERS

< datadir>/camera.lut - exemple de fichier de caractéristiques d'une caméra
< datadir>/monitor.lut - exemple de fichier de caractéristiques d'un moniteur
< datadir>/printer.lut - exemple de fichier de caractéristiques d'une imprimante
< datadir>/scanner.lut - exemple de fichier de caractéristiques d'un scanner

VOIR AUSSI

dconvlum(1), dcod2lum(1)