mincgen - عبر الإنترنت في السحابة

برنامج:

اسم

mincgen - إنشاء ملف MINC من ملف CDL.

موجز

مينكجين [-b] [-n] [-o minc_filename] ملف_المدخلات

الوصف

com.mincgen ينشئ ملف MINC. الإدخال إلى com.mincgen هو وصف لملف MINC في ملف
لغة صغيرة تُعرف باسم CDL (لغة نموذج البيانات المشتركة للشبكة)، الموضحة أدناه. إذا لا
يتم تحديد الخيارات في الاستدعاء com.mincgen، فهو يتحقق فقط من بناء جملة CDL للإدخال
ملف، مما يؤدي إلى ظهور رسائل خطأ لأية انتهاكات لبناء جملة CDL. يمكن أن تكون الخيارات الأخرى
يستخدم لإنشاء ملف MINC المقابل.

com.mincgen يمكن استخدامها مع البرنامج المصاحب com.mincdump لإجراء بعض العمليات البسيطة
على ملفات MINC. على سبيل المثال، لإعادة تسمية أحد الأبعاد في ملف MINC، استخدم com.mincdump للحصول على
إصدار CDL من ملف MINC، قم بتحرير ملف CDL لتغيير اسم الأبعاد، و
تستخدم com.mincgen لإنشاء ملف MINC المقابل من ملف CDL المحرر.

OPTIONS

-b قم بإنشاء ملف MINC (ثنائي). إذا -o الخيار غائب، وسوف اسم الملف الافتراضي
سيتم إنشاؤها من اسم MINC (المحدد بعد netcdf or hdf5 الكلمة الرئيسية في
الإدخال) عن طريق إلحاق الامتداد ".mnc". إذا كان الملف موجودًا بالفعل بامتداد
الاسم المحدد ، سيتم الكتابة فوقه.

-o minc_filename
اسم الملف الثنائي MINC الذي تم إنشاؤه. إذا تم تحديد هذا الخيار، فإنه يعني ضمنا
"-b". (هذا الخيار ضروري لأنه لا يمكن كتابة ملفات MINC
مباشرة إلى الإخراج القياسي، حيث لا يمكن البحث عن الإخراج القياسي.)

أمثلة

تحقق من صيغة ملف CDL ``foo.cdl':

مينكجين foo.cdl

من ملف CDL `foo.cdl'، قم بإنشاء ملف MINC ثنائي مكافئ باسم 'x.mnc':

mincgen -o x.mnc foo.cdl

الاستعمال

CDL بناء الجملة نبذة عامة
يوجد أدناه مثال على بناء جملة CDL، يصف ملف MINC بأبعاد مسماة متعددة
(xspace وyspace وzspace)، والمتغيرات (zspace، والصورة)، والسمات المتغيرة (valid_range،
نوع الإشارة) وبعض البيانات. الكلمات الرئيسية لـ CDL مكتوبة بالخط العريض. (هذا المثال يهدف إلى
توضيح بناء الجملة. سيكون لملف CDL الحقيقي مجموعة أكثر اكتمالاً من السمات
أن البيانات ستكون أكثر وصفًا ذاتيًا بشكل كامل.)

netcdf foo { // مثال لمواصفات MINC في CDL

الأبعاد:
سبيس = 8؛
يسبيس = 8؛
زسباس = 5؛

المتغيرات:
الطفو xspace;
الطفو yspace;
الطفو zspace(zspace);
في صفقات image(zspace,yspace,xspace);
مضاعفة صورة دقيقة (zspace)
مضاعفة صورة ماكس (zspace)

// سمات متغيرة
الصورة:valid_range = 0,5؛
البيانات:
image-min = -1,-1,-1,-1,-1;
الصورة القصوى = 1,1,1,1,1;
الصورة =
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2
2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3
5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5
5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5.
زسباس = 0,2,3.5,7,10؛
}

يتم إنهاء كافة عبارات CDL بفاصلة منقوطة. يمكن استخدام المسافات وعلامات التبويب والأسطر الجديدة
بحرية لسهولة القراءة. قد تتبع التعليقات الأحرف "//" في أي سطر.

يتكون وصف CDL من ثلاثة أجزاء اختيارية: الأبعاد, المتغيراتو البيانات,
تبدأ بالكلمة الرئيسية أبعاد:, المتغيرات:و البيانات، على التوالى. المتغير
قد يحتوي جزء متغير الإعلانات و السمة تعيينات.

مينك بعد يستخدم لتحديد شكل واحد أو أكثر من الأبعاد المتعددة
المتغيرات الموجودة في ملف MINC. البعد MINC له اسم وحجم وربما
عدة صفات أخرى.

A متغير يمثل مصفوفة متعددة الأبعاد من القيم من نفس النوع. المتغير له
اسم ونوع بيانات وشكل موصوف في قائمة أبعاده. يجوز لكل متغير
أيضا مرتبطة سمات (انظر أدناه) بالإضافة إلى قيم البيانات. الاسم ونوع البيانات
وشكل المتغير محدد بإعلانه في متغير قسم من CDL
وصف. قد يكون للمتغير نفس الاسم كبعد ؛ من خلال الاتفاقية مثل أ
المتغير أحادي البعد ويحتوي على إحداثيات البعد الذي يسميه.
لا تحتاج الأبعاد إلى متغيرات مقابلة.

صافيCDF السمة يحتوي على معلومات حول متغير netCDF أو حول netCDF بالكامل
مجموعة البيانات. يتم استخدام السمات لتحديد خصائص مثل الوحدات والقيم الخاصة والحد الأقصى
والحد الأدنى من القيم الصالحة وعوامل القياس والإزاحات والمعلمات. معلومات السمة
يتم تمثيله بقيم مفردة أو صفائف من القيم. على سبيل المثال ، "الوحدات" هي سمة
ممثلة بمصفوفة أحرف مثل "مئوية". السمة لها علاقة
متغير واسم ونوع بيانات وطول وقيمة. على عكس المتغيرات التي هي
المقصود بالبيانات ، السمات مخصصة للبيانات الوصفية (بيانات حول البيانات).

في CDL ، يتم تحديد سمة بواسطة متغير واسم سمة مفصولة بـ ":". هو - هي
من الممكن التعيين شامل السمات غير المرتبطة بأي متغير للملف بتنسيق a
بالكامل باستخدام `:' قبل اسم السمة. نوع بيانات السمة في CDL هو
مشتق من نوع القيمة المسندة إليه. طول السمة هو
عدد قيم البيانات المخصصة لها ، أو عدد الأحرف في سلسلة الأحرف
المخصصة لها. يتم تعيين قيم متعددة إلى سمات غير شخصية عن طريق الفصل
القيم بالفاصلات. يجب أن تكون جميع القيم المعينة لسمة ما من نفس النوع.

يجب أن تبدأ أسماء أبعاد CDL والمتغيرات والسمات بحرف أبجدي
أو "_" ، وقد تكون الأحرف اللاحقة أبجدية رقمية أو "_" أو "-".

اختياري البيانات قسم مواصفات CDL هو المكان الذي يمكن تهيئة المتغيرات فيه.
بناء جملة التهيئة بسيط: اسم متغير، وعلامة يساوي، وفاصلة.
تم إنهاء قائمة محددة من الثوابت (ربما مفصولة بمسافات وعلامات تبويب وأسطر جديدة).
مع فاصلة منقوطة. بالنسبة للمصفوفات متعددة الأبعاد، يختلف البعد الأخير بشكل أسرع. هكذا
يتم استخدام ترتيب الصفوف بدلاً من ترتيب الأعمدة في المصفوفات. إذا تم توفير قيم أقل
مما هو مطلوب لملء متغير، يتم توسيعه باستخدام "قيمة تعبئة" تعتمد على النوع،
والتي يمكن تجاوزها عن طريق توفير قيمة لسمة متغيرة مميزة مسماة
`_قيمة التعبئة'. لا يلزم أن تتطابق أنواع الثوابت مع النوع المعلن للمتغير؛
على سبيل المثال، تتم عمليات الإكراه لتحويل الأعداد الصحيحة إلى نقطة عائمة. الثابت `_'
يمكن استخدامها لتعيين قيمة التعبئة للمتغير.

بدائي البيانات الأنواع
دبابة الأحرف
بايت البيانات 8 بت
في صفقات 16 بت توقيع الأعداد الصحيحة
التداول الطويل 32 بت توقيع الأعداد الصحيحة
مادبا (متوافق مع التداول الطويل)
الطفو نقطة عائمة أحادية الدقة IEEE (32 بت)
حقيقي (متوافق مع الطفو)
مضاعفة نقطة عائمة مزدوجة الدقة IEEE (64 بت)

باستثناء نوع البيانات المضافة بايت ونقص غير موقعة، CDL يدعم نفس الشيء
أنواع البيانات البدائية مثل C. أسماء أنواع البيانات الأولية كلمات محجوزة في
CDL ، لذلك يجب ألا تكون أسماء المتغيرات والأبعاد والسمات أسماء أنواع. في
التعريفات ، يمكن تحديد أسماء الأنواع إما بأحرف كبيرة أو صغيرة.

تختلف البايت عن الأحرف من حيث أنها تهدف إلى الاحتفاظ بثمانية بتات كاملة من البيانات ،
والبايت الصفري ليس له أهمية خاصة ، كما هو الحال بالنسبة لبيانات الأحرف.

يمكن أن تحتوي السراويل القصيرة على قيم تتراوح بين -32768 و 32767.

يمكن أن تحتفظ العقود الطويلة بقيم بين -2147483648 و 2147483647. مادبا و عدد صحيح يتم قبولها على أنها
مرادفات ل التداول الطويل في إعلانات CDL. الآن بعد أن أصبحت هناك منصات ذات 64 بت
تمثيلات لـ C longs، قد يكون من الأفضل استخدام مادبا مرادف لتجنب الالتباس.

يمكن أن تحتوي العوامات على قيم بين حوالي -3.4 + 38 و 3.4 + 38. تمثيلهم الخارجي
كأرقام فاصلة عائمة ذات دقة مفردة تم تسويتها بواسطة IEEE 32 بت. حقيقي تم قبوله باعتباره أ
مرادف ل الطفو في إعلانات CDL.

يمكن للأزواج الاحتفاظ بقيم تتراوح بين -1.7 + 308 و 1.7 + 308 تقريبًا. تمثيلهم الخارجي
هي بمثابة أرقام فاصلة عائمة ذات دقة مزدوجة قياسية IEEE 64 بت.

CDL ثابت
قد تكون الثوابت المخصصة للسمات أو المتغيرات من أي من أنواع MINC الأساسية. ال
بناء جملة الثوابت يشبه بناء جملة C، باستثناء أنه يجب إلحاق لاحقات النوع
السراويل القصيرة والعوامات لتمييزها عن السراويل الطويلة والمزدوجة.

A بايت يتم تمثيل الثابت بواسطة حرف واحد أو تسلسل هروب متعدد الأحرف
مرفقة بعلامات اقتباس مفردة. على سبيل المثال،
"أ" // ASCII "أ"
"\ 0" // بايت صفر
'\ n' // حرف سطر جديد من ASCII
"\ 33" // حرف إلغاء ASCII (33 ثمانيًا)
'x2b' // ASCII plus (2b ست عشري)
'377' // 377 ثماني = 255 رقم عشري ، بخلاف ASCII

ثوابت الحرف محاطة بعلامات اقتباس مزدوجة. يمكن تمثيل مصفوفة الأحرف
كسلسلة محاطة بعلامات اقتباس مزدوجة. يتم تكريم اصطلاحات هروب سلسلة C المعتادة.
مثلا
"أ" // ASCII "أ"
"سطرين \ n \ n" // سلسلة مكونة من 10 أحرف مع سطرين جديدين مضمنين
"a bell: \ 007" // سلسلة تحتوي على جرس ASCII
لاحظ أن مصفوفة الأحرف "a" يمكن احتواؤها في متغير مكون من عنصر واحد، حيث لا
يُفترض إنهاء الحرف NULL. ومع ذلك ، فإن البايت الصفري في صفيف الأحرف هو
يفسر على أنه نهاية الشخصيات المهمة بواسطة com.mincdump برنامج، متابعة
اتفاقية C. ولذلك، يجب ألا يتم تضمين بايت NULL في سلسلة أحرف
إلا في النهاية: استخدم بايت نوع البيانات بدلاً من ذلك لصفائف البايت التي تحتوي على الصفر
بايت. لا تحتوي MINC وCDL على نوع سلسلة، ولكن فقط صفائف أحرف ذات طول ثابت، والتي قد تكون كذلك
تكون متعددة الأبعاد.

في صفقات ثوابت الأعداد الصحيحة مخصصة لتمثيل كميات موقعة ذات 16 بت. الاستمارة
من في صفقات الثابت هو ثابت عدد صحيح مع ملحق "s" أو "S". اذا كان في صفقات
يبدأ الثابت بـ "0" ، يتم تفسيره على أنه ثماني ، باستثناء أنه إذا بدأ بـ "0 x" ،
يتم تفسيره على أنه ثابت سداسي عشري. على سبيل المثال:
-2 ثانية // قصير -2
0123 ثانية // ثماني
0x7ffs // سداسي عشري

طويل ثوابت الأعداد الصحيحة مخصصة لتمثيل كميات موقعة ذات 32 بت. الاستمارة
من التداول الطويل الثابت هو ثابت عدد صحيح عادي ، على الرغم من أنه من المقبول إلحاق
اختياري "l" أو "L". اذا كان التداول الطويل يبدأ الثابت بـ "0" ، ويتم تفسيره على أنه ثماني ،
فيما عدا أنه إذا بدأ بـ "0x" ، يتم تفسيره على أنه ثابت سداسي عشري. أمثلة
من صالح التداول الطويل الثوابت تشمل:
-2
1234567890L
0123 // ثماني
0x7ff // سداسي عشري

ثوابت الفاصلة العائمة من النوع الطفو مناسبة لتمثيل النقطة العائمة
البيانات بحوالي سبعة أرقام معنوية من الدقة. شكل أ الطفو ثابت هو
هو نفسه ثابت النقطة العائمة C مع ملحق f أو F. على سبيل المثال
فيما يلي كلها مقبولة الطفو الثوابت:
-2.0 و
3.14159265358979f // سيتم اقتطاعها بدقة أقل
xnumx.f

ثوابت الفاصلة العائمة من النوع مضاعفة مناسبة لتمثيل النقطة العائمة
البيانات بحوالي ستة عشر رقما دقيقا. شكل أ مضاعفة ثابت هو
هو نفسه ثابت النقطة العائمة C. يمكن إلحاق حرف اختياري "d" أو "D". ل
مثال ما يلي كلها مقبولة مضاعفة الثوابت:
-2.0
3.141592653589793
1.0e-20
1 د

استخدم mincgen عبر الإنترنت باستخدام خدمات onworks.net