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

برنامج:

اسم

ncgen3 - من ملف CDL، قم بإنشاء ملف netCDF classic أو ملف كلاسيكي 64 بت، أو برنامج C، أو
برنامج فورتران

موجز

ncgen3 [-b] [-c] [-f] [-k kind_of_file] [-x] [-n] [-o netcdf_filename] ملف_المدخلات

الوصف

ncgen3 ينشئ إما ملف netCDF، أو كود مصدر C أو Fortran لإنشاء netCDF
ملف. الإدخال إلى ncgen3 هو وصف لملف netCDF بلغة صغيرة تعرف باسم
CDL (لغة نموذج البيانات المشتركة للشبكة)، الموضحة أدناه. إذا لم يتم تحديد أي خيارات في
استدعاء ncgen3، يقوم فقط بالتحقق من بناء جملة ملف CDL للإدخال ، مما ينتج عنه خطأ
رسائل عن أي انتهاكات لبناء جملة CDL. يمكن استخدام خيارات أخرى لإنشاء ملف
ملف netCDF المقابل ، لإنشاء برنامج C يستخدم واجهة netCDF C إلى
قم بإنشاء ملف netCDF ، أو لإنشاء برنامج Fortran يستخدم netCDF Fortran
واجهة لإنشاء نفس ملف netCDF.

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

OPTIONS

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

-c توليد C كود المصدر الذي سينشئ ملف netCDF يطابق netCDF
تخصيص. تمت كتابة كود المصدر C إلى الإخراج القياسي.

-f توليد فورتران كود المصدر الذي سينشئ ملف netCDF يطابق netCDF
تخصيص. تمت كتابة كود مصدر فورتران وفقًا للإخراج القياسي.

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

-k kind_of_file
يؤدي استخدام -k2 أو -k "إزاحة 64 بت" إلى تحديد الملف (أو البرنامج) الذي تم إنشاؤه
استخدم الإصدار 2 من التنسيق الذي يستخدم إزاحة ملف 64 بت. الافتراضي هو الاستخدام
الإصدار 1 ("الكلاسيكي") مع إزاحة ملف 32 بت، على الرغم من أن هذا يحد من
حجم ملف netCDF والمتغيرات والسجلات إلى الأحجام التي يدعمها ملف
الشكل الكلاسيكي. (سيدعم NetCDF-4 أنواعًا إضافية من ملفات netCDF،
"netCDF-4" و"netCDF-4 classic model".) ملاحظة: -v يُقبل أيضًا على أنه يعني
نفس الشيء مثل -k للتوافق مع الإصدارات السابقة، ولكن يفضل -k، لمطابقة
خيار ncdump المقابل.

-x لا تقم بتهيئة البيانات بقيم التعبئة. يمكن أن يؤدي ذلك إلى تسريع إنشاء netCDF كبير
الملفات بشكل كبير، لكنه يحاول لاحقًا قراءة البيانات غير المكتوبة من الملف الذي تم إنشاؤه
لن يكون من السهل اكتشافها.

أمثلة

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

ncgen3 foo.cdl

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

ncgen3 -o x.nc foo.cdl

من ملف CDL `foo.cdl، قم بإنشاء برنامج C يحتوي على وظيفة netCDF
الدعوات اللازمة لإنشاء ملف netCDF ثنائي مكافئ يسمى `x.nc':

ncgen3 -c -o x.nc foo.cdl

الاستعمال

CDL بناء الجملة نبذة عامة
يوجد أدناه مثال على بناء جملة CDL ، يصف ملف netCDF بعدة أبعاد مسماة
(خطوط الطول والعرض والوقت) ، المتغيرات (Z ، t ، p ، rh ، lat ، lon ، الوقت) ، السمات المتغيرة (الوحدات ،
long_name و valid_range و _FillValue) وبعض البيانات. الكلمات الرئيسية CDL بخط عريض. (هذا
المثال المقصود لتوضيح بناء الجملة ؛ سيكون ملف CDL الحقيقي أكثر اكتمالاً
مجموعة من السمات بحيث تكون البيانات أكثر وصفًا ذاتيًا بشكل كامل.)

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

الأبعاد:
خط الطول = 10 ، خط الطول = 5 ، الوقت = غير محدود ;

المتغيرات:
التداول الطويل خط الطول (خط الطول) ، خط الطول (خط الطول) ، الوقت (الوقت) ؛
الطفو Z (الوقت ، خطوط الطول ، الطول) ، t (الوقت ، خطوط الطول ، الطول) ؛
مضاعفة ع (الوقت ، خط الطول ، خط الطول) ؛
التداول الطويل rh (time، lat، lon) ؛

// سمات متغيرة
خط العرض: long_name = "خط العرض" ؛
خط العرض: الوحدات = "degrees_north" ؛
lon: long_name = "longitude" ؛
lon: الوحدات = "الدرجات_ الشرقية" ؛
الوقت: الوحدات = "الثواني منذ 1992-1-1 00:00:00" ؛
Z: الوحدات = "عدادات الجهد الجغرافي" ؛
Z: valid_range = 0. ، 5000 .؛
p: _FillValue = -9999 .؛
rh: _FillValue = -1 ؛

البيانات:
خط العرض = 0 ، 10 ، 20 ، 30 ، 40 ، 50 ، 60 ، 70 ، 80 ، 90 ؛
lon = -140 ، -118 ، -96 ، -84 ، -52 ؛
}

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

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

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

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

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

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

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

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

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

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

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

يمكن أن تحتوي السراويل القصيرة على قيم تتراوح بين -32768 و 32767. ncgen3 تحويل في صفقات تصريحات ل
في صفقات التصريحات في الناتج C كود وغير قياسي عدد صحيح * 2 إعلان في
إخراج كود فورتران.

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

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

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

CDL ثابت
قد تكون الثوابت المعينة للسمات أو المتغيرات من أي من أنواع netCDF الأساسية.
يشبه بناء جملة الثوابت بناء جملة 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
لاحظ أن مصفوفة أحرف netCDF "a" تناسب متغير مكون من عنصر واحد ، نظرًا لأن no
يُفترض إنهاء الحرف NULL. ومع ذلك ، فإن البايت الصفري في صفيف الأحرف هو
يفسر على أنه نهاية الشخصيات المهمة بواسطة ncdump البرنامج ، بعد
اتفاقية ج. لذلك ، يجب ألا يتم تضمين بايت NULL في سلسلة أحرف ما لم يكن
في النهاية: استخدم ملف بايت نوع البيانات بدلاً من ذلك لصفائف البايت التي تحتوي على صفر بايت.
NetCDF و 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 د

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