Редактирование: Измерение и вычисление геометрических характеристик

[[Category:Макро]]
Команды данного раздела вычисляют различные геометрические характеристики объектов.

==Определение координат точки==
[[Файл:coordinate.png|thumb|right|Информация об измеренной точке]]
<code>'''coordinate''' ''&lt;Point&gt;''<nowiki> [info] done</nowiki></code>

Команда '''coordinate''' определяет координаты точки <code>''&lt;Point&gt;''</code> и выводит их в окно ввода команд. Необязательный ключ <code>info</code> позволяет отобразить параметры точки в диалоговом окне (см. рисунок).

Чтобы сохранить координаты в массиве, нужно перед ключевым словом ввести имя массива из трех и более элементов. Массив должен быть предварительно описан.

Пример:
 defarr c[3];
 #c coordinate 10,20,40 done;
 =c[1];
 <font color="008800">10</font>
 =c[2];
 <font color="008800">20</font>
 =c[3];
 <font color="008800">30</font>

==Определение расстояния==
[[Файл:distance.png|thumb|200px|right|Информация об измеренном расстоянии]]
<code>'''distance''' point ''&lt;Point1&gt; | ''object'' &lt;Object1&gt; ''point'' &lt;Point2&gt; ''object'' &lt;Object2&gt;''<nowiki> [info] [mark] done</nowiki></code>

Команда '''distance''' измеряет расстояние между точкой (point) <code>''&lt;Point1&gt;</code> ''или объектом (object) <code>''&lt;Object1&gt;''</code> и другой точкой <code>''&lt;Point2&gt;''</code> или объектом <code>''&lt;Object2&gt;''</code>. Ключ info отображает данные о расстоянии в диалоговом окне (см. рисунок). Ключ <code>mark</code> создает две точки на концах отрезка, соединяющего точки или объекты, между которыми измерено расстояние.
{| class="prettytable"
|-
|valign="top"|[[image:pluso.png]]
| Ключи ''<code>point''</code> и ''<code>object''</code> взаимоисключающие. По умолчанию измеряется расстояние между точками.
|}

Чтобы сохранить измеренное расстояние в переменной, нужно перед ключевым словом ввести имя переменной.

Пример:
 #par distance 0,0,0 100,0,0 done;
 =par
 <font color="008800">100</font>

==Вычисление длины кривой==
<code>'''clength''''' &lt;Object&gt; ''done</code>

Команда '''clength''' вычисляет длину кривой <code>''&lt;Object&gt;''.</code>

Чтобы сохранить измеренное расстояние в переменной, нужно перед ключевым словом ввести имя переменной.

==Определение угла==
[[Файл:angle.png|thumb|right|Информация об измеренном угле]]
Команда '''angle''' имеет несколько режимов работы, которые представлены ниже.

<code><nowiki>angle [acuteangle | normal </nowiki>''&lt;Point0&gt;''] ''&lt;Point1&gt; &lt;Point2&gt; &lt;Point3&gt;''<nowiki> [info] done</nowiki></code>

Команда измеряет угол, определяемый точками <code>''&lt;Point1&gt;</code>, <code>&lt;Point2&gt;''</code> и <code>''&lt;Point3&gt;''</code>. Точка <code>''&lt;Point1&gt;''</code> является вершиной измеряемого угла, а точки <code>''&lt;Point2&gt;''</code> и <code>''&lt;Point3&gt;''</code> определяют его стороны. Стоит отметить, что измеряется угол, направленный против часовой стрелки между лучами из точки <code>''&lt;Point1&gt;''</code> в точки <code>''&lt;Point2&gt;''</code> и <code>''&lt;Point3&gt;''</code>.Этот угол может быть как больше, так и меньше 180 градусов. Если задан необязательный ключ <code>acuteangle</code>, то измеряется всегда угол меньше 180 градусов.

Если задан ключ <code>normal</code>, то угол измеряется не между точками, а между проекциями точек на плоскость, нормаль к которой задается вектором <code>''&lt;Point0&gt;</code>.''

Ключ <code>info</code> отображает данные об угле в диалоговом окне (см. рисунок).


<code>'''angle''' 2segment ''&lt;Object1&gt; &lt;Object2&gt; ''<nowiki> [</nowiki>info] done</code>

Команда определяет минимальный угол между прямыми, определяемыми отрезками <code>''&lt;Object1&gt;''</code> и <code>''&lt;Object2&gt;''</code>. Указанные прямые должны пересекаться.


<code>'''angle''''' ''<nowiki>2plane [point </nowiki>''&lt;Point1&gt;'']''&lt;Object1&gt;, ...''<nowiki> [point </nowiki>''&lt;Point&gt;'']'' &lt;Object2&gt;, … ''<nowiki>[</nowiki>info] done</code>

Команда определяет угол между двумя плоскостями. Плоскости могут задаваться либо одним объектом (дуга или окружность), либо двумя отрезками, лежащими в одной плоскости, либо отрезком и точкой, либо тремя точками.

Чтобы сохранить измеренный угол в переменной, нужно перед ключевым словом ввести имя переменной.

==Определение угла вектора==
[[Файл:vangle.png|thumb|right|Информация об углах вектора]]
<code>vangle axis | plane | xy | yz | zx ''&lt;Object&gt;''<nowiki> [</nowiki>info] done</code>

Команда '''vangle''' измеряет углы вектора (отрезка) <code>''&lt;Object&gt;''</code> с координатными осями (<code>axis</code>), либо с координатными плоскостями (<code>plane</code>), либо углы проекции вектора на соответствующую координатную плоскость с координатными осями (<code>xy</code>, <code>yz</code>, <code>zx</code>). Вместо объекта <code>&lt;Object&gt;</code> допускается указание координат ловушки (<code>''&lt;^x,y,z&gt;''</code>), в которую должен попасть выбранный объект. Принципиальное значение имеет тот конец отрезка, который оказался ближе к ловушке, поскольку он определяет направление вектора.

Ключ <code>info</code> отображает данные об угле в диалоговом окне (см. рисунок).

Чтобы сохранить координаты в массиве, нужно перед ключевым словом ввести имя массива из двенадцати элементов. Интерпретация информации в массиве представлена на рисунке. Массив должен быть предварительно описан.
{| class="prettytable"
|-
|valign="top"|[[image:pluso.png]]
|Поскольку данная команда определяет направление вектора, то в макропрограммах обязательно использование координат ловушки. При этом следует помнить, что никакой другой объект в ловушку попасть не должен.
|}

==Определение масс-инерционных характеристик==
[[Файл:mix.png|thumb|right|Масс-инерционные характеристики твердого тела]]
<code>'''mix''' [density ''&lt;Dens&gt;''] [nodc] [Wholly|Partly]'' &lt;Objects&gt; ''done</code>

Команда '''mix''' определяет масс-инерционные характеристики объектов <code>''&lt;Objects&gt;</code> ''типа '''«Тело»'''. Результат работы команды представлен на рисунке.

Ключ <code>density</code> позволяет задать плотность тел <code>''&lt;Dens&gt;''</code>. Данный ключ используется, если у тел плотность не задана явно атрибутом '''$Density'''.

Ключ <code>nodc</code> запрещает вывод информации в диалоговое окно.

''Начиная с версии от 19 декабря 2019 года'' доступны ключи <code>Wholly</code> и <code>Partly</code>. Они позволяют выбрать объекты на любом уровне — соответственно, '''Целиком''' и '''Частично'''. По умолчанию в макропрограммировании активизируется ключ <code>Wholly</code>. ''В более ранних версиях (до 19.12.2019) эти ключи недоступны, команда работает только в режиме''''' Целиком'''.

Чтобы сохранить координаты в массиве, нужно перед ключевым словом ввести имя массива из девятнадцати элементов. Интерпретация информации в массиве представлена в таблице. Массив должен быть предварительно описан.
{| class="wikitable"
|+Масс-инерционные характеристики объекта
!
<center>'''Номер элемента'''</center>

!
<center>'''Назначение'''</center>

|-
|
<center>1</center>

|
Площадь поверхности (S)

|-
|
<center>2</center>

|
Объем тела (V)

|-
|
<center>3</center>

|
Масса тела (m)

|-
|
<center>4</center>

|
Вес тела (P) 

|-
|
<center>5</center>

|
Статический момент (Sxy)

|-
|
<center>6</center>

|
Статический момент (Syz)

|-
|
<center>7</center>

|
Статический момент (Szx)

|-
|
<center>8</center>

|
Осевой момент инерции (Jox)

|-
|
<center>9</center>

|
Осевой момент инерции (Joy)

|-
|
<center>10</center>

|
Осевой момент инерции (Joz)

|-
|
<center>11</center>

|
Плоскостной момент инерции (Jxy)

|-
|
<center>12</center>

|
Плоскостной момент инерции (Jyz)

|-
|
<center>13</center>

|
Плоскостной момент инерции (Jzx)

|-
|
<center>14</center>

|
Центробежный момент инерции (Mxy)

|-
|
<center>15</center>

|
Центробежный момент инерции (Myz)

|-
|
<center>16</center>

|
Центробежный момент инерции (Mzx)

|-
|
<center>17</center>

|
Координата X центра масс

|-
|
<center>18</center>

|
Координата Y центра масс

|-
|
<center>19</center>

|
Координата Z центра масс

|}

==Определение площади поверхности==
<code>'''square''''' ''[partly|wholly]'' &lt;Objects&gt;''</code>

Команда '''square''' вычисляет площадь поверхности объектов <code>''&lt;Objects&gt;''</code>. Если в качестве объектов <code>''&lt;Objects&gt;''</code> указана группа, то вычисляется площадь поверхности всех входящих в нее тел и поверхностей ('''Brep'''-ов).

Чтобы сохранить измеренную площадь поверхности в переменной, нужно перед ключевым словом ввести имя переменной.

==Определение массы и центра масс==
<code>'''amass''''' &lt;Objects&gt; ''yes | no</code>

Команда '''amass''' определяет массу и координаты центра масс объектов <code>''&lt;Objects&gt;</code> ''типа '''«Тело»'''. Ключ yes указывает, что нужно создать точку в центре масс объектов <code>''&lt;Objects&gt;''</code>. Ключ no указывает, что точку создавать не нужно.

Чтобы сохранить массу и координаты центра масс в массиве, нужно перед ключевым словом ввести имя массива из четырех элементов. Интерпретация информации в массиве представлена в таблице. Массив должен быть предварительно описан.

{| class="wikitable"
|+ Масса и центр масс объектов
!
<center>'''Номер элемента'''</center>

!
<center>'''Назначение'''</center>

|-
|
<center>1</center>

|
Масса объектов

|-
|
<center>2</center>

|
Координата X центра масс

|-
|
<center>3</center>

|
Координата Y центра масс

|-
|
<center>4</center>

|
Координата Z центра масс

|}

==Определение габаритов объекта==

'''ObjGab, ObjGab1, ObjGab2, ObjGab3'''


<code>VOID '''ObjGab'''(OBJECT ''&lt;Obj&gt;'', VARNAME ''&lt;X&gt;'', VARNAME ''&lt;Y&gt;'', VARNAME ''&lt;Z&gt;'')</code>

<code>VOID '''ObjGab'''(OBJECT ''&lt;Obj&gt;'', VARNAME ARRAY ''<nowiki>&lt;G[3]&gt;</nowiki>'')</code>

Функция '''ObjGab''' присваивает переменным <code>''&lt;X&gt;''</code>, <code>''&lt;Y&gt;''</code>, <code>''&lt;Z&gt;</code> ''или массиву <code>''&lt;G&gt;''</code> значения соответствующих габаритов объекта <code>''&lt;Obj&gt;''</code>.


<code>DOUBLE '''ObjGab1'''(OBJECT ''&lt;Obj&gt;'', INT ''&lt;NCrd&gt;'')</code>

Функция '''ObjGab1''' возвращает габарит объекта <code>''&lt;Obj&gt;''</code> по координате с соответствующим номером <code>''&lt;NCrd&gt;''</code> (1 – X, 2 – Y, 3 – Z).


<code>LOGICAL '''ObjGab2'''(OBJECT ''&lt;Obj&gt;'', VARNAME ARRAY ''<nowiki>&lt;G[6]&gt;</nowiki>''<nowiki>[, LOGICAL </nowiki>''&lt;IsLCS&gt;''])</code>

Функция '''ObjGab2''' заполняет массив <code>''&lt;G&gt;''</code> габаритными координатами объекта в <code>''&lt;Obj&gt;''</code> '''ГСК '''и возвращает '''1''' в случае, если объект имеет видимые габариты и '''0''' в случае, если объект погашен, это пустая группа и пр.

Если указан дополнительный параметр <code>''&lt;IsLCS&gt;''</code> и он не равен '''0''', то габариты объекта <code>''&lt;Obj&gt;''</code> вычисляются в локальной систем координат (ЛСК) этого объекта.


<code>LOGICAL '''ObjGab3'''(OBJECT ''&lt;Obj&gt;'', VARNAME ARRAY ''<nowiki>&lt;G[6]&gt;</nowiki>'')</code>

Функция '''ObjGab3''' заполняет массив <code>''&lt;G&gt;''</code> габаритными координатами объекта <code>''&lt;Obj&gt;</code> ''в '''ПСК '''и возвращает '''1''' в случае, если объект имеет видимые габариты и '''0''' в случае, если объект погашен, это пустая группа и пр.

Под габаритом понимается протяженность объекта по соответствующей координате. Например, отрезок из точки '''(10,20,30)''', в точку '''(100,100,100)''' будет иметь габариты '''90,80,70'''.

Под габаритными координатами объекта в указанной системе координат понимаются три минимальные '''(X, Y, Z)''' и три максимальных значения координат объекта. Например, отрезок из точки '''(10,200,30)''', в точку '''(100,10,100)''' будет иметь габаритные координаты '''10, 10, 30, 100, 200, 100''' в '''ГСК'''.

Пример:
 #l1 Line 10, 20, 30, 100, 100, 100;
 =ObjGab1(l1,2);
 <font color="008800">80</font>
 ObjGab(l1,xl,yl,zl);
 =xl
 <font color="008800">90</font>
 Defarrays g[3];
 ObjGab(l1,g);
 =g[3]
 <font color="008800">70</font>
 Defarrays gk[6];
 ObjGab2(l1,gk);
 =gk[6]
 <font color="008800">100</font>

{| class="prettytable"
|-
|valign="top"|[[image:i.png]]
|''При нахождении габаритных координат объекта предпочтение следует отдавать функции '''ObjGab3'''''
|}
{| class="prettytable"
|-
|valign="top"|[[image:i.png]]
|''Все функции выдают информацию только об непогашенных объектах или о непогашенных частях объектов, если объекты — группы и имеют внутри погашенные составляющие.''
|}
{| class="prettytable"
|-
|valign="top"|[[image:i.png]]
|''Если объект не погашен, но находится на погашенном слое, то функции '''ObjGab, ObjGab1, ObjGab2''' считают этот объект погашенным и возвращают '''''0'''''. Функция '''ObjGab3''' в случае объекта на погашенном слое считает его видимым и выдает реальные габаритные координаты объекта.''
|}
@@ Строка 1: / Строка 1: @@
 [[Category:Макро]]
-{{Макро}}
-----
 Команды данного раздела вычисляют различные геометрические характеристики объектов.
@@ Строка 357: / Строка 355: @@
 |''Если объект не погашен, но находится на погашенном слое, то функции '''ObjGab, ObjGab1, ObjGab2''' считают этот объект погашенным и возвращают '''''0'''''. Функция '''ObjGab3''' в случае объекта на погашенном слое считает его видимым и выдает реальные габаритные координаты объекта.''
 |}
-----
-{{Макро}}