dcmsend - Online nel cloud

PROGRAMMA:

NOME

dcmsend - SCU di archiviazione DICOM semplice (mittente)

SINOSSI

dcmsend [opzioni] porta peer dcmfile-in...

DESCRIZIONE

. dcmsend l'applicazione implementa un Service Class User (SCU) per il servizio di archiviazione
Classe. In contrasto con il noto storescu utilità, dcmsend ha meno opzioni ed è,
quindi, più facile da usare - questo spiega anche il termine "semplice" nel titolo. Il principale
lo scopo di questa applicazione è inviare un intero gruppo di file DICOM a un servizio di archiviazione
Fornitore di classe (SCP). dcmsend supporta entrambe le associazioni multiple (una dopo l'altra)
e la decompressione delle istanze DICOM SOP se necessario per trasferirle.

PARAMETRI

nome host peer del peer DICOM

porta tcp/ip numero di porta del peer

dcmfile-in File DICOM o directory da trasmettere

VERSIONI

generale Opzioni
-h --aiuto
stampa questo testo di aiuto ed esci

--versione
stampa le informazioni sulla versione ed esci

--list-decoder
elenca le sintassi di trasferimento dei decodificatori ed esci

--argomenti
stampa gli argomenti della riga di comando espansi

-q --silenzioso
modalità silenziosa, non stampa avvisi ed errori

-v --verboso
modalità dettagliata, stampa dei dettagli di elaborazione

-d --debug
modalità di debug, stampa informazioni di debug

-ll --log-level [l]evel: costante di stringa
(fatale, errore, avviso, informazioni, debug, traccia)
usa il livello l per il logger

-lc --log-config [f]nomeile: stringa
usa il file di configurazione f per il logger

+v --verbose-pc
mostra i contesti di presentazione in modalità dettagliata

ingresso Opzioni
formato del file di input:

+f --file di lettura
leggi il formato del file o il set di dati

+fo --sola-lettura-file
leggi solo il formato file (predefinito)

-f --leggi-dataset
leggere il set di dati senza meta informazioni sul file

file di input:

+rd --read-from-dicomdir
leggere le informazioni sui file di input da DICOMDIR

+sd --scansione-directory
scansiona le directory per i file di input (dcmfile-in)

+sp --scan-pattern [p]attern: stringa (solo con --scan-directory)
modello per la corrispondenza dei nomi dei file (caratteri jolly)

# forse non disponibile su tutti i sistemi

-r --nessuna ricorrenza
non ricorrere all'interno delle directory (impostazione predefinita)

+r --ricorrenza
ricorsivo all'interno di directory specificate

lavorazione Opzioni
conversione della sintassi di trasferimento:

-dn --decomprimi-mai
non decomprimere mai set di dati compressi

+dls --decompress-senza perdita
decomprimi solo compressione senza perdita di dati (impostazione predefinita)

+dly --decompress-lossy
decomprimere sia la compressione lossy che quella lossless

sgonfia livello di compressione:

+cl --compression-level [l]evel: intero (default: 6)
0=non compresso, 1=più veloce, 9=migliore compressione

altre opzioni di elaborazione:

-nh --no-alt
non fermarti al primo file di input non valido
o se si incontra un negozio non riuscito

-nip --no-proposta-illegale
non proporre alcun contesto di presentazione che lo faccia
non contengono la sintassi di trasferimento predefinita (se necessario)

-nuc --no-uid-controlli
non controllare i valori UID dei file di input

network Opzioni
titoli delle entità dell'applicazione:

-aet --aetitle [a]etitle: stringa
imposta il mio titolo AE chiamante (predefinito: DCMSEND)

-aec --call [a]etitle: stringa
set chiamato titolo AE del peer (predefinito: ANY-SCP)

gestione dell'associazione:

+ma --multi-associazioni
utilizzare più associazioni (una dopo l'altra)
se necessario per trasferire le istanze (impostazione predefinita)

-ma --associazione-singola
usa sempre una singola associazione

altre opzioni di rete:

-to --timeout [s]secondi: intero (predefinito: illimitato)
timeout per le richieste di connessione

-ta --acse-timeout [s]secondi: intero (predefinito: 30)
timeout per i messaggi ACSE

-td --dimse-timeout [s]econds: intero (default: illimitato)
timeout per i messaggi DIMSE

-pdu --max-pdu [n]numero di byte: intero (4096..131072)
imposta max ricezione pdu su n byte (predefinito: 16384)

--max-send-pdu [n]numero di byte: intero (4096..131072)
limita max send pdu a n byte

produzione Opzioni
generale:

+crf --create-report-file [f]nomeile: stringa
creare un rapporto dettagliato sul trasferimento
(se riuscito) e scrivilo nel file di testo f

NOTE

Tipico Impiego
Un tipico caso d'uso di dcmsend consiste nell'inviare istanze SOP arbitrarie memorizzate come DICOM
file su un SCP di archiviazione. Il seguente comando fa esattamente questo:

dcmsend --verbose *.dcm

Se i file DICOM sono archiviati in una gerarchia di directory sotto la directory "IMMAGINI",
è possibile utilizzare il seguente comando:

dcmsend -v --scansione-directory --immagini ricorsive

È anche possibile specificare più directory e combinare le suddette
approcci (utilizzando sia i nomi di file che di directory):

dcmsend -v +sd +r IMMAGINI_1 IMMAGINI_2 test.img *.dcm

Se si fa riferimento alle istanze SOP da un file DICOMDIR, opzione --read-from-dicomdir (o
+rd) può essere utilizzato per inviare tutti i file DICOM referenziati senza caricarli già per il
negoziazione associativa:

dcmsend -v --read-from-dicomdir DICOMDIR

E ancora, tutti gli approcci di cui sopra possono essere combinati in questo modo:

dcmsend -v +sd +r +rd IMMAGINI_1 IMMAGINI_2 test.img DICOMDIR *.dcm

L'opzione predefinita --sola-lettura assicura che solo i file DICOM (cioè quelli con
la meta-intestazione e la parola magica 'DICM' dopo il preambolo) vengono elaborati. Di solito, se
elaborare un sacco di file, è anche una buona idea non fermarsi al primo invalido
file di input o se è stato rilevato un archivio non riuscito. Questo può essere ottenuto utilizzando
opzione --no-alt. Si prega di notare, tuttavia, che "negozio non riuscito" non significa che il
Lo stato DIMSE della risposta C-STORE indica un errore. Significa che la richiesta C-STORE
non può essere inviato all'SCP di archiviazione.

Se sono necessari più di 128 contesti di presentazione, che è il numero massimo consentito
secondo lo standard DICOM, viene avviata una nuova associazione dopo che la precedente ha
stato completato. Nei casi in cui questo comportamento è indesiderato, può essere disabilitato utilizzando l'opzione
--associazione-singola. Inoltre, se solo i set di dati compressi senza perdita di dati sono
decompressi (se necessario), che è l'impostazione predefinita, o anche set di dati compressi con perdita di dati possono essere
specificato utilizzando il --decomprimi-xxx opzioni.

Per ottenere sia una panoramica che informazioni dettagliate sul trasferimento del DICOM SOP
istanze, opzione --crea-file-report può essere utilizzato per creare un file di testo corrispondente.
Tuttavia, questo file viene creato solo come passaggio finale se l'applicazione non è stata terminata
prima (con un errore).

Scansione Directory
L'aggiunta di directory come parametro alla riga di comando ha senso solo se option --scansione-
directory è anche dato. Se i file nelle directory fornite devono essere selezionati
secondo un modello di nome specifico (ad esempio utilizzando la corrispondenza con caratteri jolly), opzione --modello-scansione
deve essere utilizzato. Si prega di notare che questo modello di file si applica solo ai file all'interno del
directory scansionate e, se sono specificati altri modelli sulla riga di comando all'esterno
, il --modello-scansione opzione (ad es. per selezionare ulteriori file), questi non si applicano a
le directory specificate.

Pertanto, il terzo degli esempi precedenti ricorrerà sulle directory IMAGES_1 e IMAGES_2
e trasmettere i file che sono contenuti in queste due cartelle e tutte le loro sottocartelle (due
all'opzione +r). Inoltre, dcmsend trasferirà 'test.img' e tutti i file con estensione
'dcm' dalla cartella di lavoro corrente. Nota che fornire nomi di directory senza
opzione di abilitazione +SD non ha senso.

DICOM conformità
Fondamentalmente, la dcmsend l'applicazione supporta tutte le classi SOP di archiviazione come SCU, incluso
quelli privati. Per impostazione predefinita, l'applicazione controlla l'UID di classe SOP del file DICOM in
per assicurarsi che vengano inviate solo istanze SOP valide. Con opzione --no-uid-controlli
questo controllo può essere disabilitato.

. dcmsend l'applicazione supporta anche tutte le sintassi di trasferimento definite nel DICOM
standard. Le sintassi di trasferimento privato possono essere utilizzate solo se il controllo UID è disabilitato con
opzione --no-uid-controlli. Si prega di notare, tuttavia, che solo un numero limitato di trasferimenti
sono supportate le sintassi per convertirle nella sintassi di trasferimento predefinita (Implicit VR
Piccolo Endiano). Con opzione --list-decoder le sintassi di trasferimento supportate in modo nativo o da
sono elencati i decodificatori. L'output in genere ha il seguente aspetto:

Sintassi di trasferimento supportate in modo nativo:
- Little Endian Implicito
- Little Endian esplicito
- Big Endian esplicito

Sintassi di trasferimento supportate dai decoder:
- Little Endian VR esplicito sgonfiato
- Linea di base JPEG
- JPEG esteso, elaborazione 2+4
- Selezione spettrale JPEG, non gerarchico, processo 6+8
- Progressione completa JPEG, non gerarchico, processo 10+12
- JPEG Lossless, Non gerarchico, Processo 14
- JPEG Lossless, Non gerarchico, Previsione del primo ordine
- JPEG-LS senza perdita
- JPEG-LS con perdita (quasi senza perdita)
- RLE senza perdite

Dal dcmsend cerca di essere il più semplice possibile per l'utente, come presentazione predefinita
potrebbero essere proposti al SCP contesti che sono in senso stretto 'illegali'. Questo è
perché, secondo lo standard DICOM, la SCU deve sempre proporre il default
trasferire la sintassi in almeno un contesto di presentazione associato a ciascuna sintassi astratta
(cioè classe SOP). Questo requisito è derogato quando la SCU ha accesso solo alla SOP
esempio in forma compressa con perdita di dati. Con opzione --no-illegale-proposta il rigoroso DICOM-
comportamento conforme può essere imposto, cioè non sarà possibile alcun contesto di presentazione illegale
proposto, ma l'istanza SOP corrispondente verrà rifiutata (se necessario).

Si noti, tuttavia, che la sintassi di trasferimento predefinita per 'Compressione JPEG senza perdita',
'Lossy JPEG Compression' e così via non sono sempre proposti come richiesto anche dal DICOM
standard. La stessa limitazione si applica ad altri schemi di compressione. Vedere DICOM PS 3.5
sezione 10 per i dettagli.

REGISTRAZIONE

Il livello di registrazione dell'output dei vari strumenti della riga di comando e delle librerie sottostanti può
essere specificato dall'utente. Per impostazione predefinita, nello standard vengono scritti solo gli errori e gli avvisi
flusso di errore. Usando l'opzione --verboso anche messaggi informativi come i dettagli di elaborazione
sono segnalati. Opzione - debug può essere utilizzato per ottenere maggiori dettagli sull'attività interna,
ad esempio per scopi di debug. Altri livelli di registrazione possono essere selezionati utilizzando l'opzione --tronco d'albero-
livello. in --silenzioso vengono segnalati solo errori fatali. In tali eventi di errore molto gravi,
l'applicazione di solito termina. Per maggiori dettagli sui diversi livelli di registrazione,
vedere la documentazione del modulo 'oflog'.

Nel caso in cui l'output di registrazione debba essere scritto su file (facoltativamente con la rotazione del file di registro),
a syslog (Unix) o all'opzione registro eventi (Windows) --log-config può essere utilizzato. Questo
il file di configurazione consente anche di indirizzare solo determinati messaggi a un particolare output
stream e per filtrare determinati messaggi in base al modulo o all'applicazione in cui si trovano
sono generati. Un file di configurazione di esempio è fornito in /logger.cfg.

COMANDO LINE

Tutti gli strumenti della riga di comando utilizzano la seguente notazione per i parametri: parentesi quadre racchiudono
valori facoltativi (0-1), tre punti finali indicano che sono consentiti più valori
(1-n), una combinazione di entrambi significa valori da 0 a n.

Le opzioni della riga di comando si distinguono dai parametri da un segno '+' o '-' iniziale,
rispettivamente. Di solito, l'ordine e la posizione delle opzioni della riga di comando sono arbitrari (cioè
può apparire ovunque). Tuttavia, se le opzioni si escludono a vicenda, l'aspetto più a destra
viene utilizzato. Questo comportamento è conforme alle regole di valutazione standard delle comuni shell Unix.

Inoltre, è possibile specificare uno o più file di comando utilizzando un segno '@' come prefisso per
il nome del file (es @comando.txt). Tale argomento di comando è sostituito dal contenuto di
il file di testo corrispondente (più spazi bianchi sono trattati come un singolo separatore a meno che
compaiono tra due virgolette) prima di ogni ulteriore valutazione. Si prega di notare che
un file di comandi non può contenere un altro file di comandi. Questo approccio semplice ma efficace
permette di riassumere combinazioni comuni di opzioni/parametri ed evita lunghe e
righe di comando confuse (un esempio è fornito in file /dumppat.txt).

EXIT CODICI

. dcmsend l'utilità utilizza i seguenti codici di uscita al momento della chiusura. Ciò consente all'utente
per verificare il motivo per cui l'applicazione è terminata.

generale
EXITCODE_NO_ERROR 0
EXITCODE_COMMANDLINE_SYNTAX_ERROR 1

ingresso filetto errori
EXITCODE_CANNOT_READ_INPUT_FILE 20 (*)
EXITCODE_NO_INPUT_FILES 21
EXITCODE_INVALID_INPUT_FILE 22
EXITCODE_NO_VALID_INPUT_FILES 23

produzione filetto errori
EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40 (*)
EXITCODE_CANNOT_WRITE_REPORT_FILE 43

network errori
EXITCODE_CANNOT_INITIALIZE_NETWORK 60
EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION 61
EXITCODE_CANNOT_SEND_REQUEST 62
EXITCODE_CANNOT_ADD_PRESENTATION_CONTEXT 65

(*) In realtà, questi codici non sono attualmente utilizzati da dcmsend ma servono come segnaposto per
il corrispondente gruppo di codici di uscita.

AMBIENTE

. dcmsend l'utility tenterà di caricare i dizionari di dati DICOM specificati nel
DCMDICPATH variabile d'ambiente. Per impostazione predefinita, cioè se il DCMDICPATH variabile d'ambiente
non è impostato, il file /dicom.dic verrà caricato a meno che non venga creato il dizionario
nell'applicazione (impostazione predefinita per Windows).

Il comportamento predefinito dovrebbe essere preferito e il DCMDICPATH solo variabile d'ambiente
utilizzato quando sono richiesti dizionari di dati alternativi. Il DCMDICPATH variabile d'ambiente
ha lo stesso formato della shell Unix PERCORSO variabile in quanto i due punti (':') separa
inserimenti. Sui sistemi Windows, viene utilizzato un punto e virgola (';') come separatore. Il dizionario dei dati
il codice tenterà di caricare ogni file specificato nel DCMDICPATH variabile d'ambiente. Esso
è un errore se non è possibile caricare alcun dizionario dati.

Utilizzare dcmsend online utilizzando i servizi onworks.net