gdcmscu - آنلاین در ابر

برنامه:

نام

gdcmscu - ابزاری برای اجرای عملیات Query/Retrieve DICOM

خلاصه

gdcmscu [OPTION]...[OPERATION]...HOSTNAME...[PORT]...

اجرای یک عملیات DICOM Q/R در HOSTNAME، با استفاده از پورت PORT (104 زمانی که مشخص نشده است)

شرح

La gdcmscu برنامه خط فرمان ابزاری برای اجرای عملیات پرس و جو/بازیابی DICOM است. آی تی
پشتیبانی می کند:

· C-ECHO (SCU)

· C-FIND (SCU)

· C-STOR (SCU)

C-MOVE (SCU/SCP) عملیات C-MOVE با استفاده از دو پورت مختلف (یکی برای
SCU و یکی برای SCP).

پارامترهای

OPTIONS

خاص گزینه های
-H --نام میزبان %s نام میزبان.
-p --port %d شماره پورت.
--aetitle %s فراخوانی عنوان AE را تنظیم کنید.
--call %s مجموعه ای به نام AE Title.

حالت گزینه های
--echo C-ECHO (پیش‌فرض زمانی که هیچ کدام).
--store C-STORE.
--پیدا کردن C-FIND.
--move C-MOVE.

فروشگاه سی گزینه های
-i --input %s نام فایل DICOM
-r -دایرکتوری های بازگشتی به صورت بازگشتی پردازش می کند (زیر-).
--store-query %s پرس و جوی ساخته شده را در فایل ذخیره کنید

C-FIND/C-MOVE گزینه های
--patientroot C-FIND مدل ریشه بیمار.
--studyroot C-FIND Study Root Model.

--Patient C-FIND Query on Patient Info (با --studyroot قابل استفاده نیست).
--Study C-FIND Query on Study Info.
--series C-FIND پرس و جو در اطلاعات سری.
--image C-FIND پرس و جو در اطلاعات تصویر.
--کلید %d،%d[=%s] 0123,4567=VALUE برای تعیین معیارهای جستجو (کارت عام مجاز است)
با --key، برای بازیابی مقادیر، آن را خالی بگذارید (یعنی --key 10,20="" یا --key 10,20)

C-MOVE گزینه های
-o -- خروجی %s نام فایل / دایرکتوری DICOM
--port-scp %d پورت برای ارتباطات ورودی
--کلید %d،%d[=%s 0123,4567=VALUE برای تعیین معیارهای جستجو (کارت عام مجاز نیست)
توجه داشته باشید که C-MOVE از همان جستارهای C-FIND پشتیبانی می کند، اما هیچ علامت عام مجاز نیست

عمومی گزینه های
-h -- کمک
این متن راهنما را چاپ کنید و خارج شوید

-v -- نسخه
چاپ اطلاعات نسخه و خروج

-V -- پرحرف
حالت پرحرف (هشدار + خطا).

-W -- هشدار
حالت هشدار، اطلاعات هشدار چاپ

-E --خطا
حالت خطا، اطلاعات خطای چاپ

-D - اشکال زدایی
حالت اشکال زدایی، چاپ اطلاعات اشکال زدایی

-L --log-file
نام فایلی را برای نوشتن گزارش ها مشخص کنید

--query help
کمک پرس و جو چاپ

محیط متغیر
GDCM_ROOT_UID Root UID

C-ECHO طریقه استفاده

gdcmscu یک ابزار عالی برای آزمایش اینکه آیا سرور DICOM فعال است یا خیر. به عنوان مثال برای ارسال یک C-ECHO به
سرور dicom.example.com با استفاده از پورت 104، استفاده از:

$ gdcmscu dicom.example.com

یا اگر ترجیح می دهید صریح باشید:

$ gdcmscu --echo dicom.example.com 104

استفاده از امنیت اولیه سرور DICOM شما ممکن است مستلزم تنظیم فراخوانی مناسب باشد
AE-TITLE

$ gdcmscu --echo dicom.example.com 11112 --با SERVSCP تماس بگیرید

اگر می‌خواهید AE-TITLE خود را مشخص کنید (پیش‌فرض GDCMSCU است)، به سادگی استفاده کنید:

$ gdcmscu --echo dicom.example.com 11112 -- تماس با SERVSCP --aetitle MYSCU

به عنوان مثال می توانید روی سرور DICOM ارائه شده توسط تیم DICOMObject تست کنید:

$ gdcmscu www.dicomserver.co.uk 11112

فروشگاه سی طریقه استفاده

C-STORE عملیاتی است که امکان ارسال فایل DICOM را به سرور DICOM راه دور می دهد. برای
نمونه ای برای ارسال فایلی به نام myfile.dcm

$ gdcmscu --store dicom.example.com 104 myfile.dcm

یا اگر ترجیح می دهید صریح باشید:

$ gdcmscu --store dicom.example.com 104 -i myfile.dcm

حتی می توانید چندین فایل را با استفاده از یک انجمن ارسال کنید:

$ gdcmscu --store dicom.example.com 104 myfile1.dcm myfile2.dcm myfile3.dcm ...

C-FIND طریقه استفاده

gdcmscu همچنین اجازه پرس و جو از سرور DICOM را می دهد. این عملیات C-FIND است، برای مثال به
همه موارد DICOM را پیدا کنید که PatientsName با یک الگوی خاص مطابقت دارد، استفاده به سادگی به این صورت است:

$ gdcmscu --find --patient dicom.example.com 11112 --patientroot --key 10,10 "A*"

ما همچنین از یک کنوانسیون سازگار با DCMTK پشتیبانی می کنیم:

$ gdcmscu --find --patient dicom.example.com 11112 --patientroot --key 10,10="A*"

هنگامی که یک ویژگی بدون مقدار تنظیم می شود، بخشی از نتیجه خروجی خواهد بود:

$ gdcmscu --find --patient dicom.example.com 11112 --تماس با MI2B2 --patientroot -k 10,10="A*" -k 10,20

C-MOVE طریقه استفاده

C-MOVE عملیات بازیابی یک نمونه DICOM از یک سرور DICOM راه دور است. بیشتر
زمان، این یک عملیات بعدی پس از پرس و جو C-FIND است. برای بازیابی یک نمونه DICOM
که در آن PatientID ABCD1234 است، به سادگی اجرا کنید:

$ gdcmscu --move --patient --aetitle ACME1 --با ACME_STORE تماس بگیرید dicom.example.com 5678 --patientroot -k 10,20="ABCD1234" --port-scp 1234

اخطار برای اینکه این عملیات کار کند، به اطلاعاتی از سرور DICOM نیاز دارید
ارتباط با. فقط سرور DICOM که درخواست C-MOVE را ارسال می کنید، خواهد بود
مسئول بازگرداندن انجمن های دریافتی (C-STORE SCP واقعی). بنابراین شما
باید مطمئن شوید که نگاشت (AE-TITLE،PortNumber) به درستی در DICOM تنظیم شده است.
سمت سرور و همچنین پورت ارتباط ورودی (–port-scp).

gdcmscu در حال حاضر ارتباط خارجی C-STORE را پشتیبانی نمی کند (درخواست C-STORE به
یک برنامه SCP خارجی).

PATIENTROOT NOTES

flag –patientroot فقط یک بسته بندی در اطراف نحو است –key 8,52=PATIENT For
به عنوان مثال می توان با استفاده از نحو DCMTK نوشت:

$ findscu --patient dicom.example.com 11112 --key 8,52=PATIENT --key 10,10="F*"

این با استفاده از نحو GDCM می شود:

$ gdcmscu --find --patient dicom.example.com 11112 --patientroot --key 10,10="F*"

اشکال زدایی

بررسی اینکه چرا اتصال به یک سرور DICOM راه دور نمی تواند انجام شود، گاهی دشوار است
انجام شود. برخی از توصیه ها به شرح زیر است:

همیشه سعی کنید ابتدا یک C-ECHO ساده انجام دهید. اگر نمی توانید C-ECHO را به کار بیاندازید، هیچ کدام
سایر عملیات ها کار خواهند کرد

قبل از تلاش برای عملیات C-MOVE، مطمئن شوید که می توانید پرس و جوی معادل C-FIND را اجرا کنید.
برای اولین بار.

هنگام انجام یک عملیات C-MOVE، واقعاً باید با مدیر PACS به عنوان مدیر ارتباط برقرار کنید
عملیات C-MOVE با سایر عملیات سطح پایین تر مانند HTTP/GET متفاوت است. چه زمانی
با انجام C-MOVE، سرور با استفاده از کانال دیگری ارتباط برقرار می کند (ممکن است متفاوت باشد
پورت) با استفاده از پایگاه داده داخلی خود برای نگاشت یک AE-TITLE به IP مقصد.

در واقع عملیات C-MOVE بر اساس طراحی همیشه از آدرس IP ورودی شما برای ارسال استفاده نمی کند
مجموعه داده حاصل را برگردانید. در عوض از نگاشت AE-TITLE به آدرس IP برای ارسال استفاده می کند
پس از هر نتیجه بنابراین به املای AE-TITLE و خود توجه ویژه ای داشته باشید
پورت ورودی (که ممکن است با پورت اتصال به سرور متفاوت باشد).

PORT هشدار

مراقب باشید که محدوده پورت [1-1024] برای مدیر رزرو شده است و به راحتی قابل دسترسی نیست
مگر اینکه امتیازات خاصی به آنها داده شود. بنابراین ممکن است پورت پیش فرض 104 DICOM نباشد
برای همه کاربران شما قابل دسترسی است.

فروشگاه سی هشدارها

هنگام ساخت یک عملیات C-STORE، gdcmscu همیشه از کلاس SOP Storage Media استفاده می کند.
UID همانطور که در فایلی که قرار است ارسال شود یافت می شود. برای فایل DICOM کپسوله شده (به عنوان مثال RLE Lossless)
سرور SCP دریافت کننده ممکن است از این فشرده سازی پشتیبانی نکند و به طور قانونی از آن امتناع کند
عملیات C-STORE. در این حالت کاربران باید به صورت دستی به فرم غیر فشرده تبدیل کنند
این فایل خاص:

$ gdcmconv --raw compressed.dcm non_compressed.dcm

C-MOVE هشدارها

در حال حاضر gdcmscu فقط از نحو انتقال غیر فشرده پشتیبانی می کند. همیشه درخواست خواهد کرد
مجموعه داده‌ها با استفاده از نحو انتقال اندین اندیان VR ضمنی در طول عملیات C-MOVE (هر دو
انجمن های ورودی و خروجی). این باعث می شود gdcmscu –move معادل DCMTK movescu باشد
نحو:

$ movescu -xi +xi ...

C-FIND IMAGE سطح (کامپوزیت هدف - شی نمونه، مثال)

باید توجه داشت که gdcmscu –find و findscu کاملاً معادل نیستند.
با استفاده از gdcmscu –find، تمام کلیدهای منحصر به فرد به طور خودکار اضافه می شوند. بنابراین می توان
چیزی شبیه به این را اجرا کنید:

$ gdcmscu --find --patientroot --image --key 8,18=1.2.3.4.5.6 dicom.example.com 11112

به جای شکل صریح تر

$ gdcmscu --find --patientroot --image --key 8,18=1.2.3.4.5.6 dicom.example.com 11112 --key 10,20 --key 20,d --key 20,e

این نیز معادل خواهد بود با:

$ findscu --patient --key 8,52=IMAGE --key 8,18=1.2.3.4.5.6 dicom.example.com 11112 --key 10,20 --key 20,d --key 20,e

ذخیره سازی L' پرس و جو

همچنین امکان ذخیره پرس و جو وجود دارد:

gdcmscu --find --patient --patientroot dicom.example.com 11112 --key 10,20="*" --key 10,10 --store-query query.dcm

سپس می توان مقادیر DataSet ارسال شده برای پرس و جو را بررسی کرد:

$ gdcmdump query.dcm
# Dicom-File-Format

# Dicom-Meta-Information-Header
# TransferSyntax استفاده شده:

# Dicom-Data-Set
# TransferSyntax استفاده شده: 1.2.840.10008.1.2
(0008,0005) ?? (CS) [ISO_IR 192] # 10,1-n ​​مجموعه کاراکترهای خاص
(0008,0052) ?? (CS) [بیمار] # 8,1،XNUMX سطح پرس و جو/بازیابی
(0010,0010) ?? (PN) (بدون مقدار) # 0,1 نام بیمار
(0010,0020) ?? (LO) [* ] # 2,1،XNUMX شناسه بیمار

مجموعه کاراکترهای خاص روی "ISO_IR 192" به عنوان کدگذاری محلی سیستم تنظیم شد.
به طور خودکار توسط gdcmscu به عنوان UTF-8 یافت شد.

این بدان معنی است که خط فرمان زیر به درستی Query را با the تنظیم می کند
Charset مناسب برای اجرای صحیح:

$ gdcmscu --find --patient --patientroot dicom.example.com 11112 --key 10,10="*Jérôme*"

پرس و جو همیشه در سمت سرور (SCP) اجرا می شود، برخی از پیاده سازی ها اجرا نمی شوند
پشتیبانی از تطبیق رشته با مجموعه کاراکترهای مختلف.

DICOM عمومی سرور

لیست به‌روز سرورهای عمومی DICOM را می‌توانید در آدرس زیر مشاهده کنید:

http://www.dclunie.com/medical-image-faq/html/part8.html#DICOMPublic Servers

از gdcmscu به صورت آنلاین با استفاده از خدمات onworks.net استفاده کنید