dcmrecv - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

dcmrecv - Lưu trữ DICOM đơn giản SCP (bộ thu)

SYNOPSIS

cổng dcmrecv [tùy chọn]

MÔ TẢ

Sản phẩm dcmrecv ứng dụng triển khai Nhà cung cấp lớp dịch vụ (SCP) cho Dịch vụ lưu trữ
Lớp. Ngược lại với cái nổi tiếng storecp tiện ích, dcmrecv có ít lựa chọn và có thể hơn,
do đó, dễ sử dụng hơn - điều này cũng giải thích thuật ngữ 'đơn giản' trong tiêu đề. chính
Mục đích của ứng dụng này là nhận toàn bộ tập dữ liệu DICOM từ Bộ lưu trữ
Người dùng lớp dịch vụ (SCU) và lưu trữ chúng vào cấu trúc tệp và thư mục có thể định cấu hình.

THÔNG SỐ

cổng tcp / số cổng ip để nghe

LỰA CHỌN

chung lựa chọn
-h - trợ giúp
in văn bản trợ giúp này và thoát

--phiên bản
in thông tin phiên bản và thoát

--tranh luận
in các đối số dòng lệnh mở rộng

-q --im lặng
chế độ yên tĩnh, in không có cảnh báo và lỗi

-v --dài dòng
chế độ tiết, chi tiết xử lý in

-d --gỡ lỗi
chế độ gỡ lỗi, in thông tin gỡ lỗi

-ll --log-level [l] evel: hằng số chuỗi
(nghiêm trọng, lỗi, cảnh báo, thông tin, gỡ lỗi, theo dõi)
sử dụng mức l cho trình ghi nhật ký

-lc --log-config [f] ilename: string
sử dụng tệp cấu hình f cho trình ghi nhật ký

+ v --verbose-pc
hiển thị các ngữ cảnh trình bày ở chế độ tiết

mạng lựa chọn
hồ sơ thương lượng liên kết từ tệp cấu hình:

-xf --config-file [f] ilename, [p] rofile: string
sử dụng hồ sơ p từ tập tin cấu hình f

tiêu đề thực thể ứng dụng:

-aet --aetitle [a] etitle: string
đặt tiêu đề AE của tôi (mặc định: DCMRECV)

-uca --use-gọi-aetitle
luôn phản hồi với tiêu đề AE được gọi

các tùy chọn mạng khác:

-ta --acse-timeout [s] econds: integer (mặc định: 30)
thời gian chờ cho tin nhắn ACSE

-td --dimse-timeout [s] econds: integer (mặc định: không giới hạn)
thời gian chờ cho tin nhắn DIMSE

-pdu --max-pdu [n] umber of byte: integer (4096..131072)
đặt pdu nhận tối đa thành n byte (mặc định: 16384)

-dhl --disable-host-lookup tắt tính năng tra cứu tên máy chủ

đầu ra lựa chọn
chung:

-od --output-directory [d] irectory: string (default: ".")
ghi các đối tượng đã nhận vào thư mục hiện có d

tạo thư mục con:

-s --no-thư mục con
không tạo bất kỳ thư mục con nào (mặc định)

+ssd --series-date-subdir
tạo thư mục con từ ngày chuỗi

tạo tên tệp:

+fd --tên tệp mặc định
tạo tên tệp từ UID phiên bản (mặc định)

+fu --tên tệp duy nhất
tạo tên tệp duy nhất dựa trên UID mới

+fsu --tên ngắn gọn duy nhất
tạo tên tệp duy nhất giả ngẫu nhiên ngắn

+fst --tên thời gian hệ thống
tạo tên tệp từ thời gian hệ thống hiện tại

-fe --filename-extension [e]xtension: string (mặc định: không có)
nối thêm e vào tất cả tên tệp được tạo

chế độ lưu trữ:

-B - bình thường
cho phép chuyển đổi định dạng ngầm định (mặc định)

+ B - bảo quản bit
viết tập dữ liệu chính xác như đã nhận được

--phớt lờ
bỏ qua tập dữ liệu, nhận nhưng không lưu trữ nó

GHI CHÚ

Điển hình Sử dụng
Một trường hợp sử dụng điển hình của dcmrecv là nhận các phiên bản SOP được gửi từ SCU lưu trữ
và lưu chúng dưới dạng tệp DICOM. Lệnh sau thực hiện chính xác điều này:

dcmrecv --verbose --config-file storecp.cfg mặc định

Nếu bạn thích một số cấu trúc thư mục con được tạo tự động, tên tệp ngắn hơn và
phần mở rộng '.dcm' cho tất cả các tệp DICOM, hãy sử dụng lệnh sau:

dcmrecv -v -xf storecp.cfg mặc định --series-ngày-thư mục con
--tên ngắn gọn duy nhất
--tên tệp-phần mở rộng .dcm

Trong trường hợp các phiên bản SOP rất lớn hoặc nếu tập dữ liệu phải được viết chính xác như
đã nhận được (ví dụ: cho mục đích gỡ lỗi), có thể sử dụng 'chế độ bảo toàn bit':

dcmrecv -v -xf storecp.cfg mặc định --bảo quản bit

Các bộ dữ liệu nhận được luôn được lưu trữ dưới dạng tệp DICOM có cùng Cú pháp truyền như
được sử dụng để truyền mạng.

DICOM Sự phù hợp
Về cơ bản, dcmrecv ứng dụng hỗ trợ tất cả các lớp SOP lưu trữ dưới dạng SCP, bao gồm
những cái riêng tư. Tuy nhiên, điều này yêu cầu hồ sơ đàm phán liên kết tương ứng
được tải từ một tập tin cấu hình. Định dạng và ngữ nghĩa của tệp cấu hình này
được ghi lại trong asconfig.txt.

Theo mặc định, điều đó có nghĩa là nếu không có hồ sơ đàm phán liên kết nào được tải, dcmrecv có thể
hỗ trợ Lớp SOP Xác minh dưới dạng SCP (với cú pháp truyền mặc định, tức là Ẩn
VR Litte Endian).

Trong tương lai, có thể có các tùy chọn bổ sung cho phép chỉ định danh sách
Bối cảnh trình bày được hỗ trợ (tức là sự kết hợp giữa Lớp SOP và Cú pháp truyền)
trực tiếp, tức là không tải tệp cấu hình.

Thư mục con Thế hệ
Tùy chọn --series-ngày-thư mục con cho phép tạo các thư mục con (dưới thư mục được chỉ định
thư mục đầu ra) dựa trên giá trị của phần tử dữ liệu Ngày chuỗi (0008,0021) từ
đã nhận được tập dữ liệu DICOM. Nếu giá trị này có thể được lấy từ tập dữ liệu và hợp lệ
(tức là bao gồm trường ngày DICOM hợp lệ), cấu trúc thư mục con như sau:

/dữ liệu/ / / /

Nếu Ngày chuỗi (0008,0021) không thể truy xuất được hoặc không hợp lệ thì ngày hệ thống hiện tại
được sử dụng cho cấu trúc thư mục con sau:

/undef/ /

Trong cả hai trường hợp, gồm 4 chữ số thập phân và cũng như của 2
chữ số thập phân.

Tên tập tin Thế hệ
Theo mặc định, tên tệp để lưu trữ bộ dữ liệu DICOM nhận được được tạo theo
vào sơ đồ sau:

.

Nếu nhận được cùng một phiên bản SOP hai lần, một thông báo cảnh báo sẽ được báo cáo và phiên bản hiện có
tập tin bị ghi đè.

Tùy chọn --tên tệp duy nhất đảm bảo rằng mỗi tập dữ liệu DICOM nhận được được lưu trữ dưới dạng
tập tin riêng biệt, tức là không có tập tin nào bị ghi đè. Điều này được thực hiện bằng cách sử dụng một
đã tạo mã định danh duy nhất (UID) cho mỗi tên tệp được tạo (và thêm chữ '.X' theo thứ tự
để tránh xung đột với các giá trị UID phiên bản SOP thực). Sơ đồ đặt tên cho tùy chọn này
là như sau:

.X.

Tùy chọn khi nào --tên ngắn gọn duy nhất được sử dụng, tên tệp được tạo bởi một số tên giả
trình tạo tên ngẫu nhiên, điều này cũng đảm bảo rằng không có xung đột (tức là hiện có
các tập tin không bị ghi đè). Đây là sơ đồ đặt tên:

_

Với gồm 16 chữ số theo ký hiệu thập lục phân.

Cuối cùng, tùy chọn --tên-thời gian hệ thống cho phép tạo tên tập tin dựa trên hiện tại
thời gian hệ thống:

.

Với bao gồm ' ' Và của
' . '. Xin lưu ý rằng kế hoạch này có thể dẫn đến
xung đột đặt tên nếu độ phân giải của thời gian hệ thống không đủ cao (tức là
không hỗ trợ micro giây).

Hạn chế
Hãy lưu ý lựa chọn đó --bảo quản bit không thể được sử dụng cùng với tùy chọn --loạt-
thư mục con ngày vì tập dữ liệu nhận được được lưu trữ trực tiếp vào tệp và giá trị của
Do đó, Ngày chuỗi (0008,0021) không có sẵn trước khi tệp được tạo.

ĐĂNG NHẬP

Mức độ xuất nhật ký của các công cụ dòng lệnh khác nhau và các thư viện cơ bản có thể
được chỉ định bởi người dùng. Theo mặc định, chỉ các lỗi và cảnh báo được ghi theo tiêu chuẩn
dòng lỗi. Sử dụng tùy chọn --dài dòng cũng như các tin nhắn thông tin như xử lý chi tiết
được báo cáo. Lựa chọn --gỡ lỗi có thể được sử dụng để biết thêm chi tiết về hoạt động nội bộ,
ví dụ: cho mục đích gỡ lỗi. Các cấp độ ghi nhật ký khác có thể được chọn bằng cách sử dụng tùy chọn --log-
cấp. Trong --Yên lặng chế độ chỉ có lỗi nghiêm trọng được báo cáo. Trong các sự kiện lỗi rất nghiêm trọng như vậy,
ứng dụng thường sẽ kết thúc. Để biết thêm chi tiết về các cấp độ ghi nhật ký khác nhau,
xem tài liệu của mô-đun 'oflog'.

Trong trường hợp kết quả ghi nhật ký phải được ghi vào tệp (tùy chọn với xoay tệp nhật ký),
đến nhật ký hệ thống (Unix) hoặc tùy chọn nhật ký sự kiện (Windows) --log-config có thể được sử dụng. Cái này
tệp cấu hình cũng chỉ cho phép chuyển hướng một số thông báo đến một đầu ra cụ thể
luồng và để lọc các thư nhất định dựa trên mô-đun hoặc ứng dụng nơi chúng
Được tạo ra. Một tệp cấu hình mẫu được cung cấp trong /logger.cfg.

COMMAND ĐƯỜNG DÂY

Tất cả các công cụ dòng lệnh sử dụng ký hiệu sau cho các tham số: dấu ngoặc vuông bao quanh
giá trị tùy chọn (0-1), ba dấu chấm ở cuối cho biết rằng nhiều giá trị được phép
(1-n), kết hợp của cả hai có nghĩa là giá trị từ 0 đến n.

Các tùy chọn dòng lệnh được phân biệt với các tham số bằng dấu '+' hoặc '-' đứng đầu,
tương ứng. Thông thường, thứ tự và vị trí của các tùy chọn dòng lệnh là tùy ý (tức là chúng
có thể xuất hiện ở bất kỳ đâu). Tuy nhiên, nếu các tùy chọn loại trừ lẫn nhau, sự xuất hiện ngoài cùng bên phải
Được sử dụng. Hành vi này tuân theo các quy tắc đánh giá tiêu chuẩn của các trình bao Unix phổ biến.

Ngoài ra, một hoặc nhiều tệp lệnh có thể được chỉ định bằng cách sử dụng dấu '@' làm tiền tố cho
tên tệp (ví dụ: @ command.txt). Đối số lệnh như vậy được thay thế bằng nội dung của
tệp văn bản tương ứng (nhiều khoảng trắng được coi như một dấu phân tách duy nhất trừ khi
chúng xuất hiện giữa hai dấu ngoặc kép) trước khi đánh giá thêm. Xin lưu ý rằng
tệp lệnh không được chứa tệp lệnh khác. Cách tiếp cận đơn giản nhưng hiệu quả này
cho phép người ta tóm tắt các kết hợp phổ biến của các tùy chọn / tham số và tránh dài dòng và
các dòng lệnh khó hiểu (một ví dụ được cung cấp trong tệp /dumppat.txt).

EXIT MÃ

Sản phẩm dcmrecv tiện ích sử dụng các mã thoát sau khi kết thúc. Điều này cho phép người dùng
để kiểm tra lý do tại sao ứng dụng bị chấm dứt.

chung
EXITCODE_NO_ERROR 0
EXITCODE_COMMANDLINE_SYNTAX_ERROR 1

đầu vào hồ sơ lỗi
EXITCODE_CANNOT_READ_INPUT_FILE 20 (*)

đầu ra hồ sơ lỗi
EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40 (*)
EXITCODE_INVALID_OUTPUT_DIRECTORY 45

mạng lỗi
EXITCODE_CANNOT_INITIALIZE_NETWORK 60 (*)
EXITCODE_CANNOT_START_SCP_AND_LISTEN 64
EXITCODE_INVALID_ASSOCIATION_CONFIG 66

(*) Trên thực tế, những mã này hiện không được sử dụng bởi dcmrecv nhưng phục vụ như một trình giữ chỗ cho
nhóm mã thoát tương ứng.

MÔI TRƯỜNG

Sản phẩm dcmrecv tiện ích sẽ cố gắng tải từ điển dữ liệu DICOM được chỉ định trong
DCMDICTPATH biến môi trường. Theo mặc định, tức là nếu DCMDICTPATH biến môi trường
không được thiết lập, tệp /dicom.dic sẽ được tải trừ khi từ điển được xây dựng
vào ứng dụng (mặc định cho Windows).

Hành vi mặc định nên được ưu tiên và DCMDICTPATH chỉ biến môi trường
được sử dụng khi từ điển dữ liệu thay thế được yêu cầu. Các DCMDICTPATH biến môi trường
có cùng định dạng với Unix shell PATH biến trong đó dấu hai chấm (':') ngăn cách
mục. Trên hệ thống Windows, dấu chấm phẩy (';') được sử dụng làm dấu phân cách. Từ điển dữ liệu
mã sẽ cố gắng tải từng tệp được chỉ định trong DCMDICTPATH biến môi trường. Nó
là một lỗi nếu không có từ điển dữ liệu nào có thể được tải.

Sử dụng dcmrecv trực tuyến bằng dịch vụ onworks.net