model.cpl()
کوپلینگ های غیر محلی اضافه کنید.
نحو
model.component( <ctag> ).cpl().create( <tag> , type , <gtag> );
model.component( <ctag> ).cpl( <tag> ).set( خاصیت , <value> );
model.component( <ctag> ).cpl( <tag> ).set(“opname”, <opname> )
model.component( <ctag> ).cpl( <tag> ).selection( خاصیت ).named( <seltag> );
model.component( <ctag> ).cpl( <tag> ).selection( خاصیت ).set(…);
model.component( <ctag> ).cpl( <tag> ).create( <subtag> , subtype );
model.component( <ctag> ).cpl( <tag> ).feature( <subtag> ).getAllowedPropertyValues( خاصیت );
model.component( <ctag> ).cpl( <tag> ).feature( <subtag> ).set( property , <value> );
model.component( <ctag> ).cpl( <tag> ).get Type ( خاصیت , <value> );
model.component( <ctag> ).cpl( <tag> ).feature( <subtag> ).properties();
model.component( <ctag> ).cpl( <tag> ).feature( <subtag> ).get Type ( خاصیت , <value> );
model.component( <ctag> ).cpl( <tag> ).hasProperty(string pname);
model.component( <ctag> ).cpl( <tag> ).image();
model.component( <ctag> ).cpl( <tag> ).set(string pname, int value);
model.component( <ctag> ).cpl( <tag> ).set(string pname, int pos, int value);
model.component( <ctag> ).cpl( <tag> ).set(string pname, int pos, int[] value);
model.component( <ctag> ).cpl( <tag> ).set(string pname, int pos1, int pos2, int value);
model.component( <ctag> ).cpl( <tag> ).setIndex(نام رشته، مقدار رشته، شاخص int);
model.component( <ctag> ).cpl( <tag> ).setIndex(نام رشته، مقدار رشته، int firstIndex،
int secondIndex);
int secondIndex);
model.component( <ctag> ).cpl( <tag> ).setIndex(نام رشته، مقدار رشته[]، شاخص int);
model.component( <ctag> ).cpl( <tag> ).setIndex(نام رشته، مقدار دوگانه، شاخص int);
model.component( <ctag> ).cpl( <tag> ).setIndex(نام رشته، مقدار دوگانه، int firstIndex،
int secondIndex);
int secondIndex);
model.component( <ctag> ).cpl( <tag> ).setIndex(نام رشته، مقدار دوگانه[]، شاخص int);
model.component( <ctag> ).cpl( <tag> ).setIndex(نام رشته، مقدار int، شاخص int);
model.component( <ctag> ).cpl( <tag> ).setIndex(نام رشته، مقدار رشته، شاخص int);
model.component( <ctag> ).cpl( <tag> ).setIndex(نام رشته، مقدار رشته، شاخص int);
model.component( <ctag> ).cpl( <tag> ).setIndex(نام رشته، مقدار int، int firstIndex،
int secondIndex);
int secondIndex);
model.component( <ctag> ).cpl( <tag> ).setIndex(نام رشته، مقدار int[]، شاخص int);
آرگومان های شاخص/موقعیت متدهای set() مبتنی بر 1 هستند. آرگومان های شاخص/موقعیت متدهای setIndex() بر پایه 0 هستند.
شرح
model.component( <ctag> ).cpl().create( <tag> , type , <gtag> ) یک جفت غیر محلی از نوع نوع در هندسه <gtag> ایجاد می کند . انواع پشتیبانی شده عبارتند از GeneralExtrusion , LinearExtrusion , BoundarySimilarity , IdentityMapping , GeneralProjection , LinearProjection , Integration , Average , Maximum , Minimum. عملگرهای جفت غیرمحلی جفت مقادیر را معمولاً از یک منبع به مقصد بین یا درون اجزای مدل ارائه می کنند.
model.component( <ctag> ).cpl( <tag> ).selection().named( <seltag> ) منبع جفت غیر محلی را به انتخاب نامگذاری شده <seltag> اختصاص می دهد . model.cpl( <tag> ).selection().set(…) یک انتخاب محلی را تعریف می کند که منبع جفت غیر محلی را به موجودیت های هندسی اختصاص می دهد. برای فهرست کاملی از روشهای موجود در انتخاب () ، به انتخابها مراجعه کنید .
model.component( <ctag> ).cpl( <tag> .set( خاصیت , <value> ) خصوصیات مربوط به نوع جفت غیر محلی انتخابی را مشخص می کند. زیر را ببینید.
model.component( <ctag> ).cpl(<tag>).set(“opname”, <opname> ) نام اپراتور جفت غیر محلی را تنظیم می کند. نام اپراتور جفت غیر محلی پیش فرض <tag> است .
model.component( <ctag> ).cpl( <tag> ).selection( خاصیت ).named( <seltag> ) ویژگی انتخاب جفت غیر محلی را به انتخاب نامگذاری شده <seltag> اختصاص می دهد . model.component( <ctag> ).cpl( <tag> ).selection( خاصیت ).set(…) یک انتخاب محلی را تعریف می کند که ویژگی انتخاب جفت غیر محلی را به موجودیت های هندسی اختصاص می دهد. برای فهرست کاملی از متدهای موجود در انتخاب () ، به model.selection() مراجعه کنید .
model.component( <ctag> ).cpl( <tag> ).create( <subtag> , subtype ) یک ویژگی فرعی از نوع subtype ایجاد می کند . این تنها زمانی قابل انجام است که نوع جفت غیر محلی BoundarySimilarity باشد . مقادیر پشتیبانی شده زیرنوع عبارتند از OnePointMap ، TwoPointMap و EdgeMap .
model.component( <ctag> ).cpl( <tag> ).selection().named() انتخاب منبع نامگذاری شده جفت را برمی گرداند.
model.component( <ctag> ).cpl( <tag> ).selection().get Type (…) انتخاب منبع را پرس و جو می کند.
model.component( <ctag> ).cpl( <tag> ).properties() لیستی از ویژگی های اختصاص داده شده را به عنوان یک آرایه رشته ای برمی گرداند.
model.component( <ctag> ).cpl( <tag> ).get Type ( خاصیت ) مقدار یک ویژگی مشخص شده را برمی گرداند.
model.component( <ctag> ).cpl( <tag> ).selection( خاصیت ).named() تگ انتخاب نامگذاری شده ویژگی انتخاب را برمی گرداند.
model.component( <ctag> ).cpl( <tag> ).selection( خاصیت ).get Type (…) یک ویژگی انتخاب را درخواست می کند.
model.component( <ctag> ).cpl(< tag >).feature(< subtag >)).getAllowedPropertyValues(property) مجموعه مقادیر مجاز برای یک ویژگی را برمی گرداند اگر مجموعه مجموعه محدودی از رشته ها باشد. در غیر این صورت، null برمی گرداند.
از متد model.component( <ctag> ).cpl( <tag> .image() برای ایجاد نمودار یا صادرات تصاویر استفاده کنید . به ترسیم و صادرات تصاویر مراجعه کنید .
نماد: srcedim = بعد انتخاب منبع. srcsdim = بعد فضای هندسه منبع.
کوپلینگ های اکستروژن
یک اپراتور کوپلینگ اکستروژن غیرمحلی یک عبارت e تعریف شده در (بخشی از) انتخاب منبع را به یک عبارت oper(e) که می تواند در (بخشی از) هندسه مقصد ارزیابی شود، نگاشت می کند. برای هر نقطه p s در انتخاب منبع، می تواند صفر، یک یا چند نقطه متناظر p d در مقصد وجود داشته باشد. نگاشت معکوس p s = m ( p d ) همیشه یک به یک است. مقدار oper(e) در نقطه p d به عنوان مقدار e در نقطه تعریف می شودp s .
نگاشت معکوس m به عنوان ترکیب نقشه مقصد m d و معکوس نقشه منبع m s مشخص می شود : p s = m ( p d ) = m s − 1 ( m d ( p d )) . به عبارت دیگر، m s ( p s ) = m d ( p d ) – هم نقشه مقصد و هم نقشه منبع در یک فضای میانی یکسان. برای همه انواع عملگر به جز GeneralExtrusion ، فضای میانی با هندسه منبع منطبق است. نقشه منبع همیشه یک به یک است. به طور پیش فرض، نقشه منبع هویت است.
نوع اپراتور نوع نقشه مقصد را تعیین می کند:
نوع کوپلینگ | نقشه مقصد |
جنرال اکستروژن | نقشه غیر خطی توصیف شده توسط عبارات. |
اکستروژن خطی | نقشه خطی که با نگاشت راس توصیف شده است. |
شباهت مرزی | تبدیل تشابه با نگاشت مرزها توصیف شده است. همچنین توسط مش کپی استفاده می شود. |
IdentityMapping | نقشه هویت |
برای اکثر این انواع جفت، می توان از یک نقشه منبع توصیف شده با عبارات (احتمالاً غیرخطی) استفاده کرد.
ویژگی | ارزش | پیش فرض | شرح |
اکستل | دو برابر | 0.3 | تحمل برون یابی در جستجوی مش. |
روش | usetol | نزدیکترین | راه رفتن | usetol | روش جستجوی مش: تحمل، نزدیکترین نقطه، یا راه رفتن در یک جزء متصل. |
استفاده کنید | در | خاموش | خاموش | هنگامی که نقطه منبع خارج از انتخاب است، به جای پیام خطا از NaN استفاده کنید. |
اگر متد=usetol ، oper(e) زمانی تعریف میشود که نقطه منبع ps در انتخاب منبع باشد، یا اگر کمی خارج باشد . تلورانس در ویژگی exttol داده شده است ، که یک فاصله در مختصات محلی عنصر مش است. یعنی اندازه ای نسبت به اندازه عنصر مش است. اگر oper(e) تعریف نشده باشد، یک پیغام خطا داده می شود (اگر usenan=off )، یا مقدار NaN برگردانده می شود (اگر usenan=on ).
اگر method=closest ، از یک روش جستجوی brute force استفاده میشود که باعث میشود oper(e) در همه جا تعریف شود (نزدیکترین نقطه به ps در انتخاب منبع استفاده میشود).
اگر روش = راه رفتن ، یک راه رفتن از طریق مش منبع ایجاد می شود. اگر کامپوننت متصل نیست از این روش استفاده نکنید.
بسته به نوع کوپلینگ، خواص اضافی در دسترس است (به زیر مراجعه کنید).
جنرال اکستروژن
یک اپراتور کوپلینگ اکستروژن عمومی غیرمحلی یک عبارت تعریف شده بر روی یک منبع را به یک عبارتی که می تواند در هر هندسه مقصدی که عبارات نقشه مقصد معتبر هستند، ارزیابی کند، نگاشت می کند.
ویژگی | ارزش | پیش فرض | شرح |
dstmap | آرایه رشته ای | مختصات فضایی | عبارات نقشه مقصد m d ( p d ) . |
srcframe | مش | مواد | فضایی | فضایی | قاب برای مش منبع. |
usercmap | در | خاموش | خاموش | از نقشه منبع استفاده کنید |
srcmap | آرایه رشته ای | مختصات فضایی | عبارات نقشه منبع m s ( p s ) . |
عبارات دنباله و mpty در ویژگی های dstmap و srcmap نادیده گرفته می شوند. عبارات باقی مانده باید از نظر تعداد برابر باشند و این idim بعد فضای میانی را تعیین می کند. مورد نیاز: srcedim <= idim <= srcsdim . تغییر انتخاب منبع اثر جانبی تغییر dstmap و srcmap دارد تا این نیاز برآورده شود. به طور پیش فرض، idim=srcsdim .
مش منبع در قاب srcframe مشاهده می شود . نگاشت منبع به صورت خطی در هر عنصر مش منبع در نظر گرفته می شود.
اگر usercmap=off ، ویژگی srcmap استفاده نمی شود. در این مورد، dstmap یک نگاشت از مقصد به مبدأ (مشاهده در قاب srcframe ) و idim=srcsdim است .
اکستروژن خطی
یک اپراتور کوپلینگ اکستروژن خطی غیرمحلی به صورت خطی یک عبارت تعریف شده در یک منبع را به عبارتی که می تواند در مقصد ارزیابی شود، نگاشت می کند.
ویژگی | ارزش | پیش فرض | شرح |
srcvertexN | انتخاب | شماره راس منبع N | |
dstgeom | رشته | هندسه منبع | هندسه مقصد |
dstvertexN | انتخاب | شماره راس مقصد N | |
srcframe | مش | مواد | فضایی | فضایی | چارچوب برای ارزیابی مختصات راس منبع |
dstframe | مش | مواد | فضایی | فضایی | چارچوبی برای ارزیابی مختصات راس مقصد |
usercmap | در | خاموش | خاموش | از نقشه منبع استفاده کنید |
srcmap | رشته[srcsdim] | مختصات فضایی | عبارات نقشه منبع m s ( p s ) |
تعداد انتخابهای srcvertexN و dstvertexN 4 است. اینها فقط برای 1<=N<=dim+1 استفاده میشوند ، جایی که dim عددی کوچکتر یا مساوی min(srcsdim,dstsdim) است . انتخاب های 4 کم نور باقی مانده باید خالی باشند.
نقشه مقصد، نقشه خطی (آفتی) زیر از هندسه مقصد تا هندسه مبدا است:
1 | اول، اگر dim<dstsdim ، یک طرح متعامد بر روی فضای نزدیک که توسط رئوس مقصد در بر می گیرد. تعداد رئوس مقصد dim+1 است . بنابراین، dim=2 یک صفحه و dim=1 یک خط می دهد. |
2 | سپس، یک نقشه خطی (affine) رئوس مقصد را بر روی رئوس مبدأ نگاشت می کند. |
BoundarySimilarity (3D)
یک اپراتور جفت شباهت مرزی غیرمحلی عبارتی را که روی بخشی از یک مرز تعریف شده است به قسمت دیگری از مرز با همان شکل نگاشت می کند.
ویژگی | ارزش | پیش فرض | شرح |
مقصد | انتخاب | چهره مقصد. | |
usercmap | در | خاموش | خاموش | از نقشه منبع استفاده کنید |
srcmap | رشته[srcsdim] | مختصات فضایی | عبارات نقشه منبع m s ( p s ) . |
تبدیل مقصد یک تبدیل شباهت است که یک چهره مقصد ( مقصد ) را بر روی مجموعهای از چهرههای مبدا (انتخاب منبع) ترسیم میکند. مش همیشه در قاب مش مشاهده می شود.
بهطور پیشفرض، الگوریتم بهطور خودکار یک تبدیل را زمانی انتخاب میکند که تقارن چندین تبدیل را ممکن میسازد. برای کنترل این انتخاب می توان یکی از ویژگی های فرعی زیر را به صورت سه بعدی اضافه کرد.
ویژگی فرعی | ملاحظات |
EdgeMap | نحوه نگاشت یک لبه منبع را مشخص کنید. |
OnePointMap | نحوه ترسیم یک راس منبع را مشخص کنید. |
TwoPointMap | نحوه ترسیم دو رأس منبع را مشخص کنید. |
EdgeMap
یک نقشه لبه مشخص می کند که یک یال مقصد خاص باید بر روی یک لبه منبع مشخص نگاشت شود. جهت نسبی آنها توسط جهت مالکیت داده می شود . لبه ها باید مجاور وجه های داده شده باشند.
ویژگی | ارزش | پیش فرض | شرح |
srcdgedge | انتخاب | لبه منبع | |
dsstedge | انتخاب | لبه مقصد | |
جهت | خودکار | همان | مقابل | خودکار | جهت لبه |
OnePointMap
یک نقشه یک نقطه ای مشخص می کند که یک راس مقصد خاص باید بر روی یک راس منبع مشخص نگاشت شود.
ویژگی | ارزش | پیش فرض | شرح |
srcpoint1 | انتخاب | راس در صورت منبع | |
dstpoint1 | انتخاب | راس در صورت مقصد |
TwoPointMap
یک نقشه دو نقطه ای مشخص می کند که دو رأس مقصد باید روی دو راس مبدا نگاشت شوند.
ویژگی | ارزش | پیش فرض | شرح |
srcpoint1 | انتخاب | راس 1 در صورت منبع | |
srcpoint2 | انتخاب | راس 2 در صورت منبع | |
dstpoint1 | انتخاب | راس 1 در وجه مقصد | |
dstpoint2 | انتخاب | راس 2 در صورت مقصد |
BoundarySimilarity (2D)
ویژگی | ارزش | پیش فرض | شرح |
مقصد | انتخاب | لبه مقصد | |
جهت | خودکار | همان | مقابل | خودکار | جهت لبه |
usercmap | در | خاموش | خاموش | از نقشه منبع استفاده کنید |
srcmap | رشته[srcsdim] | مختصات فضایی | عبارات نقشه منبع m s ( p s ) |
تبدیل مقصد یک تبدیل شباهت است که یک یال مقصد ( مقصد ) را بر روی مجموعهای از لبههای منبع (انتخاب منبع) ترسیم میکند. جهت نسبی آنها توسط جهت مالکیت داده می شود . مش همیشه در قاب مش مشاهده می شود.
IdentityMapping
یک اپراتور کوپلینگ نگاشت هویت غیرمحلی، بین موجودات هندسی که احتمالاً در فریم های مختلف مشاهده می شوند، با هم همپوشانی دارند، نقشه می کشد. تبدیل مقصد یک نگاشت هویت بین فریم های داده شده است.
ویژگی | ارزش | پیش فرض | شرح |
dstframe | مش | مواد | فضایی | فضایی | چارچوب برای ارزیابی مختصات مقصد |
srcframe | مش | مواد | فضایی | فضایی | چارچوب برای ارزیابی مختصات منبع |
کوپلینگ های پروجکشن
اپراتور کوپلینگ پروجکشن یک عبارت e تعریف شده در (بخشی از) انتخاب منبع را به یک عبارت oper(e) نگاشت می کند که می تواند بر روی (بخشی از) هندسه مقصد ارزیابی شود. این کار را با انجام یکپارچه سازی در امتداد منحنی ها در انتخاب منبع انجام می دهد. این منحنی ها مربوط به خطوطی در یک فضای میانی است که ابعاد آنها برابر با srcedim است . یک نقشه منبع وجود دارد که انتخاب منبع را در فضای میانی نگاشت می کند و یک نقشه مقصد m d وجود داردنگاشت هندسه های مقصد در زیرفضای فضای میانی که آخرین مختصات آن صفر است. نقشه منبع همیشه یک به یک است. مقدار oper(e) در نقطه مقصد p d به صورت زیر تعریف می شود:
1 | در فضای میانی، خطی را در نظر بگیرید که موازی با آخرین محور مختصات است و از نقطه m d ( p d ) می گذرد . |
2 | با استفاده از معکوس نقشه منبع، این خط را به منحنی در انتخاب منبع نگاشت کنید. |
3 | عبارت e را روی این منحنی ادغام کنید. |
این بدان معناست که مقدار oper(e) در نقطه مقصد p d انتگرال e در امتداد یک منحنی از طریق نقطه مبدا p s = m s – 1 ( m d ( p d )) است .
نوع کوپلینگ نوع نقشه ها را تعیین می کند:
نوع کوپلینگ | انواع نقشه |
پروژکتور عمومی | نقشه غیر خطی توصیف شده توسط عبارات |
طرح خطی | نقشه خطی که با نگاشت راس توصیف شده است |
ویژگی | ارزش | پیش فرض | شرح |
سرزده | بین المللی | 4 | ترتیب فرمول یکپارچه سازی |
بسته به نوع کوپلینگ، ویژگی های اضافی در دسترس است، به زیر مراجعه کنید.
پروژکتور عمومی
برای تعریف ادغام در امتداد منحنی ها از یک جفت طرح کلی غیر محلی استفاده کنید.
ویژگی | ارزش | پیش فرض | شرح |
dstmap | رشته[srcedim-1] | مختصات فضایی | عبارات نقشه مقصد m d ( p d ) |
srcframe | مش | مواد | فضایی | فضایی | قاب برای مش منبع. |
srcmap | رشته[srcedim] | مختصات فضایی | عبارات نقشه منبع m s ( p s ) |
طرح خطی
یک اپراتور کوپلینگ طرح ریزی خطی غیرمحلی ، یک نگاشت بین مقصد و منبع را تعریف می کند که توسط یک نقشه خطی تعریف شده توسط رئوس ارائه می شود. فرض کنید v بردار اولین راس منبع تا آخرین راس منبع باشد. مقدار oper(e) در یک نقطه p d برابر است با انتگرال e روی خطی که از نقطه عبور می کند p s =m s -1 ( m d ( p d )) با بردار جهت v .
ویژگی | ارزش | پیش فرض | شرح |
srcvertexN | انتخاب | شماره راس منبع N. | |
dstgeom | رشته | هندسه منبع | هندسه مقصد |
dstvertexN | انتخاب | شماره راس مقصد N. | |
srcframe | مش | مواد | فضایی | فضایی | چارچوب برای ارزیابی مختصات راس منبع. |
dstframe | مش | مواد | فضایی | فضایی | چارچوبی برای ارزیابی مختصات راس مقصد. |
تعداد انتخاب های srcvertexN 4 است. این ها فقط برای 1<=N<=srcedim+1 استفاده می شوند . انتخاب های باقی مانده باید خالی باشند. تعداد رئوس منبع srcedim+1 است . نقشه مبدأ یک نقشه خطی است که رئوس منبع را بر روی نقاط 0 , e 1 , e 2 , …, e srcedim در فضای میانی ترسیم می کند که e i بردار واحد یکم است .
تعداد انتخاب های dstvertexN 4 است. این ها فقط برای 1<=N<=srcedim استفاده می شوند . انتخاب های باقی مانده باید خالی باشند. تعداد رئوس مقصد srcedim است . نقشه مقصد، نقشه خطی (آفتی) زیر از هندسه مقصد تا فضای میانی است:
1 | اول، اگر srcedim-1<dstsdim ، یک پیشبینی متعامد بر روی فضای نزدیک که توسط رئوس مقصد در بر میگیرد. بنابراین srcedim=3 یک صفحه و srcedim=2 یک خط می دهد. |
2 | سپس، یک نقشه خطی (affine) که رئوس مقصد را بر روی نقاط 0 , e 1 , e 2 , …, e srcedim-1 در فضای میانی ترسیم می کند، جایی که e i من بردار واحد است . |
کوپلینگ های یکپارچه سازی
ادغام
بهطور پیشفرض، یک اپراتور کوپلینگ ادغام غیرمحلی، عبارت e را روی انتخاب منبع ادغام میکند . مقدار حاصل از oper (e) را می توان در هر جایی استفاده کرد. اگر method=summation ، عبارت بر روی گره های انتخاب منبع جمع می شود.
ویژگی | ارزش | پیش فرض | شرح |
سرزده | رشته | 4 | دستور ادغام |
قاب | مش | مواد | فضایی | فضایی | قاب برای ادغام (عنصر حجم را تعیین می کند). |
روش | ادغام | جمع بندی | ادغام | روش محاسبه. |
میانگین
یک عملگر کوپلینگ متوسط غیر محلی ، عبارت e را روی انتخاب منبع ادغام می کند و با اندازه گیری انتخاب منبع تقسیم می کند. مقدار حاصل از oper(e) را می توان در هر جایی استفاده کرد.
ویژگی | ارزش | پیش فرض | شرح |
سرزده | رشته | 4 | دستور ادغام |
قاب | مش | مواد | فضایی | فضایی | قاب برای ادغام (عنصر حجم را تعیین می کند). |
حداکثر/حداقل
یک عملگر کوپلینگ حداکثر یا حداقل غیرمحلی، حداکثر یا حداقل یک عبارت e را در انتخاب منبع پیدا می کند. مقدار حاصل از oper(e) را می توان در هر جایی استفاده کرد. آرگومان دوم اختیاری در نقطه ای ارزیابی می شود که آرگومان اول حداکثر یا حداقل خود را دارد. به عنوان مثال، از x ، y ، یا z برای بدست آوردن مکان مختصات حداکثر یا حداقل استفاده کنید .
ویژگی | ارزش | پیش فرض | شرح |
سرزده | رشته | 4 | قانون ادغام |
نکته ها | گره | ادغام | لاگرانژ | گره | نوع نقطه |
سرزده | رشته | 4 | دستور ادغام |
لاگرانژ | رشته | 2 | دستور لاگرانژ. |
حداکثر/حداقل با ارزیابی عبارت در نقاط مشخص شده تقریبی می شود.