זוהי הפקודה dcmqrti שניתן להריץ בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות החינמיות שלנו, כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS.
תָכְנִית:
שֵׁם
dcmqrti - תוכנית לקוח Telnet של יוזם הטרמינל
תַקצִיר
dcmqrti [אפשרויות] עמית...
תיאור
השמיים dcmqrti תוכנית (יוזם טלנט) היא תוכנית אינטראקטיבית מבוססת תווים שנועדה
לשימוש לבדיקת מסדי נתונים של תמונות dcmqrscp ושליחת תמונות הכלולות בתוכם
מסדי נתונים אלה לצמתי ספק. במהלך הדגמת DICOM, ה- dcmqrti התוכנית יכולה להיות
מופעל על ידי ספק על ידי כניסה למחשב שמפעיל את dcmqrscp תוכנית. כל אחד
לספק יהיה חשבון התחברות משלו ו- dcmqrti התוכנית תופעל במקום זאת
של מעטפת רגילה כשהם מתחברים.
השמיים dcmqrti התוכנית מקבלת ארגומנט ראשי אחד, שם המארח או שם סמלי הספק (מ-
טבלת הספקים (בקובץ התצורה) של ספק. לאחר מכן הוא מחפש ב
קובץ תצורה עבור כל כותרי AE המשויכים לשם מארח או שם ספק זה, וכל
אזורי אחסון נגישים לכותרי AE אלה. לפיכך רק מסדי הנתונים והעמיתים הנגישים
יישומים שהתגלו בקובץ התצורה זמינים כאפשרויות בתוך
dcmqrti ממשק משתמש.
פרמטרים
שם מארח עמית או שם סמלי מקובץ cfg
אפשרויות
כללי אפשרויות
-h --עזרה
הדפס את טקסט העזרה הזה וצא
--גִרְסָה
הדפס מידע על גרסה ויציאה
--טיעונים
הדפס ארגומנטים מורחבים של שורת פקודה
-q --שקט
מצב שקט, ללא אזהרות ושגיאות
-v --מלל
מצב מילולי, פרטי עיבוד הדפסה
-d --debug
מצב ניפוי באגים, הדפס מידע על ניפוי באגים
-ll --log-level [l]evel: קבוע מחרוזת
(פטאלי, שגיאה, אזהרה, מידע, איתור באגים, מעקב)
השתמש ברמה l עבור לוגר
-lc --log-config [f]שם קובץ: מחרוזת
השתמש בקובץ התצורה f עבור לוגר
-c --config [f]שם קובץ: מחרוזת
להשתמש בקובץ תצורה ספציפי
(ברירת מחדל: /usr/local/etc/dcmqrscp.cfg)
רשת אפשרויות
-to --timeout [שניות]: מספר שלם (ברירת מחדל: בלתי מוגבל)
פסק זמן לבקשות חיבור
-ta --acse-timeout [s]שניות: מספר שלם (ברירת מחדל: 30)
פסק זמן להודעות ACSE
-td --dimse-timeout [שניות]: מספר שלם (ברירת מחדל: בלתי מוגבל)
פסק זמן להודעות DIMSE
-xi --propose-implicit
הצע VR מרומז קטן אנדיאן TS בלבד
-aet --aetitle [a]etitle: מחרוזת
הגדר את כותרת ה-AE שלי (ברירת מחדל: TELNET_INITIATOR)
-pdu --max-pdu [n]מספר בתים: מספר שלם (4096..131072)
הגדר את מספר ה-pdu המקסימלי לקבלה ל-n בתים
(ברירת מחדל: השתמש בערך מקובץ התצורה)
אַחֵר אפשרויות
-u --disable-new-vr
השבת את התמיכה עבור VRs חדשים, המר ל-OB
-rmt --remote [כותרת]: מחרוזת
התחברות למסד נתונים מרוחק שהוגדר בקובץ cfg
אורים
פקודות
ניתן לקצר את כל הפקודות. קיצור מותר אם הוא אינו מתנגש עם
פקודה נוספת.
'עֶזרָה' פיקוד
הפקודה 'help' נותנת סיכום של כל הפקודות הזמינות. הפלט שלה מוצג
מתחת. על מנת להפריד את הדוגמאות מהטקסט שמסביב, כל הדוגמאות הן
מוקפים בקווים מקווקווים. קווים אלה אינם מופיעים בעת הפעלת התוכנית.
-------------------------------------------------- ----------
סיכום פקודות:
עזרה ברשימת הסיכום הזה
עזרה קצרה
כותרת [#] רשימה [הגדר] עמית נוכחי AE כותרת
מסד נתונים [#] רשימה [הגדר] מסד נתונים נוכחי
מחקר [#] רשימה [קבוצה] מחקר נוכחי
סדרה [#] רשימה [קבוצה] סדרה נוכחית
תמונה [#] רשימה [הגדר] תמונה נוכחית
תצוגה [#] הצגת תמונה [ספציפית] נוכחית
שלח מחקר [#] שלח מחקר [ספציפי] נוכחי
שלח סדרה [#] שלח סדרה [ספציפית] נוכחית
שלח תמונה [#] שלח תמונה [ספציפית] נוכחית
הד [#] אימות קישוריות [# פעמים]
להפסיק את התוכנית
יציאה נרדף ל"לפסיק"
-------------------------------------------------- ----------
'כּוֹתֶרֶת' פיקוד
הפקודה 'title' ללא ארגומנט מאפשרת למשתמש לרשום את השלט המוכר
ישויות אפליקציה (AE). פלט לדוגמה עשוי להיראות כך:
-------------------------------------------------- ----------
כותרות עמיתים AE:
שם מארח של עמית AE: מספר פורט
* 0) ACME1 (בליעה: 2001)
1) ACME2 (בליעה: 2002)
2) יונייטד 1 (קוליברי:2001)
3) יונייטד 2 (קוליברי:2002)
-------------------------------------------------- ----------
AE העמית הנוכחי מסומן בכוכבית (*). לכל AE עמית יש אינדקס (שני
עמודה) אשר ניתן להשתמש בה כארגומנט לפקודת 'title' על מנת להגדיר את
AE של עמית נוכחי. העמודה השלישית מציגה את כותרת ה-AE של AE של העמית. העמודה הרביעית
מציג את שם המארח ומספר יציאת ה-TCP/IP של העמית AE.
כאשר הפקודה 'title' מופעלת עם אינדקס ארגומנטים, היא תגדיר את AE העמית הנוכחי.
dcmqrti התוכנית תנסה ליזום שיוך לעמית AE הנוכחי כאשר תתבקש
לשלוח מחקר/סדרה/תמונה או לשלוח הד.
מסד נתונים פיקוד
הפקודה 'database' ללא ארגומנט מאפשרת למשתמש לרשום את הקבצים המקומיים הידועים
מסדי נתונים (אלה תואמים לכותרות ישויות היישומים של dcmqrscp). פלט לדוגמה
עשוי להיראות כמו:
-------------------------------------------------- ----------
כותרות מסד הנתונים:
מסד נתונים
* 0) נפוץ
1) ACME_QUERY
2) חנות ACME
3) UNITED_QUERY
-------------------------------------------------- ----------
מסד הנתונים הנוכחי מסומן בכוכבית (*). לכל מסד נתונים יש אינדקס (שני)
עמודה) אשר ניתן להשתמש בה כארגומנט לפקודת 'database' על מנת להגדיר את
מסד הנתונים הנוכחי. העמודה השלישית מציגה את שם מסד הנתונים (כלומר, dcmqrscp
כותרת ישות האפליקציה עבור אזור האחסון הספציפי).
כאשר הפקודה 'database' מופעלת עם אינדקס ארגומנט, היא תגדיר את מסד הנתונים הנוכחי.
מסד הנתונים הנוכחי משמש כבסיס לפעולות ספציפיות נוספות למסד הנתונים.
'לִלמוֹד' פיקוד
הפקודה 'study' ללא ארגומנט מפרטת את המחקרים במסד הנתונים הנוכחי. דוגמה
הפלט עשוי להיראות כך:
-------------------------------------------------- ----------
מזהה מטופל מזהה מחקר
* 0) ג'קסון^אנדרו^^^ M4997106 20001
1) גרנט^מרי^^^ F4997108 20002
2) ארתור^צ'סטר^^^ M4997107 20003
3) ג'פרסון^תומאס^^^ M4997096 9465
4) מדיסון^דולי^^^ F4997097 9443
4 מחקרים במסד נתונים: COMMON
-------------------------------------------------- ----------
המחקר הנוכחי מסומן בכוכבית (*). לכל מחקר יש אינדקס (עמודה שנייה)
אשר יכול לשמש כארגומנט לפקודת 'study' על מנת להגדיר את המחקר הנוכחי.
העמודה השלישית מציגה את שם המטופל, העמודה הרביעית את מזהה המטופל והעמודה החמישית
עמודה מזהה המחקר.
כאשר הפקודה 'study' מופעלת עם אינדקס ארגומנט, היא תגדיר את המחקר הנוכחי.
המחקר הנוכחי משמש כבסיס לפעולות מחקר ספציפיות נוספות.
'סִדרָה' פיקוד
הפקודה 'series' ללא ארגומנט מפרטת את הסדרה במחקר הנוכחי. דוגמה
הפלט עשוי להיראות כך:
-------------------------------------------------- ----------
שיטת סדרה SeriesInstanceUID
* 0) 1 מ"ר 1.2.840.113654.2.3.1993.201
1) 2 MR 1.2.840.113654.2.3.1993.202
2) 3 MR 1.2.840.113654.2.3.1993.203
3) 4 MR 1.2.840.113654.2.3.1993.204
4) 5 MR 1.2.840.113654.2.3.1993.205
5 סדרות ב- StudyID 05381,
מטופל: מונרו^ג'יימס^^^ (מסד נתונים: COMMON)
-------------------------------------------------- ----------
הסדרה הנוכחית מסומנת בכוכבית (*). לכל סדרה יש אינדקס (שני
עמודה) אשר ניתן להשתמש בה כארגומנט לפקודת 'series' על מנת להגדיר את
הסדרה הנוכחית. העמודה השלישית מציגה את מספר הסדרה, העמודה הרביעית את הסדרה
המודל, והעמודה החמישית את UID של מופע הסדרה.
כאשר הפקודה 'series' מופעלת עם אינדקס ארגומנט, היא תגדיר את הסדרה הנוכחית.
הסדרה הנוכחית משמשת כבסיס לפעולות ספציפיות לסדרה נוספת.
'תמונה' פיקוד
הפקודה 'image' ללא ארגומנט מפרטת את התמונות בסדרה הנוכחית. דוגמה
הפלט עשוי להיראות כך:
-------------------------------------------------- ----------
תמונה ImageInstanceUID
* 0) 1 1.2.840.113654.2.3.1993.9.123.6.2674
1) 2 1.2.840.113654.2.3.1993.9.123.6.2675
2) 3 1.2.840.113654.2.3.1993.9.123.6.2676
3) 4 1.2.840.113654.2.3.1993.9.123.6.2677
4) 5 1.2.840.113654.2.3.1993.9.123.6.2678
5) 6 1.2.840.113654.2.3.1993.9.123.6.2679
6) 7 1.2.840.113654.2.3.1993.9.123.6.2680
7) 8 1.2.840.113654.2.3.1993.9.123.6.2681
8) 9 1.2.840.113654.2.3.1993.9.123.6.2682
9) 10 1.2.840.113654.2.3.1993.9.123.6.2683
10) 11 1.2.840.113654.2.3.1993.9.123.6.2684
11) 12 1.2.840.113654.2.3.1993.9.123.6.2685
12) 13 1.2.840.113654.2.3.1993.9.123.6.2686
13 תמונות בסדרת MR, StudyID 05381,
מטופל: מונרו^ג'יימס^^^ (מסד נתונים: COMMON)
-------------------------------------------------- ----------
התמונה הנוכחית מסומנת בכוכבית (*). לכל תמונה יש אינדקס (עמודה שנייה)
אשר יכול לשמש כארגומנט לפקודת 'image' על מנת להגדיר את התמונה הנוכחית.
העמודה השלישית מציגה את מספר התמונה, והעמודה הרביעית את UID של מופע התמונה (SOP)
(UID של המופע).
כאשר הפקודה 'image' מופעלת עם אינדקס ארגומנט, היא תגדיר את התמונה הנוכחית.
התמונה הנוכחית משמשת כבסיס לפעולות נוספות ספציפיות לתמונה.
'לְהַצִיג' פיקוד
פקודת התצוגה אינה משרתת מטרה בגרסה הנוכחית של DCMTK. היא שימשה ב
מהדורות קודמות כדי לבקש מתוכנית התצוגה של CTN להציג תמונה.
'לִשְׁלוֹחַ' פיקוד
הפקודה 'שלח' מאפשרת אחסון של מחקר/סדרה מלאה או תמונה בודדת על
AE מרחוק. כאשר פקודה זו מופעלת, ה- dcmqrti התוכנית תפעל כ-SCU של
מחלקת שירות אחסון DICOM וניסיון ליזום שיוך עם העמית הנוכחי
AE (מוגדר באמצעות הפקודה 'title'). הצגת הקשרי פונקציות הפעלה (SOP) רלוונטיות לאחסון
יוצעו שיעורים. ייעשה ניסיון לאחסן את כל התמונות שצוינו. אם לא.
ניתן היה לנהל משא ומתן על קשר, תודפס הודעת שגיאה. אם פעולת אחסון
נכשל או אם אין הקשר מצגת מתאים זמין ותופיע הודעת שגיאה
מודפס.
הפקודה "שלח" קיימת בשלוש צורות:
שלח מחקר [#]
שלח סדרה [#]
שלח תמונה [#]
מילת המפתח 'study' פירושה שליחת כל התמונות במחקר הנוכחי. כאשר היא מופעלת עם
אינדקס הארגומנט, המחקר שצוין במסד הנתונים הנוכחי יאוחסן. ה'סדרה'
מילת מפתח פירושה לשלוח את כל התמונות בסדרה הנוכחית. כאשר היא מופעלת עם אינדקס ארגומנט,
הסדרה שצוינה במחקר הנוכחי תאוחסן. מילת המפתח 'תמונה' פירושה לשלוח
התמונה הנוכחית. כאשר היא מופעלת עם אינדקס ארגומנט, התמונה שצוינה בתמונה הנוכחית
הסדרה תישמר.
כאשר תמונה נשמרת, תודפס הודעה בצורה הבאה:
-------------------------------------------------- ----------
תחילתה של אגודה חדשה (בלויה: 2001, ACME1)
חנות [MsgID 1]
שם המטופל: ג'קסון^אנדרו^^^, מזהה מחקר: 20001,
סדרה: 2, אופן פעולה: CR, תמונה: 1,
מזהה משתמש של תמונה: 1.2.840.113654.2.3.1993.9.123.6.1834
0%________25%_________50%__________75%________100%
--------------------------------------------------
[MsgID 1] הושלם [סטטוס: הצלחה]
אסוציאציה שוחררה (בליעה: 2001, ACME1)
-------------------------------------------------- ----------
'הֵד' פיקוד
הפקודה 'echo' מאפשרת למשתמש לאמת קישוריות עם AE העמית הנוכחי
(מוגדר באמצעות הפקודה 'title'). כאשר מופעל, ה- dcmqrti התוכנית פועלת כ-SCU של
מחלקת שירות אימות.
כאשר מופעל ללא ארגומנט, נוצרת רק הודעת C-ECHO אחת. כאשר מופעל עם
ארגומנט, יישלח מספר הודעות C-ECHO שצוין. הודעה תישלח
המודפס של הטופס:
-------------------------------------------------- ----------
שיוך חדש התחיל (localhost:2001,CMOVE)
[MsgID 1] הד, הושלם [סטטוס: הצלחה]
שיוך שוחרר (localhost:2001,CMOVE)
-------------------------------------------------- ----------
'לְהַפְסִיק', 'יְצִיאָה' פקודות
לפקודות 'quit' ו-'exit' יש את אותה השפעה. הן מסיימות את dcmqrti תכנית.
דיקום התאמה
השמיים dcmqrti היישום תומך באותה קבוצה של מחלקות SOP כמו SCU כמו ה- dcmqrscp
יישום - עיין בתיעוד של dcmqrscp.
השמיים dcmqrti האפליקציה תציע הקשרים של הצגה עבור כל הנ"ל
מחלקות SOP נתמכות באמצעות תחביר ההעברה:
LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
השמיים dcmqrti היישום אינו תומך במשא ומתן מורחב.
תְצוּרָה
השמיים dcmqrti התוכנית משתמשת באותו קובץ תצורה כמו dcmqrscp תכנית. ראה את
תיעוד על תצורה למידע נוסף (dcmqrcnf.txt והדוגמה
קובץ תצורה dcmqrscp.cfg).
יומן
רמת פלט הרישום של כלי שורת הפקודה השונים והספריות הבסיסיות יכולה
יצוין על ידי המשתמש. כברירת מחדל, רק שגיאות ואזהרות נכתבות לתקן
זרם שגיאות. שימוש באפשרות --מִלוּלִי גם הודעות מידע כמו עיבוד פרטים
דווחו. אוֹפְּצִיָה --לנפות ניתן להשתמש כדי לקבל פרטים נוספים על הפעילות הפנימית,
למשל למטרות ניפוי באגים. ניתן לבחור רמות רישום אחרות באמצעות האפשרות --עֵץ-
רָמָה, --שֶׁקֶט במצב רק שגיאות קטלניות מדווחות. באירועי שגיאה כה חמורים,
הבקשה תסתיים בדרך כלל. לפרטים נוספים על רמות הרישום השונות,
ראה תיעוד של מודול 'oflog'.
במקרה שיש לכתוב את פלט הרישום לקובץ (אופציונלי עם סיבוב קובץ יומן),
ל-syslog (Unix) או לאפשרות יומן האירועים (Windows). --log-config יכול לשמש. זֶה
קובץ התצורה מאפשר גם להפנות רק הודעות מסוימות לפלט מסוים
זרם ולסינון הודעות מסוימות בהתבסס על המודול או היישום שבו הם
נוצרים. קובץ תצורה לדוגמה מסופק ב /logger.cfg.
פקודה קו
כל כלי שורת הפקודה משתמשים בסימון הבא עבור פרמטרים: סוגריים מרובעים מקיפים
ערכים אופציונליים (0-1), שלוש נקודות עוקבות מצביעות על כך שמתירים מספר ערכים
(1-n), שילוב של שניהם פירושו 0 עד n ערכים.
אפשרויות שורת הפקודה מובדלות מפרמטרים על ידי סימן '+' או '-' מוביל,
בהתאמה. בדרך כלל, הסדר והמיקום של אפשרויות שורת הפקודה הם שרירותיים (כלומר
יכול להופיע בכל מקום). עם זאת, אם האפשרויות סותרות זו את זו, המראה הימני ביותר
משמש. התנהגות זו תואמת את כללי ההערכה הסטנדרטיים של קונכיות Unix נפוצות.
בנוסף, ניתן לציין קובץ פקודה אחד או יותר באמצעות סימן '@' כתחילית ל
שם הקובץ (למשל @command.txt). ארגומנט פקודה כזה מוחלף בתוכן של
קובץ הטקסט המתאים (ריבוי רווחים מרובים מטופלים כמפריד יחיד אלא אם כן
הם מופיעים בין שתי מרכאות) לפני כל הערכה נוספת. שים לב ש
קובץ פקודה לא יכול להכיל קובץ פקודה אחר. גישה פשוטה אך יעילה זו
מאפשר לסכם שילובים נפוצים של אפשרויות/פרמטרים ונמנע ארוך ו
שורות פקודה מבלבלות (דוגמה מסופקת בקובץ /dumppat.txt).
הסביבה
השמיים dcmqrti כלי השירות ינסה לטעון את מילוני הנתונים של DICOM המצוינים ב-
DCDICTPATH משתנה הסביבה. כברירת מחדל, כלומר אם DCDICTPATH משתנה הסביבה
לא מוגדר, הקובץ /dicom.dic ייטען אלא אם המילון נבנה
לתוך האפליקציה (ברירת מחדל עבור Windows).
יש להעדיף את התנהגות ברירת המחדל ואת DCDICTPATH משתנה סביבה בלבד
משמש כאשר נדרשים מילוני נתונים חלופיים. ה DCDICTPATH משתנה הסביבה
יש אותו פורמט כמו מעטפת יוניקס נתיב משתנה בכך שנקודתיים (':') מפריד
ערכים. במערכות Windows, נקודה-פסיק (';') משמשת כמפריד. מילון הנתונים
הקוד ינסה לטעון כל קובץ שצוין ב- DCDICTPATH משתנה הסביבה. זה
היא שגיאה אם לא ניתן לטעון מילון נתונים.
השתמש ב-dcmqrti באופן מקוון באמצעות שירותי onworks.net