dcmrecv — Online w chmurze

PROGRAM:

IMIĘ

dcmrecv — Prosta pamięć masowa DICOM SCP (odbiornik)

STRESZCZENIE

dcmrecv [opcje] port

OPIS

Kurs dcmrecv aplikacja implementuje Service Class Provider (SCP) dla usługi Storage
Klasa. W przeciwieństwie do znanego sklepycp użyteczność, dcmrecv ma mniej opcji i mocy,
w związku z tym być łatwiejszym w użyciu - to również wyjaśnia termin „prosty” w tytule. Główny
celem tej aplikacji jest otrzymanie całej gamy zestawów danych DICOM z magazynu
Użytkownik klasy usług (SCU) i zapisz je w konfigurowalnym katalogu i strukturze plików.

PARAMETRY

port Numer portu tcp/ip do nasłuchiwania

OPCJE

ogólny Opcje
-h --pomoc
wydrukuj ten tekst pomocy i wyjdź

--wersja
wydrukuj informacje o wersji i wyjdź

--argumenty
wypisz rozszerzone argumenty wiersza poleceń

-q --cichy
tryb cichy, drukuj bez ostrzeżeń i błędów

-v --pełne
tryb szczegółowy, szczegóły przetwarzania wydruku

-d --debuguj
tryb debugowania, drukuj informacje debugowania

-ll --log-level [poziom] poziom: ciąg znaków
(krytyczny, błąd, ostrzeżenie, informacje, debugowanie, śledzenie)
użyj poziomu l dla rejestratora

-lc --log-config [f]nazwa_pliku: ciąg
użyj pliku konfiguracyjnego f dla loggera

+ v --verbose-pc
pokaż konteksty prezentacji w trybie szczegółowym

sieć Opcje
profil negocjacji asocjacji z pliku konfiguracyjnego:

-xf --config-file [f] nazwa pliku, [p] profil: ciąg
użyj profilu p z pliku konfiguracyjnego f

tytuł jednostki aplikacji:

-aet --aetitle [a]etitle: napis
ustaw mój tytuł AE (domyślnie: DCMRECV)

-uca --użyj-zwanego-aetitle
zawsze odpowiadaj, podając tytuł AE

inne opcje sieciowe:

-ta --acse-timeout [s]sekundy: liczba całkowita (domyślnie: 30)
limit czasu dla wiadomości ACSE

-td --dimse-timeout [s]sekundy: liczba całkowita (domyślnie: nieograniczona)
limit czasu dla wiadomości DIMSE

-pdu --max-pdu [liczba] bajtów: liczba całkowita (4096..131072)
ustaw maksymalny odbiór pdu na n bajtów (domyślnie: 16384)

-dhl --disable-host-lookup wyłącza wyszukiwanie nazwy hosta

wydajność Opcje
generał:

-od --output-directory [d]rectory: ciąg (domyślnie: ".")
zapisz otrzymane obiekty do istniejącego katalogu d

generacja podkatalogu:

-s --no-podkatalog
nie generuj żadnych podkatalogów (domyślnie)

+ssd --podkatalog daty-serii
wygeneruj podkatalogi od daty serii

generowanie nazw plików:

+fd --default-nazwy plików
wygeneruj nazwę pliku z UID instancji (domyślnie)

+fu --unikalne nazwy plików
wygeneruj unikalną nazwę pliku w oparciu o nowy UID

+fsu --short-unique-names
wygeneruj krótką, pseudolosową, unikalną nazwę pliku

+fst --nazwy-czasu-systemowego
wygeneruj nazwę pliku na podstawie bieżącego czasu systemowego

-fe --rozszerzenie-pliku [e]xtension: ciąg znaków (domyślnie: brak)
dołącz e do wszystkich wygenerowanych nazw plików

tryb przechowywania:

-B --normalny
zezwalaj na niejawną konwersję formatu (domyślnie)

+B --zachowanie bitów
zapisz zestaw danych dokładnie tak, jak otrzymano

--ignorować
zignoruj ​​zbiór danych, odbierz go, ale nie przechowuj

UWAGI

Typowy Stosowanie
Typowy przypadek użycia dcmrecv polega na odbieraniu instancji SOP wysyłanych z jednostki SCU pamięci masowej
i zapisz je jako pliki DICOM. Poniższe polecenie robi dokładnie to:

dcmrecv – pełne informacje --plik-konfiguracyjny przechowuje domyślnie scp.cfg

Jeśli wolisz automatycznie utworzoną strukturę podkatalogów, krótsze nazwy plików i
rozszerzenie „.dcm” dla wszystkich plików DICOM, użyj następującego polecenia:

dcmrecv -v -xf przechowuje plik scp.cfg domyślnie --podkatalog daty-serii
--krótkie-unikalne-nazwy
--rozszerzenie nazwy pliku .dcm

W przypadku bardzo dużych instancji SOP lub jeśli zbiór danych powinien być zapisany dokładnie tak jak
otrzymany (np. do celów debugowania), można zastosować „tryb zachowania bitu”:

dcmrecv -v -xf przechowuje plik scp.cfg domyślnie --zachowując bity

Otrzymane zestawy danych są zawsze przechowywane jako pliki DICOM z tą samą składnią transferu co
wykorzystywane do transmisji sieciowej.

DICOM Zgodność
Zasadniczo dcmrecv aplikacja obsługuje wszystkie klasy SOP pamięci masowej jako SCP, w tym
prywatne. Wymaga to jednak odpowiedniego profilu negocjacyjnego stowarzyszenia
jest ładowany z pliku konfiguracyjnego. Format i semantyka tego pliku konfiguracyjnego
są udokumentowane w asconfig.txt.

Domyślnie oznacza to, że jeśli nie załadowano żadnego profilu negocjacji powiązania, dcmrecv tylko
obsługuje klasę SOP weryfikacji jako SCP (z domyślną składnią przesyłania, tj. Implicit
VR Litte Endian).

W przyszłości mogą pojawić się dodatkowe opcje umożliwiające określenie listy
obsługiwane konteksty prezentacji (tj. połączenie składni klasy SOP i transferu)
bezpośrednio, tj. bez ładowania pliku konfiguracyjnego.

Podkatalog Pożądania
Opcja --podkatalog daty-serii pozwala na generowanie podkatalogów (poniżej podanego
katalog wyjściowy) w oparciu o wartość elementu danych Series Date (0008,0021) z pliku
otrzymano zbiór danych DICOM. Jeśli tę wartość można pobrać ze zbioru danych i jest ona prawidłowa
(tzn. składa się z prawidłowego pola daty DICOM), struktura podkatalogów jest następująca:

/dane/ / / /

Jeśli nie można pobrać daty serii (0008,0021) lub jest ona nieprawidłowa, bieżąca data systemowa
jest używany w następującej strukturze podkatalogów:

/undef/ /

W obu przypadkach, składa się z 4 cyfr dziesiętnych i jak również z 2
cyfry dziesiętne.

Nazwa pliku Pożądania
Domyślnie generowane są nazwy plików do przechowywania otrzymanych zbiorów danych DICOM
do następującego schematu:

.

Jeśli ta sama instancja SOP zostanie odebrana dwukrotnie, zostanie zgłoszony komunikat ostrzegawczy i istniejący
plik zostanie nadpisany.

Opcja --unikalne-nazwy plików upewnia się, że każdy otrzymany zestaw danych DICOM jest przechowywany jako plik
oddzielny plik, tzn. żadne pliki nie powinny być nigdy nadpisywane. Odbywa się to za pomocą nowo
utworzono unikalny identyfikator (UID) dla każdej wygenerowanej nazwy pliku (oraz końcówkę „.X” w kolejności
aby uniknąć konfliktów z rzeczywistymi wartościami UID instancji SOP). Schemat nazewnictwa tej opcji
jest następujący:

.X.

Kiedy opcja --krótkie-unikalne-nazwy jest używany, nazwy plików są generowane przez pseudo-
generator losowych nazw, który również pilnuje, aby nie było konfliktów (tzn. istniejących
pliki nie są nadpisywane). Oto schemat nazewnictwa:

_

Z składający się z 16 cyfr w zapisie szesnastkowym.

Wreszcie opcja --nazwy-czasu-systemowego pozwala na generowanie nazw plików na podstawie bieżących
czas systemu:

.

Z składający się z ' ' I z
' . '. Należy pamiętać, że ten schemat może skutkować
konflikty nazewnictwa, jeśli rozdzielczość czasu systemowego nie jest wystarczająco wysoka (tzn
nie obsługują mikrosekund).

Ograniczenia
Proszę zwrócić uwagę na tę opcję --zachowując bity nie można używać razem z opcją --seria-
podkatalog daty ponieważ odebrany zestaw danych jest przechowywany bezpośrednio w pliku, a wartość
Dlatego data serii (0008,0021) nie jest dostępna przed utworzeniem pliku.

LOGOWANIE

Poziom rejestrowania danych wyjściowych różnych narzędzi wiersza poleceń i podstawowych bibliotek może:
być określony przez użytkownika. Domyślnie w standardzie zapisywane są tylko błędy i ostrzeżenia
strumień błędów. Korzystanie z opcji --gadatliwy także komunikaty informacyjne, takie jak szczegóły przetwarzania
Jest zgłoszony. Opcja --odpluskwić można wykorzystać, aby uzyskać więcej szczegółów na temat działalności wewnętrznej,
np. do celów debugowania. Inne poziomy rejestrowania można wybrać za pomocą opcji --Dziennik-
poziom, w --cichy w trybie zgłaszane są tylko błędy krytyczne. W tak bardzo poważnych błędach,
aplikacja zwykle kończy się. Aby uzyskać więcej informacji na temat różnych poziomów rejestrowania,
patrz dokumentacja modułu 'oflog'.

W przypadku, gdy dane wyjściowe logowania powinny być zapisywane do pliku (opcjonalnie z rotacją logów),
do syslog (Unix) lub opcji dziennika zdarzeń (Windows) --log-config może być użyty. Ten
plik konfiguracyjny pozwala również na kierowanie tylko niektórych komunikatów na określone wyjście
strumienia i do filtrowania niektórych wiadomości na podstawie modułu lub aplikacji, w której są
Są generowane. Przykładowy plik konfiguracyjny znajduje się w /logger.cfg.

COMMAND LINE

Wszystkie narzędzia wiersza poleceń używają następującej notacji dla parametrów: nawiasy kwadratowe otocz
wartości opcjonalne (0-1), trzy końcowe kropki oznaczają, że dozwolone są różne wartości
(1-n), kombinacja obu oznacza od 0 do n wartości.

Opcje wiersza poleceń są odróżniane od parametrów przez wiodący znak '+' lub '-',
odpowiednio. Zazwyczaj kolejność i pozycja opcji wiersza poleceń są dowolne (tzn
może pojawić się w dowolnym miejscu). Jeśli jednak opcje wzajemnie się wykluczają, najbardziej odpowiedni wygląd
jest używany. To zachowanie jest zgodne ze standardowymi regułami oceny powszechnych powłok uniksowych.

Ponadto jeden lub więcej plików poleceń można określić za pomocą znaku „@” jako przedrostka do
nazwa pliku (np. @komenda.txt). Taki argument polecenia jest zastępowany treścią
odpowiedni plik tekstowy (wiele białych znaków jest traktowanych jako pojedynczy separator, chyba że
pojawiają się między dwoma cudzysłowami) przed dalszą oceną. Proszę to zanotować
plik poleceń nie może zawierać innego pliku poleceń. To proste, ale skuteczne podejście
pozwala podsumować typowe kombinacje opcji/parametrów i uniknąć długich i
mylące wiersze poleceń (przykład znajduje się w pliku) /dumppat.txt).

EXIT KODY

Kurs dcmrecv Narzędzie używa następujących kodów wyjścia podczas kończenia. Umożliwia to użytkownikowi
aby sprawdzić przyczynę zamknięcia aplikacji.

ogólny
EXITCODE_NO_ERROR 0
EXITCODE_COMMANDLINE_SYNTAX_ERROR 1

wkład filet błędy
EXITCODE_CANNOT_READ_INPUT_FILE 20 (*)

wydajność filet błędy
EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40 (*)
EXITCODE_INVALID_OUTPUT_DIRECTORY 45

sieć błędy
EXITCODE_CANNOT_INITIALIZE_NETWORK 60 (*)
EXITCODE_CANNOT_START_SCP_AND_LISTEN 64
EXITCODE_INVALID_ASSOCIATION_CONFIG 66

(*) W rzeczywistości kody te nie są obecnie używane przez dcmrecv ale służyć jako symbol zastępczy
odpowiednią grupę kodów wyjścia.

ŚRODOWISKO

Kurs dcmrecv narzędzie spróbuje załadować słowniki danych DICOM określone w
ŚCIEŻKA DDMDICT Zmienna środowiskowa. Domyślnie, tj. jeśli ŚCIEŻKA DDMDICT zmienna środowiskowa
nie jest ustawiony, plik /dicom.dic zostanie załadowany, chyba że słownik zostanie zbudowany
do aplikacji (domyślnie dla Windows).

Preferowane jest zachowanie domyślne, a ŚCIEŻKA DDMDICT tylko zmienna środowiskowa
używane, gdy wymagane są alternatywne słowniki danych. ten ŚCIEŻKA DDMDICT zmienna środowiskowa
ma taki sam format jak powłoka uniksowa PATH zmienna, w której oddziela się dwukropek (':')
wpisy. W systemach Windows średnik (';') jest używany jako separator. Słownik danych
kod spróbuje załadować każdy plik określony w ŚCIEŻKA DDMDICT Zmienna środowiskowa. Ono
jest błędem, jeśli nie można załadować słownika danych.

Użyj dcmrecv online, korzystając z usług onworks.net