dcmsend — online w chmurze

PROGRAM:

IMIĘ

dcmsend — prosta jednostka SCU pamięci DICOM (nadawca)

STRESZCZENIE

dcmsend [opcje] port równorzędny dcmfile-in...

OPIS

Kurs dcmsend aplikacja implementuje Service Class User (SCU) dla Usługi Pamięci Masowej
Klasa. W przeciwieństwie do znanego sklepycu użyteczność, dcmsend ma mniej opcji i jest
w związku z tym łatwiejszy w użyciu - to również wyjaśnia termin „prosty” w tytule. Główny
celem tej aplikacji jest wysłanie całej masy plików DICOM do usługi pamięci masowej
Dostawca klasy (SCP). dcmsend obsługuje zarówno wielokrotne powiązania (jedno po drugim)
i dekompresję instancji DICOM SOP, jeśli jest to konieczne do ich przeniesienia.

PARAMETRY

peer nazwa hosta DICOM peer

port tcp/ip numer portu peera

dcmfile-w pliku lub katalogu DICOM do przesłania

OPCJE

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

--wersja
wydrukuj informacje o wersji i wyjdź

--list-dekodery
lista składni transferu dekoderów i wyjście

--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

wkład Opcje
format pliku wejściowego:

+f --odczytaj-plik
odczytać format pliku lub zestaw danych

+fo --tylko-do-odczytu-pliku
tylko odczyt formatu pliku (domyślnie)

-f --odczytaj-zbiór danych
odczytaj zestaw danych bez informacji meta pliku

pliki wejściowe:

+rd --czytaj z-dicomdir
odczytywać informacje o plikach wejściowych z DICOMDIR

+sd --skanuj katalogi
skanowanie katalogów w poszukiwaniu plików wejściowych (dcmfile-in)

+sp --scan-pattern [p]attern: string (tylko z --scan-directories)
wzorzec dopasowywania nazw plików (symbole wieloznaczne)

# prawdopodobnie nie jest dostępny we wszystkich systemach

-r --bez rekurencji
nie powtarzaj się w katalogach (domyślnie)

+r --rekurencja
rekurencyjnie w określonych katalogach

przetwarzanie Opcje
konwersja składni transferu:

-dn --dekompresuj-nigdy
nigdy nie dekompresuj skompresowanych zestawów danych

+dls --decompress-bezstratny
dekompresuj tylko kompresję bezstratną (domyślnie)

+dly --dekompresja-stratna
dekompresować zarówno kompresję stratną, jak i bezstratną

poziom kompresji powietrza:

+cl --poziom kompresji [poziom]: liczba całkowita (domyślnie: 6)
0=bez kompresji, 1=najszybszy, 9=najlepsza kompresja

inne opcje przetwarzania:

-nh --bez-zatrzymania
nie zatrzymuj się na pierwszym nieprawidłowym pliku wejściowym
lub w przypadku napotkania nieudanego sklepu

-nip --no-nielegalna-propozycja
nie proponuj żadnego kontekstu prezentacji, który to robi
nie zawierają domyślnej składni przesyłania (w razie potrzeby)

-nuc --no-uid-checks
nie sprawdzaj wartości UID plików wejściowych

sieć Opcje
tytuły podmiotu wniosku:

-aet --aetitle [a]etitle: napis
ustaw tytuł mojego wywołania AE (domyślnie: DCMSEND)

-aec --call [a]tytuł: ciąg
zestaw o nazwie AE tytuł peera (domyślnie: ANY-SCP)

obsługa asocjacji:

+ma --wiele skojarzeń
używaj wielu skojarzeń (jedno po drugim)
w razie potrzeby przeniesienia instancji (domyślnie)

-ma --pojedyncze skojarzenie
zawsze używaj jednego skojarzenia

inne opcje sieciowe:

-to --timeout [s]sekundy: liczba całkowita (domyślnie: nieograniczona)
limit czasu dla żądań połączenia

-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)

--max-send-pdu [n] liczba bajtów: liczba całkowita (4096..131072)
ogranicz max wysyłania pdu do n bajtów

wydajność Opcje
generał:

+crf --create-report-file [f] nazwa_pliku: łańcuch
stworzyć szczegółowy raport z przelewu
(jeśli się powiedzie) i zapisz go do pliku tekstowego f

UWAGI

Typowy Stosowanie
Typowy przypadek użycia dcmsend jest wysyłanie dowolnych instancji SOP, które są przechowywane jako DICOM
pliki do magazynu SCP. Poniższe polecenie robi dokładnie to:

dcmsend --pełne *.dcm

Jeśli pliki DICOM są przechowywane w hierarchii katalogów poniżej katalogu „IMAGES”,
można użyć następującego polecenia:

dcmsend -v --scan-directories --recurse OBRAZY

Możliwe jest również określenie wielu katalogów i połączenie powyższych
podejścia (używając zarówno nazw plików, jak i katalogów):

dcmsend -v +sd +r IMAGES_1 IMAGES_2 test.img *.dcm

Jeśli odwołania do instancji SOP pochodzą z pliku DICOMDIR, option --czytaj z-dicomdir (lub
+rd) można użyć do wysłania wszystkich plików DICOM, do których się odwołuje, bez ładowania ich już dla
negocjacje stowarzyszeniowe:

dcmsend -v --read-from-dicomdir DICOMDIR

I znowu wszystkie powyższe podejścia można łączyć w następujący sposób:

dcmsend -v +sd +r +rd IMAGES_1 IMAGES_2 test.img DICOMDIR *.dcm

Opcja domyślna --tylko do odczytu pliku upewnia się, że tylko pliki DICOM (tzn. te z
meta-nagłówek i magiczne słowo „DICM” po preambule) są przetwarzane. Zwykle, jeśli
przetwarzając całą masę plików, warto też nie zatrzymywać się na pierwszym błędnym
plik wejściowy lub napotkano nieudany zapis. Można to osiągnąć za pomocą
opcja --bez-zatrzymania. Należy jednak pamiętać, że „nieudany sklep” nie oznacza, że
Stan DIMSE odpowiedzi C-STORE wskazuje na błąd. Oznacza to, że żądanie C-STORE
nie mógł zostać wysłany do magazynu SCP.

Jeśli potrzebnych jest więcej niż 128 kontekstów prezentacji, to jest to maksymalna dozwolona liczba
zgodnie ze standardem DICOM nowe skojarzenie jest uruchamiane po wykonaniu poprzedniego
zostało zakończone. W przypadkach, gdy takie zachowanie jest niepożądane, można je wyłączyć za pomocą opcji
--pojedyncze skojarzenie. Ponadto, czy są tylko bezstratne skompresowane zestawy danych
zdekompresowane (w razie potrzeby), co jest ustawieniem domyślnym, lub też skompresowane zestawy danych mogą być stratne
określone za pomocą --dekompresuj-xxx opcje.

Aby uzyskać zarówno przegląd, jak i szczegółowe informacje na temat transferu DICOM SOP
instancje, opcja --utwórz-plik-raportu można użyć do utworzenia odpowiedniego pliku tekstowego.
Jednak ten plik jest tworzony tylko jako ostatni krok, jeśli aplikacja nie została zakończona
wcześniej (z błędem).

Skanowanie Katalogi
Dodawanie katalogów jako parametru do wiersza poleceń ma sens tylko wtedy, gdy option --skanowanie-
katalogi jest również podane. Jeśli pliki w podanych katalogach powinny zostać wybrane
według określonego wzorca nazwy (np. za pomocą dopasowywania symboli wieloznacznych), option --skan-wzorzec
musi być używany. Należy pamiętać, że ten wzorzec pliku dotyczy tylko plików w formacie
przeskanowane katalogi oraz, jeśli w wierszu poleceń określono inne wzorce na zewnątrz
dotychczasowy --skan-wzorzec opcji (np. w celu wybrania kolejnych plików), nie dotyczą one
określone katalogi.

Zatem trzeci z powyższych przykładów będzie powtarzał się w katalogach IMAGES_1 i IMAGES_2
i przesyłaj pliki, które są zawarte w tych dwóch folderach i wszystkich ich podfolderach (due
do opcji +r). Do tego, dcmsend prześle „test.img” i wszystkie pliki z rozszerzeniem
„dcm” z bieżącego folderu roboczego. Należy pamiętać, że podanie nazw katalogów bez
włączenie opcji +sd nie ma sensu.

DICOM Zgodność
Zasadniczo dcmsend aplikacja obsługuje wszystkie klasy SOP pamięci masowej jako SCU, w tym
prywatne. Domyślnie aplikacja sprawdza SOP Class UID pliku DICOM w
aby upewnić się, że wysyłane są tylko prawidłowe instancje SOP. Z opcją --no-uid-checks
to sprawdzenie można wyłączyć.

Kurs dcmsend aplikacja obsługuje również wszystkie składnie transferu, które są zdefiniowane w DICOM
standard. Składnie transferu prywatnego mogą być używane tylko wtedy, gdy kontrola UID jest wyłączona za pomocą
opcja --no-uid-checks. Należy jednak pamiętać, że tylko ograniczona liczba przelewów
składnie są obsługiwane w celu ich konwersji na domyślną składnię transferu (Implicit VR
mały endian). Z opcją --list-dekodery składnie transferu obsługiwane natywnie lub przez
dekodery są wymienione. Dane wyjściowe zazwyczaj wyglądają następująco:

Składnie transferu obsługiwane natywnie:
- Niejawny Little Endian
- Wyraźne Little Endian
- Wyraźne Big Endian

Składnie przesyłania obsługiwane przez dekodery:
- Opróżniono jawną wersję VR Little Endian
-Linia bazowa JPEG
- JPEG rozszerzony, proces 2+4
- Selekcja spektralna JPEG, niehierarchiczna, proces 6+8
- Pełna progresja JPEG, niehierarchiczna, proces 10+12
- JPEG bezstratny, niehierarchiczny, proces 14
- JPEG bezstratny, niehierarchiczny, predykcja pierwszego rzędu
- JPEG-LS bezstratny
- JPEG-LS Lossy (prawie bezstratny)
- RLE bezstratny

Ponieważ dcmsend stara się być jak najprostsza dla użytkownika, domyślnie prezentacja
konteksty mogą zostać zaproponowane SCP, które są ściśle mówiąc „nielegalne”. To jest
ponieważ zgodnie ze standardem DICOM SCU zawsze musi zaproponować ustawienie domyślne
przenieść składnię w co najmniej jednym kontekście prezentacji powiązanym z każdą składnią abstrakcyjną
(tj. klasa SOP). Wymóg ten jest uchylony, gdy SCU ma dostęp tylko do SOP
na przykład w skompresowanej formie stratnej. Z opcją --no-nielegalna-propozycja ścisły DICOM-
można wymusić zgodne zachowanie, tj. nie będzie żadnego potencjalnie nielegalnego kontekstu prezentacji
zaproponowano, ale odpowiednia instancja SOP zostanie odrzucona (w razie potrzeby).

Należy jednak pamiętać, że domyślna składnia przesyłania dla „bezstratnej kompresji JPEG”,
„Stratna kompresja JPEG” i tak dalej nie zawsze są proponowane, jak również wymaga tego DICOM
standard. To samo ograniczenie dotyczy innych schematów kompresji. Zobacz DICOM PS 3.5
szczegóły w sekcji 10.

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 dcmsend 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 (*)
EXITCODE_NO_INPUT_FILES 21
EXITCODE_INVALID_INPUT_FILE 22
EXITCODE_NO_VALID_INPUT_FILES 23

wydajność filet błędy
EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40 (*)
EXITCODE_CANNOT_WRITE_REPORT_FILE 43

sieć błędy
EXITCODE_CANNOT_INITIALIZE_NETWORK 60
EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION 61
EXITCODE_CANNOT_SEND_REQUEST 62
EXITCODE_CANNOT_ADD_PRESENTATION_CONTEXT 65

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

ŚRODOWISKO

Kurs dcmsend 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.

Korzystaj z usługi dcmsend online za pomocą usług onworks.net