روش‌های کاربردی شی مدل مانند روش‌هایی برای ایجاد و حذف اشیاء مدل، نمایش اطلاعات پیشرفت و فهرست‌بندی و ذخیره اولویت‌ها. مدل را هم ببینید .
نحو
این بخش روش های کلی را توضیح می دهد که محیط را برای شی مدل مدیریت می کند. همچنین روش هایی را برای ماشین آلات مشتری/سرور توضیح می دهد.
وارد کردن com.comsol.model.*;
وارد کردن com.comsol.model.util.*;
عبارات واردات در بالا همه روش‌های کاربردی مدل و مدل را در دسترس قرار می‌دهند.
ModelUtil.create( <tag> ) : متد create یک مدل با تگ <tag> ایجاد می کند . ارجاع به مدل را برمی‌گرداند. اگر قبلاً مدلی با این تگ وجود داشته باشد، مدل قبلی حذف می شود.
ModelUtil.remove( <tag> ) : متد remove مدل برچسب گذاری شده <tag> را حذف می کند .
ModelUtil.clear() : متد clear تمام مدل ها را حذف می کند.
ModelUtil.tags() : متد tags لیست فعلی تگ های مدل را بدست می آورد.
ModelUtil.model( <tag> ) : متد model مرجعی را به مدل برچسب گذاری شده <tag> برمی گرداند .
ModelUtil.closeWindow( <windowtag> ) : متد closeWindow پنجره ای را با برچسب <windowtag> می بندد .
ModelUtil.closeWindows() : متد closeWindows تمام پنجره های سرور را می بندد.
ModelUtil.createUnique(< prefix> ) : متد createUnique یک مدل با یک تگ منحصر به فرد ایجاد می کند که با پیشوند < پیشوند> شروع می شود .
ModelUtil.getComsolVersion() : متد getComsolVersion نسخه COMSOL Multiphysics فعلی را به صورت رشته ای برمی گرداند.
ModelUtil.getOpenGeometryKernel() : متد getOpenGeometryKernel هسته هندسه را برای استفاده هنگام باز کردن مدل ها برمی گرداند. مقادیر معتبر مدلی برای هسته هندسه مورد استفاده در فایل مدل و comsol برای تبدیل هندسه به هسته COMSOL هستند.
ModelUtil.getDefaultGeometryKernel() : متد getDefaultGeometryKernel هسته هندسه پیش فرض را در مدل های جدید برمی گرداند. مقادیر معتبر عبارتند از comsol برای هسته COMSOL و cadps برای هسته CAD (هسته Parasolid). هسته CAD به ماژول واردات CAD نیاز دارد.
ModelUtil.setOpenGeometryKernel( <openkernel> ) : متد setOpenGeometryKernel هسته هندسی را مشخص می کند که هنگام باز کردن مدل ها استفاده شود. مقادیر معتبر مدلی برای هسته هندسه مورد استفاده در فایل مدل و comsol برای تبدیل هندسه به هسته COMSOL هستند.
ModelUtil.setDefaultGeometryKernel( <defaultkernel> ) : متد setDefaultGeometryKernel، هسته هندسه پیش فرض را برای استفاده در مدل های جدید با رشته <defaultkernel> مشخص می کند . مقادیر معتبر عبارتند از comsol برای هسته COMSOL و cadps برای هسته CAD (هسته Parasolid). هسته CAD به ماژول واردات CAD نیاز دارد.
ModelUtil.getEntityPath( <entity> , <divider> ) : متد getEntityPath مسیر را از ریشه شی مدل برای موجودیت داده شده <entity> ایجاد می کند . <divider> یک تقسیم کننده را برای استفاده بین موجودیت های موجود در مسیر مشخص می کند.
ModelUtil.load( <tag> , <filename> ) : روش load یک مدل را از فایل <filename> در سیستم فایل مشتری بارگیری می کند و آن را <tag> نامگذاری می کند . بارگذاری یک فایل از یک دایرکتوری، دایرکتوری مدل را تنظیم می کند. دایرکتوری مدل برای ذخیره فایل ها استفاده می شود اگر یک مسیر مطلق برای فایل ارائه نکنید. دایرکتوری مدل دایرکتوری است که مدل در آن ذخیره می شود. اگر مدل ذخیره نشده باشد، دایرکتوری مدل وجود ندارد. می توانید دایرکتوری مدل را از یک مدل ذخیره شده با استفاده از model.getFilePath دریافت کنید .
ModelUtil.loadCopy( <tag> , <filename> ) : روش loadCopy یک کپی از یک مدل را از یک فایل <filename> در سیستم فایل مشتری بارگیری می کند و نام آن را <tag> می گذارد . روش loadCopy همانند load است با این تفاوت که مدل بارگذاری شده با فایل مرتبط نیست، بنابراین model.save() کار نمی کند. برای اولین بار که دوباره آن را ذخیره می کنید باید نام آن را مشخص کنید.
ModelUtil.loadOnServer( <tag> , <filename> ) : روش loadOnServer مانند ModelUtil.load عمل می کند با این تفاوت که نام فایل یک مسیر در رایانه سرور است. کلاینت نیازی به دسترسی به فایل ندارد.
ModelUtil.loadProtected( <tag> , <filename> , <password> ) : روش loadProtected مانند ModelUtil.load اما با محافظت از رمز عبور کار می کند.
ModelUtil.loadProtectedOnServer( <tag> , <filename> , <password> ) : روش loadProtectedOnServer مانند ModelUtil.loadOnServer اما با محافظت از رمز عبور کار می کند.
ModelUtil.loadRecovery( <tag> , <foldername> ) : روش loadRecovery یک مدل را از یک دایرکتوری بازیابی یا ساختار پوشه در سیستم فایل مشتری بارگیری می کند و نام آن را <tag> می گذارد .
ModelUtil.showPlots(bool) : روش showPlots هنگام اتصال به سرور گرافیکی اعمال می شود و ModelUtil.showPlots(false) ترسیم را غیرفعال می کند. هیچ پنجره طرح موجود را نمی بندد. برای این کار از ModelUtil.closeWindow( <tag> ) یا ModelUtil.closeWindows() استفاده کنید
ModelUtil.showProgress(bool) : روش showProgress با ورودی بولی نمایش پیشرفت در پنجره یا فایل را هنگام اجرای وظایف طولانی هنگام اتصال به سرور روشن یا خاموش می کند. مقدار بازگشتی یک مقدار بولی است که در صورت امکان نمایش پیشرفت درست است.
ModelUtil.showProgress( <filename> ) : روش showProgress با ورودی نام فایل، ثبت پیشرفت فایل <filename> را در سیستم فایل مشتری فعال می کند. اگر <filename> صفر باشد، پیشرفت در خروجی استاندارد ثبت می شود.
ModelUtil.initStandalone(bool) : متد initStandalone محیط را برای استفاده از COMSOL API از یک برنامه کاربردی Java ® مستقل مقداردهی می کند . شما نباید از این دستور از LiveLink™ برای MATLAB استفاده کنید . اگر پشتیبانی برای ترسیم در رابط کاربری گرافیکی با استفاده از ابزارک جاوا Swing باید در دسترس باشد، آرگومان را روی true تنظیم کنید.
ModelUtil.initStandalone (bool, <guiToolkit> ) اجازه می دهد تا مشخص کنید که پشتیبانی برای استفاده از یک جعبه ابزار جاوا GUI داده شده باید در دسترس باشد. پارامتر اختیاری <guiToolkit> می‌تواند دارای مقادیر “swing” یا “swt” باشد که نشان می‌دهد ویجت‌های Swing یا ویجت‌های ابزارکیت ابزار استاندارد (SWT) قابل استفاده هستند.
ModelUtil.getPreference( <prefsName> ) : متد getPreference مقدار یک اولویت را برمی گرداند.
ModelUtil.setPreference( <prefsName> , <value> ) : متد setPreference مقدار یک اولویت را تنظیم می کند.
ModelUtil.listPreferences() : متد listPreferences رشته ای را با لیستی از نام ترجیحات و توضیحات آنها برمی گرداند.
ModelUtil.loadPreferences() : متد loadPreferences تنظیمات برگزیده را از فایل بارگیری می کند. از این در برنامه‌های جاوا مستقل استفاده کنید، که تنظیمات برگزیده را در زمان راه‌اندازی بارگیری نمی‌کنند.
ModelUtil.savePreferences() : متد savePreferences تنظیمات برگزیده را در فایل ذخیره می کند.
 |
هنگام بستن کادر گفتگوی Preferences و هنگام خروج از COMSOL Desktop، تنظیمات برگزیده نیز ذخیره می شوند. هنگامی که یک تین کلاینت را اجرا می کنید، با فراخوانی ModelUtil.disconnect() تنظیمات برگزیده ذخیره می شود (به دستورات Client-Server در زیر مراجعه کنید).
|
ModelUtil.uniquetag (پیشوند رشته) : متد uniquetag یک تگ مدل منحصر به فرد را با پیشوندی برمی گرداند که تگ باید به عنوان آرگومان ورودی شروع شود.
ModelUtil.modelsUsedByOtherClients() : متد modelsUsedByOtherClients تگ های مدل های استفاده شده توسط سایر کلاینت ها را برمی گرداند.
ModelUtil.blockOtherClients (بولی بلوکOtherClients) که سایر کلاینت ها را از سرور مسدود می کند. این دستور تنها زمانی معنادار است که چندین مشتری به سرور متصل باشند. فراخوانی ModelUtil.blockOtherClients (true) سایر کلاینت ها را مسدود می کند. وقتی کلاینت درخواست بلوک ModelUtil.blockOtherClients (نادرست) یا زمانی که ارتباط آن از سرور قطع می شود، مسدود شدن برداشته می شود.
دستورات مجوز
ModelUtil عملکردی را برای بررسی در دسترس بودن و کنترل پرداخت مجوزهای محصول COMSOL ارائه می دهد.
ModelUtil.hasProduct(String… product ) : روش hasProduct بررسی می کند که آیا مجوز فعلی اجازه می دهد تا محصولات COMSOL مشخص شده به عنوان ورودی (به عنوان آرایه ای از رشته ها) اجرا شود.
ModelUtil.hasProductForFile ( فایل رشته ) : روش hasProductForFile بررسی می کند که آیا مجوز فعلی به محصولات مشخص شده COMSOL مورد نیاز برای استفاده از فایل MPH COMSOL اجازه می دهد یا خیر.
ModelUtil.hasProductForFileonServer ( فایل رشته ) : روش hasProductForFileonServer شبیه hasProductForFile است اما بررسی می کند که آیا مجوز به محصولات COMSOL مشخص شده مورد نیاز برای یک فایل روی سرور اجازه می دهد یا خیر.
ModelUtil.checkoutLicense(String… product ) : روش checkoutLicense مجوزها را برای محصولات COMSOL که به عنوان ورودی (به عنوان آرایه ای از رشته ها) ارائه شده اند، بررسی می کند.
ModelUtil.checkoutLicenseForFile ( فایل رشته ) : روش checkoutLicenseForFile مجوزهای مورد نیاز برای استفاده از آن فایل MPH COMSOL را بررسی می کند.
ModelUtil.checkoutLicenseForFileonServer( فایل رشته ) : روش checkoutLicenseForFileonServer شبیه checkoutLicenseForFile است اما مجوزهای مورد نیاز برای استفاده از آن فایل MPH COMSOL را در سرور بررسی می کند.
جدول زیر محصولات موجودی را فهرست می‌کند که مجوزها را می‌توان از نظر در دسترس بودن بررسی کرد و با استفاده از نام‌های موجود در ستون نام بررسی کرد :
|
تولید – محصول
|
نام
|
|
ماژول AC/DC
|
AC DC
|
|
ماژول آکوستیک
|
آکوستیک
|
|
ماژول طراحی باتری
|
طراحی باتری
|
|
ماژول واردات CAD
|
CADIMPORT ، CADREADER
|
|
ماژول CFD
|
CFD
|
|
ماژول مهندسی واکنش شیمیایی
|
شیمی
|
|
عملکرد محاسبات خوشه ای
|
خوشه ای
|
|
ماژول مواد مرکب
|
مواد ترکیبی
|
|
ماژول خوردگی
|
خوردگی
|
|
ماژول طراحی
|
طرح
|
|
ماژول واردات ECAD
|
ECADIMPORT
|
|
ماژول الکتروشیمی
|
الکتروشیمی
|
|
ماژول رسوب الکتریکی
|
رسوب الکتریکی
|
|
ماژول خستگی
|
خستگی
|
|
وارد کردن فایل برای CATIA V5
|
CATIA5
|
|
پیل سوختی و ماژول الکترولایزر
|
FUELCELLANDELECTROLYZER
|
|
ماژول ژئومکانیک
|
ژئومکانیک
|
|
ماژول انتقال حرارت
|
انتقال حرارت
|
|
ماژول خواص مایع و گاز
|
مایعات و گاز
|
|
LiveLink™ برای AutoCAD®
|
LLAUTOCAD
|
|
LiveLink™ برای PTC® Creo® Parametric ™
|
LLCROPARAMETRIC
|
|
LiveLink™ برای Excel®
|
LLEXCEL
|
|
LiveLink™ برای Inventor®
|
LLINVENTOR
|
|
LiveLink™ برای MATLAB®
|
LLMATLAB
|
|
LiveLink™ برای Revit®
|
LLREVIT
|
|
LiveLink™ برای PTC® Pro/ENGINEER®
|
مهندس LL EXPERIENCE
|
|
LiveLink™ برای Solid Edge®
|
LLSOLIDEDGE
|
|
LiveLink™ برای SOLIDWORKS®
|
LLSOLIDWORKS
|
|
ماژول MEMS
|
MEMS
|
|
ماژول میکروسیال
|
میکروسیال ها
|
|
ماژول میکسر
|
میکسر
|
|
ماژول جریان مولکولی
|
جریان مولکولی
|
|
ماژول Dynamics Multibody
|
MULTIBODYDYNAMICS
|
|
ماژول مواد سازه ای غیر خطی
|
مواد ساختاری غیرخطی
|
|
ماژول بهینه سازی
|
بهينه سازي
|
|
ماژول ردیابی ذرات
|
ردیابی ذرات
|
|
ماژول جریان لوله
|
PIPEFLOW
|
|
ماژول پلاسما
|
پلاسما
|
|
ماژول جریان پلیمری
|
POLYMERFLOW
|
|
ماژول Ray Optics
|
RAYOPTICS
|
|
ماژول RF
|
RF
|
|
ماژول روتورینامیک
|
روتوردینامیک
|
|
ماژول نیمه هادی
|
نیمه هادی
|
|
ماژول مکانیک سازه
|
مکانیک سازه
|
|
ماژول جریان زیرسطحی
|
جریان زیرسطحی
|
|
ماژول کمی سازی عدم قطعیت
|
UQ
|
|
ماژول اپتیک موج
|
WAVEOPTICS
|
دستورات کلاینت-سرور
ModelUtil عملکردی را برای کنترل گزینه های مشتری-سرور COMSOL ارائه می دهد. می‌توانید اتصالات را از چندین کلاینت به یک سرور با استفاده از روش‌های اتصال و قطع اتصال ، وصل/قطع و کنترل کنید .
ModelUtil.connect () به یک سرور COMSOL (سرور COMSOL Multiphysics یا COMSOL Server™) متصل می شود. آرگومان های فرمان COMSOL -Dcs.host= <host> و -Dcs.port=< port> می توانند نام میزبان و شماره پورت را ارائه دهند. در صورتی که آن ها ارائه نشده باشند و کلاینت و سرور هر دو به یک سیستم فایل دسترسی داشته باشند، میزبان و پورت می توانند به طور خودکار منتقل شوند.
ModelUtil.connect( <host> , <port> ) به یک سرور COMSOL متصل می شود. آرگومان های <host> و <port> نام میزبان (یک رشته) و شماره پورت (یک عدد صحیح) را برای سرور COMSOL ارائه می کنند.
ModelUtil.connect( <host> , <port> , <user> , <password> ) به یک سرور COMSOL متصل می شود. آرگومان‌های <host> ، <port> ، <user> و <password> نام میزبان (رشته)، شماره پورت (یک عدد صحیح)، کاربر (یک رشته) و رمز عبور (یک رشته) را برای سرور COMSOL ارائه می‌کنند.
ModelUtil.connect( <host> , <port> , <encryption> ) و ModelUtil.connect( <host> , <port> , <encryption> , <user> , <password> ) با استفاده از رمزگذاری به سرور COMSOL متصل می شود. با تنظیم Boolean <encryption> روی false، از طرح ws WebSocket URIاستفاده می کندهنگامی که روی true تنظیم می شود، از طرح wss امن (SSL) WebSocket URI استفاده می کند.
ModelUtil.disconnect() از یک سرور COMSOL قطع می شود.
ModelUtil.setServerBusyHandler( <ServerBusyHandler> ) : از متد setServerBusyHandler برای ثبت یک ServerBusyHandler استفاده کنید . چندین کلاینت را می توان به یک سرور متصل کرد، اما تنها یک کلاینت در هر زمان می تواند از سرور بخواهد تا عملیاتی را انجام دهد. رفتار پیش‌فرض هنگام تلاش برای تماس با سرور زمانی که سرور مشغول است، صدور یک استثنا است. با ثبت یک ServerBusyHandler ممکن است مشتری منتظر بماند تا سرور دوباره آزاد شود، و یک بازه زمانی برای مدت زمان انتظار تعیین کنید.
ServerBusyHandler کلاسی است که مدت زمانی را که یک کلاینت منتظر می ماند تا یک سرور مشغول دوباره آزاد شود را کنترل می کند. همچنین دارای قلاب هایی برای انجام هر عملی در سمت مشتری قبل از شروع انتظار و بلافاصله پس از توقف برای انتظار است. برای تغییر رفتار پیش‌فرض،یک زیر کلاس در جاوا به ServerBusyHandler پیاده‌سازی کنید.
ServerBusyHandler() یک کنترلر مشغول به سرور ایجاد می کند که منتظر می ماند تا سرور بدون هیچ وقفه ای آزاد شود.
ServerBusyHandler( <timeOut> ) یک کنترل کننده مشغول سرور ایجاد می کند که منتظر می ماند تا سرور آزاد شود. زمان انتظار، <timeOut> ، بر حسب میلی ثانیه داده می شود.
postWaitForServer ( <boolean> ) قلابی است برای انجام هر عملی درست پس از انتظار برای آزاد شدن سرور.
preWaitForServer ( <host> , <username> ) قلابی برای انجام هر عملی قبل از شروع منتظر ماندن برای رایگان شدن سرور است. ورودی ها نام میزبان و نام کاربری به عنوان رشته هستند.
ModelUtil.setModelChangedHandler(<ModelChangedHandler>) : متد etModelChangedHandler کنترل کننده تغییرات مدل های ایجاد شده توسط مشتریان دیگر را ثبت می کند. اگر هر کلاینت دیگری هر مدلی را در حال استفاده توسط این کلاینت تغییر دهد، به کنترل کننده تغییر مدل اطلاع داده می شود.
ModelChangedHandler یک رابط برای مدیریت به‌روزرسانی‌های کلاینت است، زمانی که کلاینت دیگری مدل‌های مورد استفاده این کلاینت را تغییر داده است. برای تغییر رفتار پیش فرض، رابط را در جاوا پیاده سازی کنید. handleModelChangeOnServer ( <modelChangeInfo> ) زمانی فراخوانی می شود که کلاینت دیگری هر مدلی را که توسط این کلاینت استفاده می شود تغییر داده باشد. رابط ModelChangedHandler شامل متد Boolean triggeredByChangesFromThisClient( ) است. این یک پیاده سازی پیش فرض دارد که false را برمی گرداند. در این مورد، روش handleModelChangeOnServer ( <modelChangeInfo> ) تنها زمانی فراخوانی می شود که کلاینت دیگری مدل را تغییر دهد. اگر triggeredByChangesFromThisClient() true را برمی گرداندhandleModelChangeOnServer( <modelChangeInfo> ) همچنین زمانی فراخوانی می شود که کلاینت ثبت کننده ModelChangedHandler مدل را تغییر دهد.
ModelChangeInfo یک کلاس با اطلاعاتی در مورد تغییرات مدل‌ها توسط مشتریان دیگر است.
getModelTags() تگ های مدل هایی را که تغییر کرده اند برمی گرداند.
روش scanModel
روش scanModel یک ابزار پیشرفته است که داده های خام یک فایل مدل را برای یک نوع گره خاص اسکن می کند و برچسب و برچسب تمام گره هایی را که پیدا می کند جمع آوری می کند . برای اطلاعات بیشتر به اسکن مدل ها مراجعه کنید .
