10. حاشیه نویسی

ساخت وبلاگ

برچسب زدن صریح و حاشیه نویسی مقادیر داده خاص اغلب یک عنصر مهم در تجسم و تجزیه و تحلیل داده ها است. Paraview مکانیسم های مختلفی را برای فعال کردن حاشیه نویسی در ارائه ها از متن شناور رایگان ارائه شده در کنار سایر عناصر بصری در نمای ارائه به مقادیر داده های مرتبط با نقاط خاص یا سلول ها فراهم می کند.

10. 1. منابع حاشیه نویسی

Several types of text annotations can be added through the Sources>منوی الفبایی. متن از این منابع در بالای عناصر سه بعدی در نمای رندر ترسیم شده است. کلیه منابع حاشیه نویسی برخی از خصوصیات مشترک را در قسمت نمایش صفحه Properties به اشتراک می گذارند. این موارد شامل خواص قلم مانند قلم برای استفاده ، اندازه متن ، رنگ آن ، کدورت و توجیه آن و همچنین اثرات متنی است که از جمله جسورانه ، ایتالیایی یا سایه دار استفاده می شود.

../_images/FontProperties.png

شکل 10. 1 کنترل دارایی قلم در منابع حاشیه نویسی و فیلترها.

سه قلم در Paraview وجود دارد: Arial ، Courier و Times. همچنین می توانید با انتخاب ورود پرونده در منوی بازشو در زیر خصوصیات قلم و کلیک بر روی آن ، یک پرونده قلم TrueType دلخواه (*. ttf) تهیه کنید. دکمه سمت راست قسمت متن FONT File. یک گفتگوی انتخاب پرونده به شما امکان می دهد یک پرونده فونت را از سیستم فایل که Paraview (یا PvPython) در آن اجرا می شود ، انتخاب کنید.

ویژگی های صفحه نمایش باقی مانده که در آن متن در نمای رندر قرار می گیرد کنترل می کند. دو حالت برای قرارگیری وجود دارد ، یکی که از موقعیت های از پیش تعریف شده نسبت به نمای رندر استفاده می کند ، و دیگری که امکان قرار دادن تعاملی دلخواه را در نمای رندر فراهم می کند. حالت اول هنگام انتخاب کادر انتخاب Window Window ، فعال است. این امکان را فراهم می کند که حاشیه نویسی در یکی از چهار گوشه نمای رندر یا به صورت افقی در بالا یا پایین نمای رندر قرار گیرد. دکمه هایی با نمادهای نمایانگر مکان در مرورگر خط لوله نشان داده شده است. این دکمه ها مطابق با مکان در نمای رندر همانطور که در شکل 10. 2 نشان داده شده است مطابقت دارد.

../_images/AnnotationLocations.png

شکل 10. 2 دکمه های قرارگیری حاشیه نویسی و جایی که آنها حاشیه نویسی را قرار می دهند.

حالت دوم که با کلیک روی کادر انتخاب گوشه سمت چپ پایین فعال می شود ، به شما امکان می دهد حاشیه نویسی را به طور خودسرانه قرار دهید. اگر ویژگی تعامل فعال باشد ، می توانید برای قرار دادن آن ، حاشیه نویسی را در نمای رندر کلیک کرده و بکشید ، یا می توانید به صورت دستی مکانی را وارد کنید که گوشه سمت چپ پایین جعبه محدودیت حاشیه نویسی قرار گیرد. مختصات از نظر مختصات کسری که از [0 ، 1] در ابعاد x و y متغیر است ، تعریف شده است. سیستم مختصات نمای رندر دارای منشأ چپ پایین تر است ، بنابراین مقدار گوشه سمت چپ پایین [0 ، 0] حاشیه نویسی را در گوشه سمت چپ پایین نمای رندر قرار می دهد.

10. 1. 1. منبع متنی

منبع متنی شما را قادر می سازد حاشیه نویسی متن را در نمای ارائه اضافه کنید. این یک ویژگی دارد که تعیین می کند چه متن نمایش داده می شود. متن می تواند چند لایه باشد و می تواند حاوی اعداد و شخصیت های یونیکد باشد. متن همچنین ممکن است حاوی عبارات Mathtex بین شروع و پایان علائم دلار باشد. عبارات MathText زیر مجموعه ای از عبارات ریاضی Tex [DT] است. هنگامی که از MathText استفاده می شود ، متن فقط می تواند در یک خط واحد باشد.

../_images/TextSource.png

شکل 10. 3 نمونه ای از حاشیه نویسی منبع متن در گوشه سمت چپ بالا با یک عبارت ریاضی ارائه شده از یک بیان MathText [DT].

10. 1. 2. منبع زمان حاشیه نویسی

منبع زمان حاشیه نویسی تقریباً با منبع متن یکسان است ، اما همچنین به مقدار زمان فعلی تعیین شده در Paraview دسترسی دارد. کنترل فرمت نمایش زمان از طریق ویژگی Format در دسترس است. این ویژگی رشته ای را با بخش های قالب بندی اختیاری که توسط کتابخانه FMT قابل درک است ، می گیرد. به طور پیش فرض ، مقدار "زمان" است: جایی که اصطلاح "زمان" در داخل بریس های فرفری با مقدار زمان فعلی Paraview جایگزین می شود ، و ": F" مشخص می کند که باید به عنوان شناور با شش رقم اعشاری فرمت شود. برای سایر امکانات قالب بندی ، لطفاً توضیحات نحو FMT را در https://fmt. dev/latest/syntax.html مشاهده کنید. نمونه ها در نزدیکی پایین آن صفحه قرار دارند.

10. 2. فیلترهای حاشیه نویسی

منابع حاشیه نویسی که در بخش قبلی شرح داده شده است برای افزودن حاشیه نویسی متن که به هیچ مجموعه ای از مجموعه داده های بارگیری نشده بستگی ندارد ، در دسترس است. برای ایجاد حاشیه نویسی که مقادیر یک منبع داده موجود در مرورگر خط لوله را نشان می دهد ، چندین فیلتر حاشیه نویسی در دسترس است. خواص موجود برای تغییر فونت متن و مکان حاشیه نویسی دقیقاً مشابه موارد موجود برای منابع حاشیه نویسی است که در بخش قبلی شرح داده شده است.

10. 2. 1. حاشیه نویسی Attribute Filter

داده های Annotate Attribute امکان ایجاد حاشیه نویسی با مقدار داده از یک آرایه (یا ویژگی) را در یک مجموعه داده ایجاد می کند. برای استفاده از فیلتر ، ابتدا آرایه داده را با داده های مورد علاقه در آرایه ورودی Select انتخاب کنید. این آرایه ها ممکن است آرایه های نقطه ، سلول یا فیلد باشند. ویژگی Element ID شاخص نقطه یا سلول را مشخص می کند که مقدار آن باید در حاشیه نویسی نشان داده شود. اگر آرایه ورودی انتخاب شده یک آرایه میدانی باشد (با نقاط یا سلول ها همراه نیست) ، شناسه عنصر برای نشان دادن آرایه را مشخص می کند. هنگام اجرای موازی ، شناسه فرآیند فرآیندی را که آرایه ای را که باید از آن به دست آورد ، نشان می دهد.

../_images/AnnotateAttributeData.png

شکل 10. 4 ویژگی های فیلتر داده ویژگی Annotate.

ویژگی متن پیشوند قبل از مقدار ویژگی در حاشیه نویسی ارائه شده است. هیچ رشته قالب بندی وجود ندارد - شماره پس از پیشوند ضمیمه می شود. اگر مقدار آرایه انتخاب شده یک مقدار مقیاس باشد ، حاشیه نویسی فقط حاوی عدد خواهد بود. از طرف دیگر ، اگر مقدار آرایه از یک آرایه چند جزء باشد ، اجزای جداگانه در یک لیست جدا از فضا که توسط پرانتز احاطه شده است ، به برچسب حاشیه نویسی اضافه می شوند.

10. 2. 2. فیلتر داده جهانی را حاشیه نویسی کنید

برخی از قالب های پرونده شامل مفهوم داده های جهانی ، یک مقدار داده واحد است که در هر مرحله زمانی در آرایه داده ذخیره می شود. Paraview مجموعه ای از مقادیر داده ها را به عنوان یک آرایه داده فیلد مرتبط با مجموعه داده با همان تعداد مقادیر به عنوان timesteps ذخیره می کند. برای نمایش این مقادیر جهانی در نمای رندر ، از فیلتر داده جهانی Annotate استفاده کنید. منوی Select Arrays Popup آرایه های داده های موجود را نشان می دهد. خصوصیات پیشوند و پسوند به ترتیب قبل و بعد از مقدار داده در حاشیه نویسی ارائه می شود. ویژگی Format یک مشخص کننده فرمت شماره زبان C است همانطور که در یک تماس تابع PrintF استفاده می کنید. اگر این قالب برای نوع داده جهانی نامعتبر باشد ، فیلتر هشدار دهنده را ارائه می دهد.

10. 2. 3. حاشیه نویسی فیلتر زمان

یکی از ویژگی های خوب Paraview این است که از منابع داده ای پشتیبانی می کند که داده های مختلفی را در زمان های مختلف تولید می کنند. مثالها شامل خوانندگان فایل است که برای یک مرحله زمانی درخواست شده و فیلترهای زمانی خاص در داده ها می خوانند. هر منبع داده به مقادیر زمانی که می تواند داده ها را تولید کند ، تبلیغ می کند. داده های تولید شده و نمایش داده شده در Paraview بستگی به زمانی که در پانل کنترل PARAVIEW VCR یا پانل بازرس زمان تنظیم کرده اید.

نکته جالب توجه این است که شما می توانید چندین منبع داده داشته باشید که هر یک از آنها به مجموعه ای از زمان های منحصر به فرد تبلیغ و پاسخ می دهند. یعنی منابع موجود نیازی به تبلیغ ندارند که از همان مجموعه از نقاط زمانی پشتیبانی کنند - در واقع ، ممکن است داده ها را در نقاط زمانی کاملاً متفاوت تعریف کنند. با توجه به زمان درخواست شده ، هر منبع داده داده های مربوط به زمان پشتیبانی از نزدیکترین زمان درخواست شده را تولید می کند. به عنوان مثال ، این ویژگی ها می توان انیمیشن ها را از چندین مجموعه داده متفاوت در وضوح زمانی مختلف ایجاد کرد.

در حالی که منبع زمان حاشیه نویسی که در ابتدا توضیح داده شده است می تواند برای نمایش زمان درخواست شده Paraview مورد استفاده قرار گیرد ، اما مقدار زمانی را که یک منبع داده خاص به آن پاسخ می دهد ، نشان نمی دهد. به عنوان مثال Paraview ممکن است داده ها را برای زمان 5. 0 درخواست کند ، اما اگر یک منبع برای مقادیر زمان 10. 0 و بالاتر داده تولید کند ، داده ها را برای زمان 10. 0 تولید می کند ، حتی اگر زمان 5. 0 درخواست شده باشد. برای نشان دادن زمان تولید منبع داده ، می توانید در عوض از فیلتر زمان حاشیه نویسی استفاده کنید. به سادگی آن را به منبع مورد علاقه وصل کنید. اگر چندین منبع داده وجود داشته باشد ، ممکن است نمونه جداگانه ای از این فیلتر به هر یک وصل شود.

کنترل فرمت نمایش زمان از طریق ویژگی Format در دسترس است. رشته فرمت رشته ای است که توسط کتابخانه FMT پشتیبانی می شود و به طور پیش فرض به "زمان": جایی که رشته "زمان" در داخل بریس های فرفری با مقدار زمان بارگذاری شده منبع داده ای که این فیلتر به آن وصل شده است جایگزین می شود. این فیلتر همچنین شامل خصوصیات تغییر و مقیاس است که برای تغییر خطی زمان نمایش داده شده استفاده می شود. مقدار زمان ابتدا توسط مقیاس ضرب می شود و سپس تغییر به آن اضافه می شود.

10. 2. 4. فیلتر حاشیه نویسی محیط

اگر می خواهید اطلاعات مربوط به محیطی را که در آن تجسم ایجاد شده است نمایش دهید ، از فیلتر حاشیه نویسی محیط استفاده کنید. با وصل کردن این فیلتر به یک منبع داده ، می توانید آن را به طور خودکار نام کاربری خود را بر روی سیستم در حال اجرا Paraview نمایش دهید ، نشان دهید که از سیستم عامل برای تولید آن استفاده شده است ، تاریخ و زمان تولید تجسم را ارائه می دهد و نام پرونده را نشان می دهداز داده های منبع در صورت وجودهر یک از این موارد را می توان با کادر انتخاب در پنل Properties برای این فیلتر فعال یا غیرفعال کرد.

اگر منبع ورودی این فیلتر یک خواننده پرونده باشد ، ویژگی نام پرونده به نام پرونده اولیه می شود. برای نمایش مسیر کامل پرونده ، یک کادر برچسب دارای برچسب صفحه نمایش کامل در دسترس است ، اما در صورت عدم کنترل ، فقط نام پرونده نمایش داده می شود. این مسیر فایل پیش فرض را می توان با تغییر متن در ویژگی نام پرونده نادیده گرفت. اگر این فیلتر به جای خواننده به یک فیلتر وصل شود ، مسیر پرونده به یک رشته خالی اولیه می شود. می توان آن را به صورت دستی به نام اصلی پرونده یا یک رشته دلخواه در صورت تمایل تغییر داد.

10. 2. 5. فیلتر حاشیه نویسی پایتون

همه کاره ترین فیلتر حاشیه نویسی ، فیلتر حاشیه نویسی پایتون ، عمومی ترین روش تولید حاشیه نویسی را ارائه می دهد که شامل اطلاعات مربوط به مجموعه داده است. مقادیر از آرایه های داده نقطه ، سلول ، میدان و ردیف ممکن است در یک عبارت پایتون کوتاه که در خاصیت بیان تعریف شده است ، با عملیات ریاضی دسترسی داشته و با عملیات ریاضی همراه شوند. نوع آرایه های داده موجود برای استفاده در عبارت با خاصیت انجمن آرایه تنظیم شده است.

قبل از ادامه کار ، بیایید نمونه ای از نحوه استفاده از فیلتر حاشیه نویسی پایتون را بررسی کنیم. فرض کنید می خواهید مقدار داده را از یک آرایه نقطه به نام فشار در فهرست نقطه 22 نشان دهید. ابتدا ارتباط آرایه را روی داده ها قرار دهید تا اطمینان حاصل شود که آرایه های داده نقطه می توانند در بیان حاشیه نویسی پایتون ارجاع شوند. برای نشان دادن مقدار فشار در نقطه 22 ، خاصیت بیان را بر روی آن قرار دهید

../_images/PythonAnnotationSimple.png

شکل 10. 5 نمونه ای از فیلتر حاشیه نویسی پایتون اساسی که مقدار آرایه فشار را در نقطه 22 نشان می دهد.

شما می توانید بیان پایتون را تقویت کنید تا حاشیه نویسی بیشتر شود. برای افزودن پیشوند ، عبارت را روی تنظیم کنید

همه آرایه های داده در انجمن انتخاب شده به عنوان متغیرهایی ارائه می شوند که می توانند در عبارت ارجاع شوند تا زمانی که نام آنها متغیرهای پایتون معتبر باشد. نام های آرایه ای که نام های متغیر پایتون نامعتبر هستند از طریق نسخه اصلاح شده از نام آرایه در دسترس هستند. این نسخه ضدعفونی شده از نام آرایه شامل زیر مجموعه شخصیت های موجود در نام آرایه است که حروف ، اعداد یا زیرکانه (_) هستند (_) بدون فضایی به ترتیب که در نام آرایه اصلی ظاهر می شوند ، به هم می پیوندند. به عنوان مثال ، آرایه ای به نام Velocity X در متغیر VelocityX در دسترس خواهد بود.

داده های نقطه و سلولی در مجموعه داده های کامپوزیت مانند مجموعه داده های MultiBlock تا حدودی متفاوت از داده های نقطه یا سلول در مجموعه داده های غیر ترکیبی قابل دسترسی هستند. بیان

یک مقدار مقیاس واحد را از یک آرایه نقطه در یک مجموعه داده غیر ترکیبی بازیابی می کند ، همان عبارت عنصر 22 آرایه فشار را در هر بلوک بازیابی می کند. این مقادیر در یک VTKCompositedataArray برگزار می شود ، که یک ساختار داده است که دارای آرایه های مرتبط با هر بلوک در مجموعه داده است. از این رو ، وقتی بیان

در یک مجموعه داده کامپوزیت ارزیابی می شود ، مقدار برگشتی و نمایش داده شده در واقع مجموعه ای از مقادیر آرایه از هر بلوک است. برای دسترسی به مقدار از یک بلوک واحد ، آرایه از آن بلوک باید از عضو آرایه نتیجه VtkCompositedataArray انتخاب شود. برای نشان دادن مقدار فشار مرتبط با نقطه 22 بلوک 2 ، به عنوان مثال ، عبارت را تنظیم کنید

این بیان با فرض اینکه آرایه فشار دارای یک مؤلفه واحد است ، یک مقدار داده واحد در حاشیه نویسی ارائه شده به دست می آورد. برای نشان دادن طیف وسیعی از مقادیر آرایه ، از یک عبارت پایتون در شاخص در قسمت فشار استفاده کنید ، به عنوان مثال

این مقادیر فشار برای نقاط 22 و 23 از بلوک 2 را نشان می دهد. شما همچنین می توانید بیش از یک آرایه را با استفاده از یک محدوده شاخص در عضو آرایه ، به عنوان مثال ، بازیابی کنید.

این عبارت برای فشار برای نقاط 22 و 23 برای بلوک های 2 ، 3 و 4 ارزیابی می شود.

انجمن آرایه واقعاً راحتی می تواند مجموعه ای از آرایه های داده انجمن داده شده را به عنوان متغیرهایی که می توانند در این عبارت استفاده کنند ، در دسترس قرار دهد. نکته منفی استفاده از این نام های آرایه این است که آرایه ها از یک ارتباط آرایه در یک زمان در دسترس هستند. این بدان معناست که حاشیه نویسی هایی که نیاز به ترکیبی از آرایه داده های سلولی و آرایه داده های نقطه دارند ، به عنوان مثال ، با این متغیرهای پایتون راحتی نمی توانند به تنهایی بیان شوند.

خوشبختانه ، شما می توانید با یک بیان کمی بیشتر به هر آرایه ای در ورودی این فیلتر دسترسی پیدا کنید. به عنوان مثال ، عبارت زیر مقدار داده سلول را با یک مقدار داده نقطه ضرب می کند:

توجه داشته باشید که آرایه های موجود در ورودی با استفاده از نام آرایه اصلی آنها در مثال بالا قابل دسترسی هستند.

در مثال بالا ، ورودی عبارت [0] به اولین ورودی به فیلتر اشاره دارد. در حالی که این فیلتر می تواند فقط یک ورودی داشته باشد ، بر اساس همان کد مورد استفاده توسط ماشین حساب پایتون (شرح داده شده در بخش 5. 9. 3) است که چندین ورودی آن را در لیست پایتون قرار می دهد ، از این رو ورودی به فیلتر حاشیه نویسی پایتون ارجاع می شودبه عنوان ورودی [0].

علاوه بر ایجاد متغیرهایی برای ارتباط آرایه فعلی موجود در عبارت ، این فیلتر برخی از متغیرهای دیگر را ارائه می دهد که می توانند هنگام محاسبه مقدار حاشیه نویسی مفید باشند.

امتیازات: مکان های نقطه (برای مجموعه داده ها با نقاط صریح موجود است).

time_value ، t_value: مقدار زمان فعلی در Paraview تنظیم شده است.

time_steps ، t_steps: تعداد زمان های موجود در ورودی.

time_range ، t_range: دامنه زمان بندی در ورودی.

time_index ، t_index: شاخص زمان بندی فعلی در Paraview.

برخی از موقعیت ها وجود دارد که متغیرهای فوق تعریف نشده اند. اگر ورودی هیچ نقاط صریح و مشخصی نداشته باشد ، به عنوان مثال ، داده های تصویر ، متغیر نقاط تعریف نشده است. اگر ورودی زمان بندی را تعریف نکند ، متغیرهای TIME_* و T_* تعریف نمی شوند.

سرانجام ، تمام قابلیت های ماشین حساب پایتون ، مستند شده در بخش 5. 9. 3 ،

در دسترس هستند ، از جمله ادغام NUMPY و دسترسی به روشهای Numpy و Scipy.

خطاهای مشترک

متغیرهای مرتبط با زمان برای فهرست بندی آرایه های داده نقطه یا سلول لازم نیست. فقط نقطه و آرایه های سلولی بارگذاری شده برای زمان فعلی در فیلتر موجود است. شما نمی توانید به داده های نقطه یا سلولی از زمان های دلخواه از درون این فیلتر دسترسی پیدا کنید.

با قابلیت های موجود در این فیلتر ، می توان مانند شکل زیر می توان منابع و فیلترهای دیگر را تولید کرد.

منبع متنی: برای تولید متن "حاشیه نویسی من" ، "حاشیه نویسی من" را بنویسید

حاشیه نویسی منبع زمان: برای تولید معادل زمان: ، "زمان: ٪ f" ٪ time_value را بنویسید

Annotate Attribute Filter Filter: برای تولید معادل تنظیم آرایه ورودی به EQPS ، شناسه Element به 0 و شناسه پردازش به 0 و پیشوند مقدار این است: ، نوشتن "مقدار . 12f" ٪ (ورودی ها [0]. celldata ['eqps'] [0]).

حاشیه نویسی فیلتر داده جهانی: برای تولید همان حاشیه نویسی به عنوان تنظیم آرایه های انتخاب به KE ، پیشوند مقدار عبارت است از: ، فرمت ٪ 7. 5 گرم و پسوند خالی ، "مقدار: ٪ 7. 5 گرم" ٪ (ورودی ها [0] . FieldData را بنویسید.['ke']. آرایه ها [0] [time_index])

فیلتر زمان حاشیه نویسی: برای تولید معادل فرمت تنظیم به زمان: ٪ F ، تغییر به 3 و مقیاس به 2 ، "زمان: ٪ f" ٪ (2*time_value + 3) را بنویسید.

مثالهای فوق به معنای نشان دادن تطبیق پذیری فیلتر حاشیه نویسی پایتون است. استفاده از منابع و فیلترهای تخصصی تخصصی احتمالاً از ورود به عبارات در مثالها راحت تر است.

خبرهای فارکس...
ما را در سایت خبرهای فارکس دنبال می کنید

برچسب : نویسنده : شهره لرستانی بازدید : 57 تاريخ : دوشنبه 8 خرداد 1402 ساعت: 0:04