رابط پس پردازش و نتایج.
نحو
model.result();
model.result().create( <pgtag> , dim );
model.result().create( <pgtag> , ftype );
model.result( <pgtag> ).set( خاصیت , <value> );
model.result( <pgtag> ).run();
model.result( <pgtag> ).create( <ftag> , ftype );
model.result( <pgtag> ).feature( <ftag> ).getPlotGroup();
model.result( <pgtag> ).feature( <ftag> ).getType();
model.result( <pgtag> ).feature( <ftag> ).getSDim();
model.result( <pgtag> ).feature( <ftag> ).isPlotGroup();
model.result( <pgtag> ).feature( <ftag> ).prepareView( <value> );
model.result( <pgtag> ).feature( <ftag> ).selection(…);
model.result( <pgtag> ).feature( <ftag> ).set( خاصیت , <value> );
model.result( <pgtag> ).feature( <ftag> ).run();
model.result( <tag> ).feature( <ftag> ).getAllowedPropertyValues( خاصیت );
model.result( <pgtag> ).feature( <ftag> ).create( <attrtag> , attrtype );
model.result( <pgtag> ).feature( <ftag> ).feature( <attrtag> ).set( خاصیت , <value> );
model.result().dataset().create( <dtag> , dtype );
model.result().dataset( <dtag> ).create( <dtag2> , dtype );
model.result().dataset( <dtag> ).selection(…);
model.result().dataset( <dtag> ).set( خاصیت , <value> );
model.result().dataset( <dtag> ).getAllowedPropertyValues( خاصیت );
model.result().export().create( <etag> , <pgtag> , ctype );
model.result().export( <etag> ).create( <e2tag> , ctype );
model.result().export( <etag> ).set( خاصیت , <value> );
model.result().export( <etag> ).run();
model.result().export( <etag> ).getAllowedPropertyValues( خاصیت );
model.result().numerical().create( <ntag> , ntype );
model.result().numerical( <ntag> ).selection(…);
model.result().numerical( <ntag> ).set( خاصیت , <value> );
model.result().numerical( <ntag> ).run();
model.result().table().create( <ftag> , ntype );
model.result().table( <ftag> ).setColumnHeaders( <headers> );
model.result().table( <ftag> ).setTableData( <realData> , <imagData> );
model.result().table( <ftag> .getColumnHeaders();
model.result().table( <ftag> ).getReal();
model.result().table( <ftag> ).getImag();
model.result().table( <ftag> ).isComplex();
model.result().table( <ftag> ).clearTableData();
model.result().table( <ftag> ).save( <نام فایل> );
model.result().report().create( <rtag> );
model.result().report( <rtag> ).getAllowedPropertyValues( خاصیت );
model.result().report( <rtag> ).set( rprop , <value> );
model.result().report( <rtag> ).set(“template”, <value> );
model.result().report( <rtag> ).generate();
model.result().report( <rtag> ).create( <r2tag> , frtype );
model.result().report( <rtag> ).feature( <r2tag> ).set( rprop , <value> );
model.result().report( <rtag> ).feature( <r2tag> ).create( <r3tag> , frtype );
model.result().report( <rtag> ).feature( <r2tag> ).feature( <r3tag> ).set( rprop , <value> );
model.result().report( <rtag> ).run();
شرح
model.result( <pgtag> ) یک گروه نمودار را با تگ <pgtag> برمی گرداند .
model.result().create( <pgtag> , dim ) یک گروه نمودار با تگ <pgtag> با ابعاد dim ایجاد می کند که dim می تواند 1 ، 2 یا 3 باشد .
model.result().create( <pgtag> , ftype ) یک گروه نمودار از نوع ftype ایجاد می کند . انواع معتبر “PlotGroup1D” ، “PlotGroup2D” ، “PlotGroup3D” ، “PolarGroup” و “SmithGroup” هستند .
model.result( <pgtag> ).create( <ftag> , ftype ) یک ویژگی نمودار از نوع ftype با برچسب <ftag> متعلق به گروه نمودار <pgtag> ایجاد می کند .
model.result( <pgtag> ).feature( <ftag> ).getType() نوع ویژگی <ftag> را برمی گرداند . این همان رشته ftype است که برای ایجاد این ویژگی استفاده شده است.
model.result( <pgtag> ).feature( <ftag> ).getSDim() بعد فضایی گروه نمودار را برمی گرداند.
model.result( <pgtag> ).feature( <ftag> ).isPlotGroup() اگر ویژگی یک گروه نمودار باشد، true را برمی گرداند . این روش در ویژگی های کودک نیز موجود است.
model.result( <pgtag> ).feature( <ftag> ).getPlotGroup() گروه نموداری را که ویژگی به آن تعلق دارد برمی گرداند. این روش در ویژگی های کودک نیز موجود است.
model.result( <pgtag> ).feature( <ftag> .create( <attrtag> , attrtype ) یک ویژگی مشخصه با برچسب <attrtag> از نوع attrtype ایجاد می کند که متعلق به ویژگی <ftag> است .
model.result( <pgtag> ).run() گروه طرح را ترسیم می کند.
model.result( <pgtag> ).feature( <ftag> ).prepareView( <value> ) نمای مورد نظر را هنگام ترسیم گروه نموداری که ویژگی به آن تعلق دارد، برمی گرداند. آرگومان یک Boolean است و اگر درست باشد ، در صورت نیاز نمای ایجاد می شود.
model.result().dataset().create( <dtag> , dtype ) یک ویژگی مجموعه داده با تگ <dtag> و نوع dtype ایجاد می کند .
model.result().export().create( <etag> , <pgtag> , etype ) یک ویژگی صادراتی با تگ <etag> ایجاد می کند که متعلق به گروه نمودار <pgtag> و از نوع صادراتی etype است .
model.result().numerical().create( <ntag> , ntype ) یک ویژگی نتایج عددی با تگ <ntag> از ویژگی عددی نوع ntype ایجاد می کند .
model.result().numerical( <ntag> ).run() ویژگی نتایج عددی را ارزیابی می کند.
model.result(< برچسب >).feature(< ftag >)).getAllowedPropertyValues(property) , model.result().dataset( <dtag> ).getAllowedPropertyValues( خاصیت ) , model.result().export( <etag > .getAllowedPropertyValues( خاصیت ) و model.result().report( <rtag> ). getAllowedPropertyValues( خاصیت ) مجموعه مقادیر مجاز برای یک ویژگی را برمی گرداند اگر مجموعه مجموعه محدودی از رشته ها باشد. در غیر این صورت، آنها را باطل بر می گرداند.
model.result().dataset( <dtag> ).refresh() مجموعه داده Grid را با استفاده از داده های توابعی که فایل ها را می خوانند (Elevation، Image و Interpolation) به روز می کند.
model.result().table().create( <ftag> , ntype ) یک ویژگی جدول با تگ <ftag> ایجاد می کند . متدهای set و get مورد استفاده برای دستکاری جداول در جدول توضیح داده شده است .
روش های استخراج داده های مورد استفاده برای بازیابی نمودار یا داده های عددی در نتایج توضیح داده شده است .
model.result().report().create( <rtag>, ” Report”) یک گزارش با تگ <rtag> ایجاد می کند .
model.result().report().create( <ptag>, “ Presentation”) یک ارائه با تگ <ptag> ایجاد می کند .
model.result().report().create( <ttag>, ” Template”) یک الگوی گزارش با تگ <ttag> ایجاد می کند . چنین الگوهای گزارشی جایگزین های سفارشی شده برای الگوهای داخلی هستند: مختصر، متوسط و کامل. یک الگوی گزارش کامل شامل یک نمونه از هر یک از ویژگی‌های گزارش محتوای مدل معمولی است. هنگامی که یک ویژگی گزارش محتوای مدل در یک الگو رخ می دهد، ویژگی های موجود با ویژگی های گزارش معمولی مربوطه مطابقت دارند. با این حال، برخی از ویژگی های گزارش-ویژگی معمولی، مانند ویژگی noderef برای ارجاع به ویژگی مدل برای گزارش، قابل اجرا نیستند و بنابراین در دسترس نیستند.
برای راه اندازی یک الگو ، می توانید آن را ویژگی به ویژگی بسازید یا از یکی از الگوهای داخلی به عنوان نقطه شروع استفاده کنید و سپس آن را قبل از سفارشی کردن تنظیمات ایجاد کنید:
template.set(“سطح”, lvalue );
template.set(“absentnodes”, state );
template.generate();
template.set(“absentnodes”, state );
template.generate();
مقادیر مجاز برای ویژگی سطح عبارتند از “brief” ، “intermediate” (پیش فرض) و “complete” . از مقدار این ویژگی برای تعریف تنظیمات اولیه هنگام ساخت قالب به صورت دستی نیز استفاده می شود. ویژگی absentnodes می تواند دو مقدار داشته باشد:
• | “exclude” (پیش‌فرض) – گره‌های الگو که در قالب وجود ندارند یا در قالب غیرفعال هستند، هنگام ایجاد گزارش با استفاده از الگو حذف می‌شوند. |
• | “شامل” – برعکس، گره‌های الگو که در قالب وجود ندارند یا در قالب غیرفعال هستند،هنگام ایجاد گزارش با استفاده از الگو، گنجانده می‌شوند. |
پس از ایجاد گزارش گزارش ، مشخص کنید که از کدام الگو استفاده کنید و سپس محتوا را تولید کنید:
report.set(“الگو”, مقدار );
report.generate();
report.generate();
مقادیر مجاز برای ویژگی الگو بستگی به در دسترس بودن الگوهای سفارشی در مدل، نصب و فهرست الگوهای گزارش کاربر دارد:
• | الگوهای داخلی، “مختصر” ، “متوسط” (پیش‌فرض) و “کامل” همیشه در دسترس هستند. |
• | اگر مدل حاوی الگوهای گزارش با تگ‌های tmpl1 ، …، tmpl n باشد، می‌توان این الگوها را با تنظیم ویژگی الگو بر روی هر یک از مقادیر “model.tmpl1” ، …، “model.tmpl n” با مدل ، به عنوان الگوهای گزارش انتخاب کرد. یک پیشوند فضای نام ثابت بودن |
• | اگر داده‌های دایرکتوری/قالب‌های گزارش زیر فهرست اصلی نصب COMSOL Multiphysics حاوی فایل‌های MPH با الگوهای گزارش باشد، می‌توان این فایل‌ها را با تنظیم الگو روی “نصب. <TemplateFilename> . <ttag> “ انتخاب کرد . در اینجا نصب یک پیشوند فضای نام ثابت است، <TemplateFilename> .mph نام فایل MPH است و <ttag> یک تگ الگوی گزارش است. |
• | در نهایت، اگر دایرکتوری reporttemplates زیر فهرست تنظیمات کاربر .comsol/v61 در زیر فهرست اصلی محلی شما حاوی فایل‌های MPH با الگوهای گزارش باشد، این فایل‌ها با استفاده از الگوی مشابه با الگوهای نصب انتخاب می‌شوند، با این تفاوت که پیشوند فضای نام کاربر است . |
توجه داشته باشید که اگر گزارش از قبل دارای گره‌های فرزند باشد هنگام فراخوانی report.generate() ، این گره‌ها قبل از تولید محتوای جدید حذف خواهند شد.
model.result().report().create( <ttag>, ” PresentationTemplate”) یک الگوی ارائه با تگ <ttag> ایجاد می کند . چنین الگوهای ارائه ای جایگزین های سفارشی شده برای الگوهای داخلی هستند: پیش فرض و با جزئیات. یک الگوی ارائه کامل شامل یک نمونه از هر یک از ویژگی‌های معمولی ارائه محتوای مدل است. هنگامی که یک ویژگی ارائه محتوای مدل در یک الگو رخ می دهد، ویژگی های موجود با ویژگی های ارائه معمولی مربوطه مطابقت دارد. با این حال، برخی از ویژگی‌های ویژگی ارائه معمولی، مانند ویژگی noderef برای ارجاع به ویژگی مدل، قابل اجرا نیستند و بنابراین در دسترس نیستند.
report.create( <tptag>، “ TitlePage”) یک صفحه عنوان به گزارش گزارش اضافه می کند . فقط یک ویژگی صفحه عنوان را می توان اضافه کرد.
report.create( <tptag>، “ TitleSlide”) یک اسلاید عنوان را به ارائه ارائه اضافه می کند . فقط یک ویژگی عنوان اسلاید را می توان اضافه کرد.
report.feature( <tptag> ).set( prop,value ) ویژگی صفحه عنوان prop را با مقدار مقدار تنظیم می کند .
report().create( <toctag>, “ TableOfContents”) فهرستی از مطالب را به گزارش گزارش اضافه می کند . فقط یک ویژگی فهرست مطالب را می توان اضافه کرد.
report.create ( <stag>، “Section”) یک سطح بخش اضافی را به گزارش اضافه می کند.
report.create( <stag>, “ SectionSlide”) یک اسلاید بخش را به ارائه ارائه اضافه می کند .
report.feature ( <stag>). مجموعه (پایه، ارزش)
report.feature( <stag> ).create( <ftag> ), feature )
report.feature( <stag> ).feature( <ftag> ). مجموعه (پایه، ارزش)
برای افزودن یک گزارش یا ویژگی محتوای ارائه – یعنی ویژگی مربوط به محتوای گزارش یا ارائه – به بخش ویژگی بخش ، type, section.create ( <frtag> , frtype , …) را وارد کنید. بسته به نوع ویژگی frtype ، عملیات ایجاد شامل صفر، یک یا دو تگ است که به ویژگی مدل اشاره دارد. برچسب ها باید به یک ویژگی موجود از نوع صحیح اشاره کنند. انواع ویژگی هایی که برای گزارش در مورد محتویات مدل در دسترس هستند در جدول 2-107 فهرست شده اند . برای جزئیات بیشتر در مورد استفاده از آنها، به بخش محتویات مدل — گزارش اجزاء در راهنمای کاربر COMSOL Multiphysics مراجعه کنید .
ویژگی گزارش | شرح |
مدل | اطلاعات مربوط به ریشه مدل مانند فایل مدل را چاپ می کند. |
ModelNode | اطلاعات مربوط به یک جزء مدل را چاپ می کند. |
پارامتر | گزارش در مورد ویژگی پارامترهای جهانی. |
متغیرها | گزارش در مورد ویژگی متغیرها |
کارکرد | گزارش در مورد یک ویژگی عملکرد. |
ThermoPackage | گزارشات مربوط به ویژگی بسته ویژگی ترمودینامیک (نیاز به مجوز ماژول مهندسی واکنش شیمیایی). |
MethodCall | گزارش در مورد ویژگی فراخوانی روش. |
گروه | گزارش در مورد یک محدودیت یا ویژگی گروه بار. |
ReducedModel | گزارش در مورد یک ویژگی مدل کاهش یافته. |
GeometryPart | گزارش بخشی از هندسه |
قسمت مش | گزارش در مورد یک قطعه مش. |
ExtraDim | اطلاعات مربوط به یک جزء مدل اضافی را چاپ می کند. |
ExpressionOperator | گزارش در مورد ویژگی بیان-اپراتور. |
MatrixVariable | گزارش در مورد یک ویژگی متغیر ماتریس (ماتریس، معکوس ماتریس، قطر ماتریس، تجزیه ماتریس (SVD)، تبدیل برداری، تبدیل ماتریس، یا متغیرهای حالت). |
عوامل مشارکت | گزارش در مورد ویژگی عوامل مشارکت. |
ResponseSpectrum | گزارش در مورد یک ویژگی طیف پاسخ. |
MassProperties | گزارش هایی در مورد ویژگی های انبوه. |
پویشگر | گزارشات مربوط به یک ویژگی کاوشگر |
ComponentCoupling | گزارشات مربوط به یک ویژگی جفت کردن کامپوننت |
انتخاب | گزارش در مورد یک ویژگی انتخاب. |
جفت کردن | گزارش در مورد یک ویژگی جفت. |
دستگاه مختصات | گزارش در مورد ویژگی سیستم مختصات. |
MovingMesh | گزارش در مورد ویژگی متحرک مش. |
هندسه تغییر شکل یافته | گزارش در مورد یک ویژگی هندسه تغییر شکل یافته. |
بهينه سازي | گزارش یک ویژگی بهینه سازی |
لایه جذبی | گزارش در مورد ویژگی لایه جذبی. |
PML | گزارش در مورد یک ویژگی کاملاً مطابق با لایه. |
عناصر بی نهایت | گزارش در مورد یک ویژگی دامنه نامتناهی. |
MultiphysicsProp | گزارش در مورد ویژگی Multiphysics-properties. |
هندسه | گزارش در مورد یک هندسه |
مواد | گزارش در مورد یک ویژگی مادی. |
فیزیک | گزارش در مورد رابط فیزیک و ویژگی های آن. |
چند فیزیک | گزارش هایی در مورد یک جفت مولتیفیزیک و ویژگی های آن. |
مش | گزارش در مورد مش. |
مطالعه | گزارش های یک مطالعه |
حل کننده | گزارش در مورد یک حل کننده |
ResultParameter | گزارش در مورد یک ویژگی پارامترهای نتیجه. |
DataSet | گزارشات مربوط به یک ویژگی مجموعه داده |
مقادیر مشتق شده | گزارشات مربوط به یک ویژگی مقادیر مشتق شده |
جدول | شامل جدول نتایج در گزارش. |
جدول رنگ | شامل یک جدول رنگ سفارشی در گزارش. |
PlotGroup | شامل یک گروه طرح در گزارش است. |
گروه ارزیابی | گزارش در مورد یک ویژگی گروه ارزیابی. |
صادرات | شامل یک ویژگی صادرات در گزارش است. |
علاوه بر این، انواع ویژگی های سفارشی فهرست شده در جدول 2-108 نیز برای گزارش ها و ارائه های ساختمان در دسترس هستند. استفاده از آنها در بخش گزارش سفارشی، مستندات، و اجزای ارائه در راهنمای کاربر COMSOL Multiphysics توضیح داده شده است .
ویژگی گزارش | شرح |
معادله | معادله ای را به گزارش اضافه می کند. |
سرفصل | عنوانی را به گزارش اضافه می کند. |
تصویر | تصویری را به گزارش اضافه می کند. |
فهرست کنید | لیستی را به گزارش اضافه می کند. |
List Item | یک مورد را به لیست اضافه می کند. |
Tbl | یک جدول سفارشی به گزارش اضافه می کند. |
TblHRow | یک ردیف عنوان را به یک جدول سفارشی اضافه می کند. |
TblRow | یک ردیف بدنه به جدول سفارشی اضافه می کند. |
متن | یک پاراگراف متنی به گزارش اضافه می کند. |
کد | یک پاراگراف متنی با قالب بندی کد اضافه می کند. |
در نهایت، تعدادی از انواع ویژگی های گزارش برای ایجاد گزارش و ارائه برای برنامه های ایجاد شده در Application Builder ارائه شده است. این موارد در جدول 2-109 فهرست شده اند . برای جزئیات بیشتر، به بخش آرایه‌ها و اسکالارها و اجزای اعلان در راهنمای کاربر COMSOL Multiphysics و مراجع موجود در آن مراجعه کنید.
ویژگی گزارش | شرح |
آرایه ها | یک جدول سفارشی برای گره‌های اعلان Array 1D و Array 2D که در زیر شاخه Declarations در Application Builder تعریف شده‌اند، اضافه می‌کند. |
اسکالرها | جدولی را اضافه می کند که در آن ستون ها و ردیف های داده جدول را می توان سفارشی کرد. |
انتخاب لیست | گزارش در مورد لیست انتخاب |
UnitSet | گزارشات مربوط به یک مجموعه واحد |
StringDataField ، BooleanDataField ، IntegerDataField ، DoubleDataField | گزارش در مورد اعلان داده های اسکالر |
StringArrayDataField ، BooleanArrayDataField ، IntegerArrayDataField ، DoubleArrayDataField | گزارش در مورد اعلان داده های آرایه 1 بعدی. |
StringMatrixDataField ، BooleanMatrixDataField ، IntegerMatrixDataField ، DoubleMatrixDataField | گزارش در مورد اعلان داده های آرایه دوبعدی. |
برای اشاره کردن یک ویژگی گزارش rFeature به ویژگی دیگری با برچسب <ftag> در درخت، از روش rFeature.set(“noderef”, <ftag> ) استفاده کنید . یک ویژگی محتوای گزارش باید به ویژگی از نوعی که برای گزارش طراحی شده است اشاره کند. جدول بالا را ببینید به جای تگ ویژگی، “noderef” را روی “none” قرار دهید تا یک مرجع پاک شود.
model.result().report( <rtag> ).feature( <stag> ).feature( <frtag> ).set( frprop , <value> )
برای تنظیم یک ویژگی در یک ویژگی گزارش.
مثال ها
یک مجموعه داده ایجاد کنید و آن را طوری تنظیم کنید که از یک دنباله حل کننده به راه حل برچسب گذاری شده sol1 اشاره کند :
کد برای استفاده با جاوا
model.result().dataset().create(“dset”, “Solution”);
model.result().dataset(“dset”).set(“راه حل”، “Sol1”);
کد برای استفاده با متلب
model.result.dataset.create(‘dset’, ‘Solution’);
model.result.dataset(‘dset’).set(‘solution’, ‘Sol1’);
یک گروه طرح سه بعدی حاوی یک نمودار ساده و یک صفحه با نمودار کانتور ایجاد کنید:
کد برای استفاده با جاوا
result().create(“pg1”,3);
result(“pg1”).set(“data”,”dset”);
result(“pg1”).create(“stream”,”Streamline”);
model.result(“pg1”).feature(“stream”).set(“expr”, new String[]{“2-x”، “0”، “z”});
model.result(“pg1”).feature(“stream”).selection().set(new int[]{2});
result().dataset().create(“cutp1″,”CutPlane”);
result(“pg1”).create(“cont1″,”Contour”);
result(“pg1”).feature(“cont1”).set(“data”,”cutp1″);
result(“pg1”).run();
کد برای استفاده با متلب
result.create(‘pg1’,3);
result(‘pg1’).set(‘data’,’dset’);
result(‘pg1’).create(‘stream’,’Streamline’);
model.result(‘pg1’).feature(‘stream’).set(‘expr’, {‘2-x’, ‘0’, ‘z’});
model.result(‘pg1’).feature(‘stream’).selection.set(2);
result.dataset.create(‘cutp1′,’CutPlane’);
result(‘pg1’).create(‘cont1′,’Contour’);
result(‘pg1’).feature(‘cont1’).set(‘data’,’cutp1′);
نتیجه (‘pg1’).run;
