# المعلمة HDF5

## وصف عام

تقرأ هذه المعلمة بيانات المصفوفة من قاعدة بيانات PyTables HDF.

تقوم المعلمة بقراءة البيانات باستخدام واجهة مصفوفة PyTables وبالتالي لا تتطلب تحميل مجموعة البيانات بأكملها في الذاكرة. هذا مفيد لعمليات تشغيل النماذج الكبيرة. [API المرجع](https://pywr.github.io/pywr-docs/master/api/generated/pywr.parameters.TablesArrayParameter.html#pywr.parameters.TablesArrayParameter)

من خلال تخزين ملفات HDF5 بالتنسيق «الثابت»، يمكن للمستخدمين تحقيق سرعات وصول مثالية للبيانات، مما يجعل HDF5 أداة فعالة لسيناريوهات PyWR التي تستخدم DataFrames كمعلمات، حيث يعد استرداد البيانات السريع أمرًا بالغ الأهمية. تتم قراءة ملفات HDF5 كقاموس، حيث يمثل كل مفتاح إطار بيانات الباندا. على سبيل المثال، قد تحتوي بنية ملف inflows.h5 على ثلاثة مفاتيح، يمثل كل منها نهرًا مختلفًا. يحتوي كل مفتاح على ثلاث سلاسل زمنية يمكن تخصيصها لسيناريو Pywr بالحجم 3.

في حالة استخدام إطار بيانات ملف h5 لتشغيل سيناريوهات pywr، يرجى الرجوع إلى [قسم سيناريوهات pywr](/waterstrategy/modeling-basics/scenarios/pywr-scenarios.md) من أجل تفعيل هذه الميزة

**ملاحظة:** يجب أن يتطابق حجم سيناريوهات pywr مع عدد المفاتيح في ملف h5

## السمات

<table><thead><tr><th width="158">الاسم</th><th width="409">وصف</th><th>مطلوب</th></tr></thead><tbody><tr><td>ملف h5</td><td>مقبض ملف الجداول أو اسم الملف الذي سيتم إرفاق كائنات CarRay به. إذا تم إعطاء اسم ملف، فسيقوم الكائن بفتح مقابض الملفات وإغلاقها.</td><td>نعم</td></tr><tr><td>عقدة</td><td>اسم العقدة في قاعدة بيانات الجداول لقراءة البيانات منها</td><td>نعم</td></tr><tr><td>حيث</td><td>مسار لقراءة العقدة منه</td><td>نعم</td></tr><tr><td>مشهد</td><td>سيناريو لاستخدامه كفهرس ثانٍ في المصفوفة</td><td>نعم</td></tr></tbody></table>

## مثال

<figure><img src="/files/kqDO3JUntlhUvPO9Z3Ab" alt=""><figcaption><p>تدفقات الهيكل. h5</p></figcaption></figure>

«جسون» { «مفتاح»: «نهر كاتشمينت 1"، «السيناريو»: «تغير المناخ»، «النوع»: «معلمة إطار البيانات»، «عنوان URL»: «inflows.h5"، «index\_col»: «الخطوة الزمنية»، «تواريخ التحليل»: صحيح }

```
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://water-strategy.gitbook.io/waterstrategy/arby/asasyat-alnmthjh/parameters/hdf5-parameter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.