dcmrecv - Online sa Cloud

PROGRAMA:

NAME

dcmrecv - Simpleng DICOM storage SCP (receiver)

SINOPSIS

dcmrecv [mga opsyon] port

DESCRIPTION

Ang dcmrecv ang application ay nagpapatupad ng Service Class Provider (SCP) para sa Storage Service
Klase. Taliwas sa kilalang-kilala tindahanscp kagamitan, dcmrecv may mas kaunting mga pagpipilian at maaaring,
samakatuwid, maging mas madaling gamitin - ipinapaliwanag din nito ang terminong 'simple' sa pamagat. Pangunahing
layunin ng application na ito ay makatanggap ng isang buong bungkos ng mga dataset ng DICOM mula sa isang Storage
Service Class User (SCU) at iimbak ang mga ito sa isang na-configure na direktoryo at istraktura ng file.

MGA PARAMETERS

port tcp/ip port number para makinig

Opsyon

pangkalahatan pagpipilian
-h --tulong
i-print ang text ng tulong na ito at lumabas

--bersyon
impormasyon ng bersyon ng pag-print at paglabas

--mga argumento
i-print ang pinalawak na mga argumento ng command line

-q --tahimik
quiet mode, walang mga babala at error sa pag-print

-v --verbose
verbose mode, mga detalye ng pagproseso ng pag-print

-d --debug
debug mode, i-print ang impormasyon ng debug

-ll --log-level [l]evel: string constant
(fatal, error, babala, impormasyon, debug, trace)
gumamit ng level l para sa logger

-lc --log-config [f]ilename: string
gumamit ng config file f para sa logger

+v --verbose-pc
ipakita ang mga konteksto ng presentasyon sa verbose mode

network pagpipilian
profile ng negosasyon ng asosasyon mula sa configuration file:

-xf --config-file [f]ilename, [p]rofile: string
gumamit ng profile p mula sa configuration file f

pamagat ng entity ng aplikasyon:

-aet --aetitle [a]etitle: string
itakda ang aking pamagat ng AE (default: DCMRECV)

-uca --use-called-aetitle
laging tumugon sa tinatawag na pamagat na AE

iba pang mga pagpipilian sa network:

-ta --acse-timeout [s]econds: integer (default: 30)
timeout para sa mga mensahe ng ACSE

-td --dimse-timeout [s]econds: integer (default: unlimited)
timeout para sa DIMSE na mga mensahe

-pdu --max-pdu [n]bilang ng mga byte: integer (4096..131072)
itakda ang max na makatanggap ng pdu sa n bytes (default: 16384)

-dhl --disable-host-lookup huwag paganahin ang hostname lookup

output pagpipilian
pangkalahatan:

-od --output-directory [d]directory: string (default: ".")
isulat ang mga natanggap na bagay sa umiiral na direktoryo d

pagbuo ng subdirectory:

-s --no-subdir
huwag bumuo ng anumang mga subdirectory (default)

+ssd --series-date-subdir
bumuo ng mga subdirectory mula sa petsa ng serye

henerasyon ng filename:

+fd --default-filenames
bumuo ng filename mula sa instance UID (default)

+fu --natatanging-filename
bumuo ng natatanging filename batay sa bagong UID

+fsu --maikling-natatanging-pangalan
bumuo ng maikling pseudo-random na natatanging filename

+fst --system-time-names
bumuo ng filename mula sa kasalukuyang oras ng system

-fe --filename-extension [e]extension: string (default: wala)
idagdag e sa lahat ng nabuong filename

storage mode:

-B --normal
payagan ang mga implicit na format na conversion (default)

+B --bit-pagpapanatili
isulat ang dataset nang eksakto tulad ng natanggap

--Huwag pansinin
huwag pansinin ang dataset, tanggapin ngunit huwag iimbak ito

NOTA

Kaugalian Paggamit
Isang karaniwang kaso ng paggamit ng dcmrecv ay upang makatanggap ng mga instance ng SOP na ipinadala mula sa isang storage SCU
at i-save ang mga ito bilang DICOM file. Ang sumusunod na utos ay eksaktong ginagawa ito:

dcmrecv --verbose --config-file storescp.cfg default

Kung mas gusto mo ang ilang awtomatikong nilikhang istraktura ng subdirectory, mas maiikling mga pangalan ng file at
ang extension na '.dcm' para sa lahat ng DICOM file, gamitin ang sumusunod na command:

dcmrecv -v -xf storescp.cfg default --series-date-subdir
--maikling-natatanging-pangalan
--filename-extension .dcm

Sa kaso ng napakalaking SOP instance o kung ang dataset ay dapat isulat nang eksakto tulad ng
natanggap (hal. para sa mga layunin ng pag-debug), ang 'bit preserving mode' ay maaaring gamitin:

dcmrecv -v -xf storescp.cfg default --bit-pagpapanatili

Ang mga natanggap na dataset ay palaging naka-imbak bilang DICOM file na may parehong Transfer Syntax bilang
ginagamit para sa paghahatid ng network.

DICOM Pagsang-ayon
Talaga, ang dcmrecv Sinusuportahan ng application ang lahat ng Mga Klase ng SOP ng Storage bilang isang SCP, kabilang ang
mga pribado. Nangangailangan ito, gayunpaman, na isang kaukulang profile ng negosasyon ng asosasyon
ay na-load mula sa isang configuration file. Ang format at semantics ng configuration file na ito
ay dokumentado sa asconfig.txt.

Bilang default, nangangahulugan iyon kung walang na-load na profile sa negosasyon ng asosasyon, dcmrecv lamang
ay sumusuporta sa Verification SOP Class bilang isang SCP (na may default na syntax ng paglilipat, ibig sabihin, Implicit
VR Litte Endian).

Sa hinaharap, maaaring may mga karagdagang opsyon na nagbibigay-daan sa pagtukoy sa listahan ng
sinusuportahang Mga Konteksto ng Presentasyon (ibig sabihin, kumbinasyon ng SOP Class at Transfer Syntaxes)
direkta, ibig sabihin, nang hindi naglo-load ng configuration file.

Subdirectory Henerasyon
Ang pagpipilian --series-date-subdir nagbibigay-daan para sa pagbuo ng mga subdirectory (sa ibaba ng tinukoy na
direktoryo ng output) batay sa halaga ng elemento ng data Serye Petsa (0008,0021) mula sa
nakatanggap ng DICOM dataset. Kung ang halagang ito ay maaaring makuha mula sa dataset at wasto
(ibig sabihin ay binubuo ng isang wastong field ng petsa ng DICOM), ang istraktura ng subdirectory ay ang mga sumusunod:

/data/ / / /

Kung ang Petsa ng Serye (0008,0021) ay hindi maaaring makuha o hindi wasto, ang kasalukuyang petsa ng system
ay ginagamit para sa sumusunod na istraktura ng subdirectory:

/undef/ /

Sa parehong mga kaso, binubuo ng 4 decimal digit at pati na rin ang ng 2
mga decimal na digit.

Filename Henerasyon
Bilang default, ang mga filename para sa pag-iimbak ng natanggap na mga dataset ng DICOM ay nabuo ayon
sa sumusunod na scheme:

.

Kung ang parehong halimbawa ng SOP ay natanggap nang dalawang beses, isang mensahe ng babala ang iuulat at ang umiiral na
na-overwrite ang file.

Ang pagpipilian --natatanging-filename tinitiyak na ang bawat natanggap na dataset ng DICOM ay nakaimbak bilang a
hiwalay na file, ibig sabihin, walang mga file ang dapat na ma-overwrite. Ginagawa ito sa pamamagitan ng paggamit ng bagong
lumikha ng natatanging identifier (UID) para sa bawat nabuong filename (at ang infix na '.X' sa pagkakasunud-sunod
upang maiwasan ang mga salungatan sa mga tunay na halaga ng SOP Instance UID). Ang scheme ng pagbibigay ng pangalan para sa opsyong ito
ay ang mga sumusunod:

.X.

Kapag option --maikling-natatanging-pangalan ay ginagamit, ang mga filename ay nabuo ng ilang pseudo-
random na pangalan generator, na tinitiyak din na walang mga salungatan (hal
hindi na-overwrite ang mga file). Ito ang scheme ng pagbibigay ng pangalan:

_

Sa na binubuo ng 16 na digit sa hexadecimal notation.

Sa wakas, pagpipilian --system-time-pangalan nagbibigay-daan para sa pagbuo ng mga filename batay sa kasalukuyang
oras ng system:

.

Sa na binubuo ng mga ' ' at ng
' . '. Pakitandaan na maaaring magresulta ang scheme na ito
pagbibigay ng pangalan sa mga salungatan kung ang paglutas ng oras ng system ay hindi sapat na mataas (ibig sabihin, ginagawa
hindi sumusuporta sa mga microsecond).

Mga hangganan
Pakitandaan ang opsyong iyon --bit-pagpapanatili hindi maaaring gamitin kasama ng opsyon --serye-
petsa-subdir dahil ang natanggap na dataset ay direktang iniimbak sa file at ang halaga ng
Ang Petsa ng Serye (0008,0021), samakatuwid, ay hindi magagamit bago magawa ang file.

PAGTOTROSO

Ang antas ng pag-log output ng iba't ibang command line tool at pinagbabatayan na mga aklatan ay maaaring
matukoy ng gumagamit. Bilang default, mga error at babala lamang ang isinulat sa pamantayan
stream ng error. Paggamit ng opsyon --verbose gayundin ang mga mensaheng nagbibigay-kaalaman tulad ng mga detalye ng pagproseso
ay iniulat. Pagpipilian --debug maaaring magamit upang makakuha ng higit pang mga detalye sa panloob na aktibidad,
hal para sa mga layunin ng pag-debug. Maaaring mapili ang iba pang antas ng pag-log gamit ang opsyon --log-
antas. Sa --tahimik mode na mga fatal error lang ang naiulat. Sa gayong napakatinding error na mga kaganapan,
karaniwang wawakasan ang aplikasyon. Para sa higit pang mga detalye sa iba't ibang antas ng pag-log,
tingnan ang dokumentasyon ng module na 'oflog'.

Kung sakaling ang output ng pag-log ay dapat isulat sa file (opsyonal na may pag-ikot ng logfile),
sa syslog (Unix) o sa event log (Windows) na opsyon --log-config maaaring gamitin. Ito
Ang configuration file ay nagbibigay-daan din sa pagdidirekta lamang ng ilang mga mensahe sa isang partikular na output
stream at para sa pag-filter ng ilang mga mensahe batay sa module o application kung saan sila
ay nabuo. Isang halimbawang configuration file ang ibinigay sa /logger.cfg.

COMMAND LINE

Ginagamit ng lahat ng tool sa command line ang sumusunod na notasyon para sa mga parameter: nakalakip ang mga square bracket
mga opsyonal na halaga (0-1), ang tatlong trailing na tuldok ay nagpapahiwatig na maraming mga halaga ang pinapayagan
(1-n), ang kumbinasyon ng pareho ay nangangahulugang 0 hanggang n mga halaga.

Ang mga opsyon sa command line ay nakikilala mula sa mga parameter sa pamamagitan ng isang nangungunang tanda na '+' o '-',
ayon sa pagkakabanggit. Karaniwan, ang pagkakasunud-sunod at posisyon ng mga pagpipilian sa command line ay arbitrary (ibig sabihin, sila
maaaring lumitaw kahit saan). Gayunpaman, kung ang mga pagpipilian ay kapwa eksklusibo ang pinakatamang hitsura
Ginagamit. Ang pag-uugali na ito ay umaayon sa karaniwang mga panuntunan sa pagsusuri ng mga karaniwang shell ng Unix.

Bilang karagdagan, ang isa o higit pang mga command file ay maaaring tukuyin gamit ang isang '@' sign bilang prefix sa
ang filename (hal @command.txt). Ang nasabing command argument ay pinapalitan ng nilalaman ng
ang kaukulang text file (maraming mga whitespace ay itinuturing bilang isang solong separator maliban kung
lumilitaw ang mga ito sa pagitan ng dalawang panipi) bago ang anumang karagdagang pagsusuri. Mangyaring tandaan na
ang isang command file ay hindi maaaring maglaman ng isa pang command file. Ang simple ngunit epektibong diskarte na ito
nagbibigay-daan sa isa na ibuod ang mga karaniwang kumbinasyon ng mga opsyon/parameter at iniiwasan ang longish at
nakalilitong mga linya ng utos (isang halimbawa ay ibinigay sa file /dumppat.txt).

EXIT MGA CODE

Ang dcmrecv Ginagamit ng utility ang mga sumusunod na exit code kapag tinatapos. Ito ay nagbibigay-daan sa gumagamit
upang suriin ang dahilan kung bakit winakasan ang aplikasyon.

pangkalahatan
EXITCODE_NO_ERROR 0
EXITCODE_COMMANDLINE_SYNTAX_ERROR 1

input file error
EXITCODE_CANNOT_READ_INPUT_FILE 20 (*)

output file error
EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40 (*)
EXITCODE_INVALID_OUTPUT_DIRECTORY 45

network error
EXITCODE_CANNOT_INITIALIZE_NETWORK 60 (*)
EXITCODE_CANNOT_START_SCP_AND_LISTEN 64
EXITCODE_INVALID_ASSOCIATION_CONFIG 66

(*) Sa totoo lang, ang mga code na ito ay kasalukuyang hindi ginagamit ng dcmrecv ngunit nagsisilbing placeholder para sa
ang kaukulang pangkat ng mga exit code.

Kapaligiran

Ang dcmrecv susubukan ng utility na i-load ang mga diksyunaryo ng data ng DICOM na tinukoy sa
DCMDICTPATH variable ng kapaligiran. Bilang default, ibig sabihin, kung ang DCMDICTPATH variable ng kapaligiran
ay hindi nakatakda, ang file /dicom.dic ilo-load maliban kung ang diksyunaryo ay binuo
sa application (default para sa Windows).

Ang default na gawi ay dapat na mas gusto at ang DCMDICTPATH variable ng kapaligiran lamang
ginagamit kapag ang mga alternatibong diksyunaryo ng data ay kinakailangan. Ang DCMDICTPATH variable ng kapaligiran
ay may parehong format tulad ng Unix shell PATH variable na ang isang colon (':') ay naghihiwalay
mga entry. Sa mga system ng Windows, ang isang semicolon (';') ay ginagamit bilang isang separator. Ang diksyunaryo ng data
susubukan ng code na i-load ang bawat file na tinukoy sa DCMDICTPATH variable ng kapaligiran. Ito
ay isang error kung walang ma-load na diksyunaryo ng data.

Gumamit ng dcmrecv online gamit ang mga serbisyo ng onworks.net