זוהי הפקודה dcmdump שניתן להפעיל בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות המרובות שלנו, כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS
תָכְנִית:
שֵׁם
dcmdump - dump קובץ DICOM וערכת נתונים
תַקצִיר
dcmdump [אפשרויות] dcmfile-in...
תיאור
השמיים dcmdump כלי השירות משליך את התוכן של קובץ DICOM (פורמט קובץ או ערכת נתונים גולמיים).
stdout בצורה טקסטואלית. יכולות להיות תכונות עם שדות ערך גדולים מאוד (למשל נתוני פיקסל).
מתואר כ'(לא נטען)'. שדות ערכי מחרוזת יופרדו בסוגריים מרובעים
([]). מזהי UID ידועים יוצגו על ידי שמותיהם עם סימן שוויון (למשל
'=MRImageStorage') אלא אם המיפוי הזה יכבה במפורש. ערך ריק
שדות מתוארים כ'(אין ערך זמין)'.
If dcmdump קורא מערך נתונים גולמי (נתוני DICOM ללא מטא-כותרת של פורמט קובץ) זה יעשה זאת
נסה לנחש את תחביר ההעברה על ידי בחינת הבתים הראשונים של הקובץ. זה
לא תמיד ניתן לנחש נכון את תחביר ההעברה ועדיף להמיר א
נתונים מוגדרים לפורמט קובץ במידת האפשר (באמצעות ה- dcmconv תוֹעֶלֶת). זה גם
אפשרי להשתמש ב -f ו -t[ieb] אפשרויות לכפות dcmdump כדי לקרוא מערך נתונים עם a
תחביר העברה מסוים.
פרמטרים
dcmfile-in קובץ קלט DICOM או ספריה להשלכה
אפשרויות
כללי אפשרויות
-h --עזרה
הדפס את טקסט העזרה הזה וצא
--גִרְסָה
הדפס מידע על גרסה ויציאה
--טיעונים
הדפס ארגומנטים מורחבים של שורת פקודה
-q --שקט
מצב שקט, ללא אזהרות ושגיאות
-v --מלל
מצב מילולי, פרטי עיבוד הדפסה
-d --debug
מצב ניפוי באגים, הדפס מידע על ניפוי באגים
-ll --log-level [l]evel: קבוע מחרוזת
(פטאלי, שגיאה, אזהרה, מידע, איתור באגים, מעקב)
השתמש ברמה l עבור לוגר
-lc --log-config [f]שם קובץ: מחרוזת
השתמש בקובץ התצורה f עבור לוגר
קלט אפשרויות
פורמט קובץ קלט:
+f --read-file
קרא פורמט קובץ או ערכת נתונים (ברירת מחדל)
+fo ---read-file-only
לקרוא פורמט קובץ בלבד
-f --read-dataset
קרא ערכת נתונים ללא מטא מידע על הקובץ
תחביר העברת קלט:
-t= --read-xfer-auto
השתמש בזיהוי TS (ברירת מחדל)
-td --read-xfer-detect
התעלם מ-TS שצוין בכותרת המטא של הקובץ
-te --read-xfer-little
קרא עם VR מפורש little endian TS
-tb --read-xfer-big
קרא עם VR מפורש big endian TS
-ti --read-xfer-implicit
קרא עם VR מרומז אנדיאן קטן TS
קבצי קלט:
+sd --סריקה-ספריות
סרוק ספריות עבור קבצי קלט (dcmfile-in)
+sp --scan-pattern [p]attern: מחרוזת (רק עם --scan-directory)
דפוס להתאמת שם קובץ (תווים כלליים)
# אולי לא זמין בכל המערכות
-r --אין-חזרה
אל תחזור בתוך ספריות (ברירת מחדל)
+r --recurse
recurse בתוך ספריות שצוינו
ערכי תג ארוך:
+M --טען-הכל
טען ערכי תג ארוכים מאוד (ברירת מחדל)
-M --עומס-קצר
אל תטען ערכים ארוכים מאוד (למשל נתוני פיקסל)
+R --max-read-length [k]בתים: מספר שלם (4..4194302, ברירת מחדל: 4)
הגדר סף לערכים ארוכים ל- k kbytes
ניתוח מטא מידע על קובץ:
+ml --use-meta-length
השתמש באורך קבוצת מטא מידע של קבצים (ברירת מחדל)
-ml --התעלם-מטא-אורך
התעלם מאורך קבוצת מטא מידע של קובץ
ניתוח של תכונות באורך מוזר:
+ao --accept-odd-length
קבל תכונות אורך אי זוגי (ברירת מחדל)
+ae --הנח-אפילו-אורך
נניח שהאורך האמיתי גדול בית אחד גדול יותר
טיפול ב-VR מפורש:
+ev --use-explicit-vr
השתמש ב-VR מפורש ממערך הנתונים (ברירת מחדל)
-ev --ignore-explicit-vr
התעלם מ-VR מפורש (העדיף מילון נתונים)
טיפול ב-VR לא סטנדרטי:
+vr --treat-as-unknown
התייחס ל-VR לא סטנדרטי כלא ידוע (ברירת מחדל)
-vr --הנחה-משתמע
נסה לקרוא עם VR מרומז אנדיאן קטן TS
טיפול ברכיבי או"ם באורך לא מוגדר:
+ui --enable-cp246
קרא לא מוגדר len UN כ-VR מרומז (ברירת מחדל)
-ui --disable-cp246
קרא את undefined len UN כ-VR מפורש
טיפול ברכיבי או"ם באורך מוגדר:
-uc --retain-un
לשמור על אלמנטים כאו"ם (ברירת מחדל)
+uc --convert-un
המר ל-VR אמיתי אם ידוע
טיפול באלמנטים פרטיים באורך מקסימלי (VR מרומז):
-sq --maxlength-dict
לקרוא כפי שהוגדר במילון (ברירת מחדל)
+sq --maxlength-seq
לקרוא כרצף עם אורך לא מוגדר
טיפול בפריטי תיחום שגויים:
-rd --use-delim-items
השתמש בפריטי תיחום ממערך נתונים (ברירת מחדל)
+rd --replace-wrong-delim
להחליף פריטים שגויים ברצף/תיחום פריט
טיפול כללי בשגיאות מנתח:
+Ep --ignore-parse-errors
נסה לשחזר משגיאות ניתוח
-Ep --handle-parse-errors
לטפל בשגיאות ניתוח ולהפסיק את הניתוח (ברירת מחדל)
אפשרויות ניתוח אחרות:
+st --stop-after-elem [t]ag: "gggg,eeee" או שם המילון
להפסיק לנתח אחרי אלמנט שצוין על ידי t
תיקון נתונים אוטומטי:
+dc --enable-correction
אפשר תיקון נתונים אוטומטי (ברירת מחדל)
-dc --disable-correction
השבת את תיקון הנתונים האוטומטי
פורמט זרם סיביות של קלט מנופח:
+bd ---bitstream-deflated
צפו בזרם סיביות מנופח (ברירת מחדל)
+bz --bitstream-zlib
צפו בזרם סיביות מנופח zlib
תהליך אפשרויות
סט תווים ספציפי:
+U8 --convert-to-utf8
להמיר את כל ערכי האלמנטים המושפעים
לפי סט תווים ספציפי (0008,0005) ל-UTF-8
# דורש תמיכה מערך הכלים libiconv
תפוקה אפשרויות
הַדפָּסָה:
+L --הדפס-הכל
להדפיס ערכי תג ארוך לחלוטין
-L --הדפס-קצר
הדפס ערכי תג ארוך מקוצר (ברירת מחדל)
+T --הדפס-עץ
להדפיס מבנה היררכי כעץ פשוט
-T --הדפיס-הזחה
הדפסת מבנה היררכי עם הזחה (ברירת מחדל)
+F --print-filename
הדפס כותרת עם שם קובץ עבור כל קובץ קלט
+Fs --print-file-search
הדפס כותרת עם שם קובץ רק עבור קבצי קלט אלה
המכילים אחד מהתגים שחיפשו
מיפוי:
+ Un --map-uid-names
מפה מספרי UID ידועים לשמות (ברירת מחדל)
-Un --no-uid-names
אל תמפה מספרי UID ידועים לשמות
מצטט:
+Qn --quote-nonascii
ציטוט שאינם ASCII ותווים בקרה כסימון XML
+Qo --quote-as-octal
ציטוט שאינם ASCII ותווים בקרה כמספרים אוקטליים
-Qn --print-nonascii
להדפיס תווים שאינם ASCII ותווים בקרה (ברירת מחדל)
צֶבַע:
+C --הדפס-צבע
השתמש בקודי בריחה של ANSI עבור פלט צבעוני
# לא זמין במערכות Windows
-C --ללא צבע
אל תשתמש בקודי בריחה של ANSI (ברירת מחדל)
# לא זמין במערכות Windows
טיפול בשגיאות:
-E --עצור-בשגיאה
אל תדפיס אם הקובץ פגום (ברירת מחדל)
+E --התעלם משגיאות
נסה להדפיס גם אם הקובץ פגום
חיפוש:
+P --חיפוש [t]ag: "gggg,eeee" או שם מילון
הדפס את ה-dump הטקסטואלי של תג t
ניתן לציין אפשרות זו מספר פעמים
(ברירת מחדל: הקובץ המלא מודפס)
+s --חיפוש-הכל
להדפיס את כל המופעים של תגים שחיפשו (ברירת מחדל)
-s --חיפוש-תחילה
הדפס רק מופע ראשון של תגים שחיפשו
+p --prepend
הוסף את היררכיית הרצף לתג המודפס,
מסומן על ידי: (gggg,eeee).(gggg,eeee).*
(רק בשימוש עם --search)
-p --no-prepend
אין להוסיף היררכיה לתיוג (ברירת מחדל)
כְּתִיבָה:
+W --write-pixel [d]directory: מחרוזת
לכתוב נתוני פיקסל לקובץ raw המאוחסן ב-d
(אנדיאן קטן, שם הקובץ נוצר אוטומטית)
אורים
הוספת ספריות כפרמטר לשורת הפקודה הגיוני רק אם אפשרות --לִסְרוֹק-
ספריות ניתן גם. אם יש לבחור את הקבצים בספריות שסופקו
לפי דפוס שם ספציפי (למשל באמצעות התאמת תווים כלליים), אפשרות --סריקה-דפוס
יש להשתמש. שים לב שתבנית קובץ זו חלה רק על הקבצים בתוך
ספריות סרוקות, וכן, אם צוינו תבניות אחרות בשורת הפקודה בחוץ
מה היא --סריקה-דפוס אפשרות (למשל על מנת לבחור קבצים נוספים), אלה אינם חלים על
המדריכים שצוינו.
יומן
רמת פלט הרישום של כלי שורת הפקודה השונים והספריות הבסיסיות יכולה
יצוין על ידי המשתמש. כברירת מחדל, רק שגיאות ואזהרות נכתבות לתקן
זרם שגיאות. שימוש באפשרות --מִלוּלִי גם הודעות מידע כמו עיבוד פרטים
דווחו. אוֹפְּצִיָה --לנפות ניתן להשתמש כדי לקבל פרטים נוספים על הפעילות הפנימית,
למשל למטרות ניפוי באגים. ניתן לבחור רמות רישום אחרות באמצעות האפשרות --עֵץ-
רָמָה, --שֶׁקֶט במצב רק שגיאות קטלניות מדווחות. באירועי שגיאה כה חמורים,
הבקשה תסתיים בדרך כלל. לפרטים נוספים על רמות הרישום השונות,
ראה תיעוד של מודול 'oflog'.
במקרה שיש לכתוב את פלט הרישום לקובץ (אופציונלי עם סיבוב קובץ יומן),
ל-syslog (Unix) או לאפשרות יומן האירועים (Windows). --log-config יכול לשמש. זֶה
קובץ התצורה מאפשר גם להפנות רק הודעות מסוימות לפלט מסוים
זרם ולסינון הודעות מסוימות בהתבסס על המודול או היישום שבו הם
נוצרים. קובץ תצורה לדוגמה מסופק ב /logger.cfg.
פקודה קו
כל כלי שורת הפקודה משתמשים בסימון הבא עבור פרמטרים: סוגריים מרובעים מקיפים
ערכים אופציונליים (0-1), שלוש נקודות עוקבות מצביעות על כך שמתירים מספר ערכים
(1-n), שילוב של שניהם פירושו 0 עד n ערכים.
אפשרויות שורת הפקודה מובדלות מפרמטרים על ידי סימן '+' או '-' מוביל,
בהתאמה. בדרך כלל, הסדר והמיקום של אפשרויות שורת הפקודה הם שרירותיים (כלומר
יכול להופיע בכל מקום). עם זאת, אם האפשרויות סותרות זו את זו, המראה הימני ביותר
משמש. התנהגות זו תואמת את כללי ההערכה הסטנדרטיים של קונכיות Unix נפוצות.
בנוסף, ניתן לציין קובץ פקודה אחד או יותר באמצעות סימן '@' כתחילית ל
שם הקובץ (למשל @command.txt). ארגומנט פקודה כזה מוחלף בתוכן של
קובץ הטקסט המתאים (ריבוי רווחים מרובים מטופלים כמפריד יחיד אלא אם כן
הם מופיעים בין שתי מרכאות) לפני כל הערכה נוספת. שים לב ש
קובץ פקודה לא יכול להכיל קובץ פקודה אחר. גישה פשוטה אך יעילה זו
מאפשר לסכם שילובים נפוצים של אפשרויות/פרמטרים ונמנע ארוך ו
שורות פקודה מבלבלות (דוגמה מסופקת בקובץ /dumppat.txt).
הסביבה
השמיים dcmdump כלי השירות ינסה לטעון את מילוני הנתונים של DICOM המצוינים ב-
DCDICTPATH משתנה הסביבה. כברירת מחדל, כלומר אם DCDICTPATH משתנה הסביבה
לא מוגדר, הקובץ /dicom.dic ייטען אלא אם המילון נבנה
לתוך האפליקציה (ברירת מחדל עבור Windows).
יש להעדיף את התנהגות ברירת המחדל ואת DCDICTPATH משתנה סביבה בלבד
משמש כאשר נדרשים מילוני נתונים חלופיים. ה DCDICTPATH משתנה הסביבה
יש אותו פורמט כמו מעטפת יוניקס נתיב משתנה בכך שנקודתיים (':') מפריד
ערכים. במערכות Windows, נקודה-פסיק (';') משמשת כמפריד. מילון הנתונים
הקוד ינסה לטעון כל קובץ שצוין ב- DCDICTPATH משתנה הסביבה. זה
היא שגיאה אם לא ניתן לטעון מילון נתונים.
השתמש ב-dcmdump באינטרנט באמצעות שירותי onworks.net
