> For the complete documentation index, see [llms.txt](https://water-strategy.gitbook.io/waterstrategy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://water-strategy.gitbook.io/waterstrategy/arby/asasyat-alnmthjh/parameters/hdf5-parameter.md).

# المعلمة 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
