h5dump - מקוון בענן

תָכְנִית:

שֵׁם

h5dump - מציג תוכן קובץ HDF5.

תַקצִיר

h5dump [OPTIONS] קובץ

תיאור

h5dump מאפשר למשתמש לבחון את התוכן של קובץ HDF5 ולזרוק את התוכן הזה,
בצורה קריא אנושית, לקובץ ASCII.

h5dump משליך תוכן קובץ HDF5 לפלט סטנדרטי. זה יכול להציג את התוכן של
קובץ HDF5 שלם או אובייקטים נבחרים, שיכולים להיות קבוצות, מערכי נתונים, תת-קבוצה של א
מערך נתונים, קישורים, תכונות או סוגי נתונים.

האפשרות --header מציגה מידע על כותרת האובייקט בלבד.

שמות הם השמות המוחלטים של האובייקטים. h5dump מציג אובייקטים בסדר זהה לזה
סדר הפיקוד. אם שם לא מתחיל בקו נטוי, h5dump מתחיל לחפש את ה-
אובייקט שצוין החל מקבוצת השורש.

אם אובייקט מקושר קשה עם מספר שמות, h5dump מציג את תוכן האובייקט
בהתרחשות הראשונה. רק מידע הקישור מוצג בהתרחשויות מאוחרות יותר.

h5dump מקצה שם לכל סוג נתונים ללא שם בצורה של #oid1:oid2, כאשר oid1 ו-
oid2 הם מזהי האובייקטים שהוקצו על ידי הספרייה. הסוגים ללא שם מוצגים
בתוך קבוצת השורש.

סוגי נתונים מוצגים עם שמות סוגים סטנדרטיים. לדוגמה, אם נוצר מערך נתונים
עם סוג H5T_NATIVE_INT ושם הסוג הסטנדרטי עבור מספר שלם באותו מחשב הוא
H5T_STD_I32BE, h5dump מציג את H5T_STD_I32BE כסוג מערך הנתונים.

h5dump יכול גם לזרוק תת-קבוצה של מערך נתונים. תכונה זו פועלת באותו אופן כמו
hyperslabs ב-HDF5; הפרמטרים המצוינים בשורת הפקודה מועברים לפונקציה
H5Sselect_hyperslab והבחירה שהתקבלה מוצגת.

פלט h5dump מתואר בפירוט ב-DDL עבור HDF5, תיאור הנתונים
מסמך שפה.

הערה: אסור לציין מספר תכונות, מערכי נתונים, סוגי נתונים, קבוצות,
או קישורים רכים עם דגל אחד. לדוגמה, לא ניתן להוציא את הפקודה
שגוי: h5dump -a /attr1 /attr2 foo.h5
כדי להציג גם /attr1 וגם /attr2. יש להוציא את הפקודה הבאה:
נכון: h5dump -a /attr1 -a /attr2 foo.h5

אפשר לבחור את מנהל ההתקן של הקובץ שבאמצעותו לפתוח את קובץ HDF5 על ידי שימוש ב-
אפשרות שורת הפקודה --filedriver (-f). ערכים מקובלים עבור האפשרות --filedriver הם:
"sec2", "משפחה", "פיצול", "רב" ו"זרם". אם לא צוין דגל מנהל הקובץ,
אז הקובץ ייפתח עם כל נהג בתורו ובסדר שצוין לעיל
עד שנהג אחד יצליח לפתוח את הקובץ.

XML תפוקה

עם האפשרות --xml, h5dump מייצר פלט XML. פלט זה מכיל שלם
תיאור הקובץ, מסומן ב-XML. ה-XML תואם את סוג המסמך HDF5
הגדרה (DTD) זמינה ב http://hdf.ncsa.uiuc.edu/DTDs/HDF5-File.dtd.

פלט ה-XML מתאים לשימוש עם כלים אחרים, כולל HDF5 Java Tools.

אפשרויות

-h or - עזרה הדפס הודעת שימוש וצא.

-B or --בלוק אתחול הדפס את התוכן של בלוק האתחול. (אפשרות זו עדיין לא קיימת
מוטמע.)

-H or --כּוֹתֶרֶת הדפס את הכותרת בלבד; לא מוצגים נתונים.

-A הדפס את הכותרת והערך של התכונות; נתונים של מערכי נתונים אינם מוצגים.

-i or --אובייקט-מזהים הדפס את מזהי האובייקט.

-r or --חוּט הדפס מערכי נתונים של מספר שלם של 1 בתים כ-ASCII.

-V or --גִרְסָה הדפס מספר גרסה וצא.

-a P or --תכונה=P הדפס את התכונה שצוינה.

-d P or --dataset=P הדפס את מערך הנתונים שצוין.

-f D or --filedriver=D ציין עם איזה דרייבר לפתוח את הקובץ.

-g P or --group=P הדפס את הקבוצה שצוינה ואת כל החברים.

-l P or --soft-link=P הדפס את הערכים של הקישור הרך שצוין.

-o F or --output=F פלט נתונים גולמיים לקובץ F.

-t T or --datatype=T הדפס את סוג הנתונים שצוין בשם.

-w N or --width=N הגדר את מספר עמודות הפלט.

-x or --xml פלט XML באמצעות סכימת XML (ברירת מחדל) במקום DDL.

-u or --use-dtd פלט XML באמצעות XML DTD במקום DDL.

-D U or --xml-dtd=U בפלט XML, עיין ב-DTD או בסכימה ב-U במקום ב-
ברירת המחדל של סכימת/DTD.

-X S or --xml-dns=S בפלט XML, (XML Schema) השתמש בשמות מתאימים ב-XML: ":": לא
מרחב שמות, ברירת מחדל: "hdf5:"

-s L or --start=L קיזוז של תחילת בחירת הגדרות משנה. ברירת מחדל: תחילת ה-
מערך נתונים.

-S L or --stride=L צעדי Hyperslab. ברירת מחדל: 1 בכל הממדים.

-c L or --ספירה=L מספר הבלוקים שיש לכלול בבחירה.

-k L or --block=L גודל הבלוק ב-hyperslab. ברירת מחדל: 1 בכל הממדים.

-- ציין שכל הארגומנטים הבאים אינם אופציות. למשל, כדי לזרוק קובץ בשם
`-f', השתמש ב-h5dump -- -f.

פילה התיק שייבדק.

פרמטרי האפשרויות המפורטים לעיל מוגדרים כדלקמן:

D באיזה מנהל הקובץ להשתמש בפתיחת הקובץ. ערכים מקובלים הם "sec2",
"משפחה", "פיצול", "רב" ו"זרם". ללא מנהל הקובץ דגל את הקובץ
ייפתח עם כל נהג בתורו ובסדר המפורט לעיל עד לאחד
מנהל ההתקן מצליח לפתוח את הקובץ.

P הנתיב המלא מקבוצת השורש לאובייקט

T שם סוג הנתונים

F שם קובץ

N מספר שלם הגדול מ-1

L רשימה של מספרים שלמים, שמספרם שווה למספר הממדים ב-
מרחב הנתונים נמצא בשאילתה

U URI (כפי שמוגדר ב-[IETF RFC 2396], מעודכן על-ידי [IETF RFC 2732]) המתייחס ל
ה-DTD שישמש לאימות ה-XML

פרמטרי משנה יכולים לבוא לידי ביטוי גם בצורה קומפקטית נוחה, כדלקמן:
--dataset="/foo/mydataset[START;STRIDE;COUNT;BLOCK]"

כל נקודות פסיק (;) נדרשות, גם כאשר לא צוין ערך פרמטר. מתי
לא צוין, נעשה שימוש בערכי ברירת המחדל של פרמטרים.

דוגמאות

1. השלכת הקבוצה /GroupFoo/GroupBar בקובץ quux.h5:
h5dump -g /GroupFoo/GroupBar quux.h5

2. השלכת מערך הנתונים Fnord בקבוצה /GroupFoo/GroupBar בקובץ quux.h5:
h5dump -d /GroupFoo/GroupBar/Fnord quux.h5

3. הטלת מטא-נתונים של התכונה של מערך הנתונים Fnord שנמצא בקבוצה
/GroupFoo/GroupBar בקובץ quux.h5:
h5dump -a /GroupFoo/GroupBar/Fnord/metadata quux.h5

4. השלכת המטא נתונים של התכונה שהיא תכונה של קבוצת השורש בקובץ
quux.h5:
h5dump -a /metadata quux.h5

5. הפקת רשימת XML של הקובץ bobo.h5:
h5dump --xml bobo.h5 > bobo.h5.xml

6. הטלת תת-קבוצה של מערך הנתונים /GroupFoo/databar/ בקובץ quux.h5
h5dump -d /GroupFoo/databar --start="1,1" --stride="2,3" --count="3,19"
--block="1,1" quux.h5

7. אותה דוגמה באמצעות הטופס הקצר לציון פרמטרי הגדרות המשנה:
h5dump -d "/GroupFoo/databar[1,1;2,3;3,19;1,1]" quux.h5

נוֹכְחִי סטָטוּס

הגרסה הנוכחית של h5dump מציגה את המידע הבא:
* קבוצה
o תכונת קבוצה (ראה תכונה)
o חבר בקבוצה
* מערך נתונים
o תכונת מערך נתונים (ראה תכונה)
o סוג מערך הנתונים (ראה סוג נתונים)
o מרחב נתונים (ראה מרחב נתונים)
o נתוני מערך נתונים
* תכונה
o סוג תכונה (ראה סוג נתונים)
o מרחב תכונה (ראה מרחב נתונים)
o נתוני תכונה
* סוג מידע
o סוג מספר שלם
- H5T_STD_I8BE, H5T_STD_I8LE, H5T_STD_I16BE, ...
o סוג נקודה צפה
- H5T_IEEE_F32BE, H5T_IEEE_F32LE, H5T_IEEE_F64BE, ...
o סוג מחרוזת
o סוג מורכב
- שם, ללא שם וסוג תרכובת חולפת - מספר שלם, צף או
איבר מסוג מחרוזת
o סוגים אטומים
o סוג הפניה
- הפניות לאובייקט
- אזורי נתונים
o סוג enum
o סוגי נתונים באורך משתנה
- סוגי אטומים בלבד
- מערך סקלארי או חד מימדי של סוגי אורך משתנים
נתמך
* מרחב נתונים
o מרחב סקלארי ופשוט
* קישור רך
* קישור קשה
* זיהוי לולאות

השתמש ב-h5dump באינטרנט באמצעות שירותי onworks.net