# عارض المسح الضوئي

يتيح لك Scan Viewer تصور وتحليل واستخراج بيانات المبنى من عمليات المسح ثلاثية الأبعاد لسحابة النقاط الملتقطة في الموقع. فهو يسد الفجوة بين الواقع المادي ونموذج المبنى الرقمي باستخدام التجزئة المدعومة بالذكاء الاصطناعي لتحديد عناصر المبنى، ومطابقتها مع كائنات BIM، وإدخالها في سير عمل الإثراء القياسي في Magma.

***

## نظرة عامة

تلتقط عمليات مسح سحابة النقاط (تنسيق E57) الواقع المادي للمبنى في لحظة زمنية محددة. يتيح لك Scan Viewer:

* استكشاف المسح بشكل ثلاثي الأبعاد.
* مراجعة العناصر المكتشفة بالذكاء الاصطناعي وتصنيفاتها.
* مقارنة الواقع الممسوح بنموذج تصميم BIM.
* تجاوز تصنيفات الذكاء الاصطناعي عند الحاجة.
* ترقية العناصر الممسوحة إلى كائنات نموذج المبنى للإثراء في سير عمل BIM.

***

## الوصول إلى Scan Viewer

يمكن الوصول إلى Scan Viewer بطريقتين:

1. من **Data Room** — انتقل إلى مجلد IFC فرعي وانقر على **فتح في Scan**.
2. من إدخال مستند المسح (المستند **2-006** على مستوى Architecture)، الذي يخزن ملف E57.

يُضمّن العارض عبر **Magma Scan Viewer SDK** ‏(`magma-scan-viewer-sdk`) كإطار iframe. يُحدّث رمز المصادقة تلقائيًا **قبل 30 ثانية من انتهاء الصلاحية**، لذلك تظل جلستك نشطة أثناء جلسات المراجعة الطويلة دون الحاجة إلى إعادة تسجيل دخول يدوي.

***

## تنسيق الملف المدعوم

| الخاصية     | القيمة                                                                     |
| ----------- | -------------------------------------------------------------------------- |
| تنسيق الملف | E57 ‏(ASTM E57 3D Imaging Data Exchange)                                   |
| التخزين     | يُخزّن ملف E57 أيضًا كمستند **2-006** على مستوى Architecture في Data Room. |

***

## التجزئة بالذكاء الاصطناعي

عند تحميل مسح، يشغّل Scan Viewer تلقائيًا التجزئة بالذكاء الاصطناعي على بيانات سحابة النقاط لاكتشاف عناصر المبنى وتصنيفها.

### أنواع العناصر المكتشفة

يحدد الذكاء الاصطناعي فئات العناصر التالية ويربطها بمستويات مبنى Magma:

| العنصر المكتشف بالذكاء الاصطناعي                 | المستوى المربوط      |
| ------------------------------------------------ | -------------------- |
| السقف، الأرضية، الجدار، العارضة، العمود، السلالم | **Structure (S)**    |
| النافذة، الباب                                   | **Architecture (A)** |
| الطاولة، الكرسي، الأريكة، خزانة الكتب            | **Filled (F) / W1**  |
| الأثاث (عام)                                     | **Wired 2 (W2)**     |
| المعدات                                          | **Wired 3 (W3)**     |

### البيانات لكل عنصر

لكل عنصر يكتشفه الذكاء الاصطناعي، تُولّد البيانات التالية وتُخزّن:

| الخاصية              | الوصف                                                                                                    |
| -------------------- | -------------------------------------------------------------------------------------------------------- |
| **درجة الثقة**       | قيمة بين 0 و1 تشير إلى مدى ثقة الذكاء الاصطناعي في تصنيفه. كلما ارتفعت كانت أكثر يقينًا.                 |
| **المركز (x, y, z)** | إحداثيات النقطة المركزية للعنصر المكتشف في الفضاء ثلاثي الأبعاد.                                         |
| **مربع الإحاطة**     | مربع الإحاطة ثلاثي الأبعاد الأدنى الذي يحتوي على العنصر.                                                 |
| **مقاييس الشكل**     | ثلاثة واصفات للشكل: **الاستواء** (مدى الانبساط)، **الاستطالة** (مدى الطول)، **الكروية** (مدى الاستدارة). |
| **عدد النقاط**       | عدد النقاط في سحابة النقاط التي تنتمي إلى هذا العنصر.                                                    |
| **رقم الغرفة**       | الغرفة التي اكتُشف فيها العنصر.                                                                          |
| **مستوى الطابق**     | الطابق الذي يقع فيه العنصر.                                                                              |
| **IFC GUID**         | إذا تطابق العنصر مع كائن BIM، يُسجّل هنا IFC GUID لذلك الكائن.                                           |

***

## مطابقة Scan مع BIM

يتضمن Scan Viewer ميزة **مطابقة Scan مع BIM** التي تحاذي عناصر المسح المكتشفة مع كائناتها المقابلة في نموذج BIM ثلاثي الأبعاد.

### المطابقة التلقائية

تُجرى المطابقة تلقائيًا باستخدام **IFC GUID**. عندما يسند اكتشاف الذكاء الاصطناعي IFC GUID لعنصر مسح، يبحث النظام عن ذلك GUID في نموذج BIM وينشئ رابطًا بين عنصر المسح المادي ونظيره الرقمي في BIM.

### المطابقة اليدوية

عندما تكون المطابقة التلقائية غير ممكنة (مثل عدم اكتشاف GUID أو كون العنصر جديدًا)، يمكنك إجراء مطابقة يدوية:

1. اختر عنصر المسح غير المطابق في العارض.
2. انقر على **المطابقة مع كائن BIM**.
3. ابحث عن كائن BIM المستهدف بالاسم أو النوع أو GUID.
4. أكّد المطابقة.

تُسجّل المطابقات اليدوية في مسار التدقيق إلى جانب المستخدم الذي أجرى المطابقة.

***

## تجاوز التصنيف

تنبؤات الذكاء الاصطناعي ليست مثالية دائمًا. تتيح ميزة **تجاوز التصنيف** لأصحاب المصلحة المصرح لهم تصحيح تصنيف مُسند بالذكاء الاصطناعي.

### كيفية تجاوز تصنيف

1. اختر العنصر الذي تريد تصحيح تصنيفه.
2. في لوحة تفاصيل العنصر، انقر على **تجاوز التصنيف**.
3. اختر نوع العنصر الصحيح من القائمة المنسدلة (مثل التغيير من "الأثاث" إلى "المعدات").
4. أدخل **ملاحظة** تشرح سبب التصحيح.
5. أكّد التجاوز.

### مسار التدقيق

يُسجّل كل تجاوز تصنيف في **مسار تدقيق** كامل يلتقط:

* تصنيف الذكاء الاصطناعي الأصلي ودرجة الثقة.
* التصنيف المصحح.
* الملاحظة المقدمة من المراجع.
* الطابع الزمني للتجاوز.
* اسم ودور صاحب المصلحة الذي أجرى التجاوز.

يضمن هذا التتبع الكامل والمساءلة لجميع التصحيحات اليدوية.

***

## مقارنة واقع Scan مقابل تصميم BIM

إحدى أقوى ميزات Scan Viewer هي القدرة على مقارنة **الواقع المادي الممسوح** مقابل **نموذج BIM المصمم**.

### كيف تعمل المقارنة

عند تحميل كل من مسح (E57) ونموذج BIM ‏(IFC) للمبنى، يطبق العارض كلتا مجموعتي البيانات فوق بعضهما. تبرز المقارنة:

* **العناصر الموجودة في BIM ولكن غير المكتشفة في المسح** — ربما مفقودة، أو لم تُركّب بعد، أو محجوبة.
* **العناصر المكتشفة في المسح ولكن غير الموجودة في BIM** — ربما عناصر جديدة، أو تغييرات غير مصرح بها، أو نتائج إيجابية خاطئة من الذكاء الاصطناعي.
* **الانحرافات الموضعية** — العناصر الموجودة في كليهما ولكنها مزاحة مكانيًا بين التصميم والواقع (مثل جدار بُني على بعد 5 سم من موضعه المصمم).

هذه المقارنة لا تقدّر بثمن من أجل:

* **تتبع تقدم البناء** — التحقق من العناصر المصممة التي رُكّبت فعليًا.
* **التحقق من الحالة المنفذة** — تأكيد أن المبنى المكتمل يطابق التصميم المعتمد.
* **تخطيط الصيانة والتجديد** — تحديد التناقضات قبل بدء العمل.

***

## ترقية عناصر Scan إلى كائنات نموذج المبنى

يمكن ترقية عناصر المسح المكتشفة والمتحقق منها إلى **كائنات نموذج المبنى**، مما يدخلها في سير عمل الإثراء القياسي لـ BIM.

### سير عمل الترقية

1. اختر عنصر مسح (أو عناصر متعددة).
2. راجع تصنيفه بالذكاء الاصطناعي وتجاوزه اختياريًا عند الحاجة.
3. انقر على **ترقية إلى كائن نموذج المبنى**.
4. يدخل العنصر سير عمل الإثراء القياسي ككائن BIM.
5. يمكن لأصحاب المصلحة الآن إثراؤه ببيانات عبر جميع أقسام البيانات الـ12 عبر معالج التهيئة في BIM 3D Viewer أو لوحة تفاصيل الكائن.

تُتتبع الكائنات المرقّاة في قسم **مساهمات القيمة** وتساهم في درجة Magma Index للمبنى بمجرد التحقق من حقول بياناتها.

***

## لوحة تفاصيل العنصر

يؤدي النقر على عنصر مكتشف في العارض إلى فتح لوحة تفاصيله:

| الخاصية          | الوصف                                                                   |
| ---------------- | ----------------------------------------------------------------------- |
| نوع العنصر       | التصنيف المُسند بالذكاء الاصطناعي أو المتجاوز.                          |
| الثقة            | درجة ثقة الذكاء الاصطناعي (0–1).                                        |
| مستوى Magma      | المستوى المُسند (S، A، W1–W5، F).                                       |
| المركز           | إحداثيات X، Y، Z.                                                       |
| مربع الإحاطة     | الأبعاد (العرض × الارتفاع × العمق).                                     |
| الاستواء         | مقياس الشكل (0–1).                                                      |
| الاستطالة        | مقياس الشكل (0–1).                                                      |
| الكروية          | مقياس الشكل (0–1).                                                      |
| عدد النقاط       | عدد نقاط المسح في هذا العنصر.                                           |
| رقم الغرفة       | الغرفة المكتشفة.                                                        |
| مستوى الطابق     | الطابق المكتشف.                                                         |
| IFC GUID         | GUID كائن BIM (إذا تطابق).                                              |
| كائن BIM المطابق | رابط إلى كائن BIM المقابل (إذا تطابق).                                  |
| سجل التجاوزات    | قائمة بتجاوزات التصنيف السابقة مع الملاحظات والطوابع الزمنية والفاعلين. |

***

## التكامل مع Data Room

ملف مسح E57 ليس قابلاً للعرض فقط في Scan Viewer — بل يُخزّن أيضًا كمستند في موقع محدد في Data Room:

* **المستند:** `2-006`
* **المستوى:** Architecture

هذا يعني أن ملف المسح يشارك في دورة حياة المستند القياسية: يمكن التحقق منه وإصداره واستبداله وسكه على البلوكتشين تمامًا مثل أي مستند آخر في Data Room. تُسجّل تجزئة مستند المسح على السلسلة أثناء سك DTT، مما يوفر سجلاً مقاومًا للعبث للواقع المادي للمبنى في وقت المسح.

***

## نصائح وأفضل الممارسات

* امسح المبنى في مراحل متعددة من البناء لتتبع التقدم والتقاط الحالات المنفذة قبل إغلاق المناطق (مثل المسح قبل أن تخفي الكسوة العناصر الإنشائية).
* راجع درجات ثقة الذكاء الاصطناعي بعناية — العناصر ذات الدرجة الأقل من **0.7** مرشحة للمراجعة اليدوية واحتمال تجاوز التصنيف.
* أدخل دائمًا ملاحظة مفصلة عند تجاوز تصنيف — هذا التوثيق قيّم لعمليات التدقيق ومراجعات الجودة المستقبلية.
* استخدم **مقارنة Scan مع BIM** قبل بدء أي مشروع تجديد أو تعديل لضمان أن نموذج BIM يعكس بدقة الحالة الحالية للمبنى.
* رقّ عناصر المسح إلى كائنات نموذج المبنى تدريجيًا — ابدأ بالعناصر الإنشائية عالية الثقة وانزل إلى المفروشات منخفضة الثقة.


---

# 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://docs.mymagma.com/magma-documentation/ar/almyzat/scan-viewer.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.