Модули и функции · встроенный MicroPython FEMM 5
femm · Тепловое решение
Команды FEMM обеспечивают подготовку документов, построение геометрии, назначение свойств, создание сетки и решение задачи. Обработка результатов включает вычисление интегралов и пакетное чтение полевых величин во всех четырёх физических модулях.
Условия работы
- Во встроенном сценарии команды вызываются непосредственно: newdocument(0), mi_drawrectangle(...), mi_loadsolution(), mo_getpointvalues(...). Доступен также import femm с обращением femm.mi_drawrectangle(...).
- Создание/открытие входного документа регистрирует его семейство команд mi_/ei_/hi_/ci_; загрузка решения регистрирует mo_/eo_/ho_/co_. До открытия соответствующего документа список доступных имён неполон.
- Координаты редактора и запросов точки используют единицы длины документа; интегралы и физические поля используют указанные для каждой величины единицы СИ. Исключения, например МСм/м в магнитном материале, отмечены в аргументах.
- Примеры геометрии создают отдельный образец 20 × 10 мм. Примеры постпроцессора рассчитаны на уже открытое решение и выбирают центр первого конечного элемента вместо произвольной точки.
- Запуск сценария, который изменяет геометрию, выделение, файлы или окна, является отдельным действием пользователя. Такие карточки помечены как контекстные; автоматическая проверка примеров выполняется только для явно отмеченных независимых запросов.
femm.ho_lineintegralfemm.ho_blockintegralfemm.ho_getpointvaluesfemm.ho_makeplotfemm.ho_getprobleminfofemm.ho_getconductorpropertiesfemm.ho_seteditmodefemm.ho_selectblockfemm.ho_groupselectblockfemm.ho_selectconductorfemm.ho_addcontourfemm.ho_bendcontourfemm.ho_selectpointfemm.ho_clearcontourfemm.ho_clearblockfemm.ho_zoomnaturalfemm.ho_zoominfemm.ho_zoomoutfemm.ho_zoomfemm.ho_showmeshfemm.ho_hidemeshfemm.ho_showpointsfemm.ho_hidepointsfemm.ho_smoothfemm.ho_showgridfemm.ho_hidegridfemm.ho_gridsnapfemm.ho_setgridfemm.ho_hidedensityplotfemm.ho_showdensityplotfemm.ho_hidecontourplotfemm.ho_showcontourplotfemm.ho_showvectorplotfemm.ho_minimizefemm.ho_maximizefemm.ho_restorefemm.ho_resizefemm.ho_closefemm.ho_refreshviewfemm.ho_reloadfemm.ho_setfocusfemm.ho_savebitmapfemm.ho_savemetafilefemm.ho_shownamesfemm.ho_numnodesfemm.ho_numelementsfemm.ho_getnodefemm.ho_getelementfemm.ho_getallnodesfemm.ho_getallelementsfemm.ho_getallffemm.ho_getalltfemm.ho_gettitlefemm.ho_selectlinefemm.ho_showdensityfemm.ho_hidedensityfemm.ho_showcontourfemm.ho_hidecontourfemm.ho_vectorplotfemm.ho_smoothingfemm.ho_getconductorpropsfemm.ho_lineintegralВычисляет выбранный линейный интеграл по текущему ориентированному контуру.
femm.ho_lineintegral
ho_lineintegral(type)Вычисляет выбранный линейный интеграл по текущему ориентированному контуру.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
type | Код линейного интеграла; список допустимых кодов приведён ниже. |
Возвращаемое значение
tuple из двух float. Состав пары зависит от type; для type 2 — длина и площадь поверхности в СИ.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- type = 0: разность температур (G\cdot t)
- type = 1: тепловой поток (F\cdot n)
- type = 2: длина и площадь поверхности
- type = 3: средняя температура
- На стр.137 пример теплового потока использует код 2, хотя таблица задаёт для потока код 1; код 2 относится к геометрии контура.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_lineintegral.\nСреда: встроенный MicroPython FEMM 5.\nВычисляет выбранный линейный интеграл по текущему ориентированному контуру.\nРезультат: tuple из двух float. Состав пары зависит от type; для type 2 — длина и площадь поверхности в СИ."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
n1 = ho_getnode(int(element[0]))
n2 = ho_getnode(int(element[1]))
ho_clearcontour()
ho_addcontour(n1[0], n1[1])
ho_addcontour(n2[0], n2[1])
result = ho_lineintegral(2)
print(result) # Геометрические величины контура в СИ.
Ожидаемый результат. Вычисляет выбранный линейный интеграл по текущему ориентированному контуру.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_blockintegralВычисляет выбранный интеграл по отмеченным областям; код операции зависит от физического модуля.
femm.ho_blockintegral
ho_blockintegral(type)Вычисляет выбранный интеграл по отмеченным областям; код операции зависит от физического модуля.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
type | Код интеграла по области; список допустимых кодов приведён ниже. |
Возвращаемое значение
tuple из двух float (основная величина, вторая компонента); назначение пары зависит от type. Для площади/энергии/температуры скалярная величина находится в result[0], вторая компонента равна 0.0.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- type = 0: средняя температура
- type = 1: площадь
- type = 2: объём
- type = 3: среднее F
- type = 4: среднее G
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_blockintegral.\nСреда: встроенный MicroPython FEMM 5.\nВычисляет выбранный интеграл по отмеченным областям; код операции зависит от физического модуля.\nРезультат: tuple из двух float (основная величина, вторая компонента); назначение пары зависит от type. Для площади/энергии/температуры скалярная величина находится в result[0], вторая компонента равна 0.0."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
ho_clearblock()
ho_selectblock(x, y)
area_result = ho_blockintegral(1)
print(area_result) # Площадь выбранной области, м².
Ожидаемый результат. Вычисляет выбранный интеграл по отмеченным областям; код операции зависит от физического модуля.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_getpointvaluesВозвращает упорядоченный набор локальных величин в заданной точке решения.
femm.ho_getpointvalues
ho_getpointvalues(X, Y)Возвращает упорядоченный набор локальных величин в заданной точке решения.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
X | Первая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа. |
Y | Вторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа. |
Возвращаемое значение
tuple из 7 локальных величин в порядке, приведённом ниже; None, если точка вне расчётной сетки. Магнитные и токовые величины с фазой при ненулевой частоте комплексные.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Позиция результата 0 (индексация Python): T — температура, К
- Позиция результата 1 (индексация Python): F_x — компонента плотности теплового потока F_x/r, Вт/м²
- Позиция результата 2 (индексация Python): F_y — компонента плотности теплового потока F_y/z, Вт/м²
- Позиция результата 3 (индексация Python): G_x — компонента G_x/r, К/м; см. замечание о знаке
- Позиция результата 4 (индексация Python): Gy — компонента Gy/z, К/м; см. замечание о знаке
- Позиция результата 5 (индексация Python): kx — теплопроводность по x/r, Вт/(м·К)
- Позиция результата 6 (индексация Python): ky — теплопроводность по y/z, Вт/(м·К)
- В PDF G назван градиентом температуры. В нативном эталоне слоя с dT /dx = -8000 К/м получено G_x \approx +8000 К/м при F_x \approx +80000 Вт/м² и k = 10 Вт/(м·К). Поэтому G нельзя безоговорочно обозначать как \partial T/\partial x. Температура и F сверены с точным решением; знак G отмечен как расхождение описания и поведения. Протокол: downloads/benchmarks/result.json.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_getpointvalues.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает упорядоченный набор локальных величин в заданной точке решения.\nРезультат: tuple из 7 локальных величин в порядке, приведённом ниже; None, если точка вне расчётной сетки. Магнитные и токовые величины с фазой при ненулевой частоте комплексные."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
values = ho_getpointvalues(x, y)
print(values)
Ожидаемый результат. Возвращает упорядоченный набор локальных величин в заданной точке решения.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_makeplotВыполняет выборку выбранной величины вдоль текущего контура; при заданном имени файла сохраняет значения в CSV.
femm.ho_makeplot
ho_makeplot(PlotType, NumPoints=None, Filename=None, FileFormat=None)Выполняет выборку выбранной величины вдоль текущего контура; при заданном имени файла сохраняет значения в CSV.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
PlotType | Код скалярной или компонентной величины для графика по контуру. |
NumPoints | Число точек выборки вдоль контура. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Filename | Путь для выгрузки точек графика; при отсутствии показывается график. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
FileFormat | Совместимый четвёртый аргумент makeplot: в FEMM5 принимается, но игнорируется; данные записываются в CSV. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
float: число точек, фактически выбранных вдоль контура. При заданном Filename дополнительно записывается CSV; ошибка файла вызывает RuntimeError.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- При заданном Filename FEMM 5 записывает CSV с заголовком. FileFormat сохранён для совместимости и игнорируется; это не экспорт метафайла.
- PlotType = 0: T
- PlotType = 1: |F|
- PlotType = 2: F\cdot n
- PlotType = 3: F\cdot t
- PlotType = 4: |G|
- PlotType = 5: G\cdot n
- PlotType = 6: G\cdot t
- Таблица PDF на стр.138 сохраняет обозначения V/D/E из электростатического раздела. Здесь они заменены тепловыми T/F/G по назначению модуля; набор режимов отдельно не исполнялся.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
- NumPoints по умолчанию 150; значения меньше 2 повышаются до 2. Нужен контур хотя бы из двух точек. Возвращается число выбранных точек; CSV сохраняется только при непустом Filename.
Пример
"Пример femm.ho_makeplot.\nСреда: встроенный MicroPython FEMM 5.\nВыполняет выборку выбранной величины вдоль текущего контура; при заданном имени файла сохраняет значения в CSV.\nРезультат: float: число точек, фактически выбранных вдоль контура. При заданном Filename дополнительно записывается CSV; ошибка файла вызывает RuntimeError."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
n1 = ho_getnode(int(element[0]))
n2 = ho_getnode(int(element[1]))
ho_clearcontour()
ho_addcontour(n1[0], n1[1])
ho_addcontour(n2[0], n2[1])
ho_makeplot(0, 101, "contour.csv") # 101 точка вдоль построенного контура.
Ожидаемый результат. Строит зависимость вдоль текущего контура либо записывает её точки в CSV при указании имени файла.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_getprobleminfoВозвращает тип постановки, единицы и другие параметры загруженного решения.
femm.ho_getprobleminfo
ho_getprobleminfo()Возвращает тип постановки, единицы и другие параметры загруженного решения.
Аргументы
Аргументы не требуются.
Возвращаемое значение
tuple параметров решения; позиции и единицы перечислены ниже. Глубина и коэффициент перевода геометрии возвращаются в метрах.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Позиция результата 0 (индексация Python): тип: 0 planar, 1 axisymmetric
- Позиция результата 1 (индексация Python): глубина плоской модели, м
- Позиция результата 2 (индексация Python): длина единицы геометрии, м
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_getprobleminfo.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает тип постановки, единицы и другие параметры загруженного решения.\nРезультат: tuple параметров решения; позиции и единицы перечислены ниже. Глубина и коэффициент перевода геометрии возвращаются в метрах."
# Уже открыто решение теплопроводности.
print(ho_getprobleminfo())
Ожидаемый результат. Возвращает тип постановки, единицы и другие параметры загруженного решения.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_getconductorpropertiesВозвращает потенциал и суммарную ответную величину именованного проводника.
femm.ho_getconductorproperties
ho_getconductorproperties(conductor)Возвращает потенциал и суммарную ответную величину именованного проводника.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
conductor | Имя проводника. |
Возвращаемое значение
tuple из двух величин: (потенциал, суммарный заряд/ток) либо (температура, суммарная тепловая мощность). Порядок и единицы указаны ниже; неизвестное имя вызывает RuntimeError.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Позиция результата 0 (индексация Python): температура, К
- Позиция результата 1 (индексация Python): суммарный тепловой поток, Вт
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_getconductorproperties.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает потенциал и суммарную ответную величину именованного проводника.\nРезультат: tuple из двух величин: (потенциал, суммарный заряд/ток) либо (температура, суммарная тепловая мощность). Порядок и единицы указаны ниже; неизвестное имя вызывает RuntimeError."
# Уже открыто решение теплопроводности.
# В модели определено точное имя 'Terminal'.
value = ho_getconductorproperties("Terminal")
print(value)
Ожидаемый результат. Возвращает потенциал и суммарную ответную величину именованного проводника.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_seteditmodeВыбирает класс объектов для следующих операций редактирования или чтения решения.
femm.ho_seteditmode
ho_seteditmode(mode)Выбирает класс объектов для следующих операций редактирования или чтения решения.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
mode | Режим чтения решения: point, contour или area. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_seteditmode.\nСреда: встроенный MicroPython FEMM 5.\nВыбирает класс объектов для следующих операций редактирования или чтения решения.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
ho_seteditmode("area")
Ожидаемый результат. Выбирает класс объектов для следующих операций редактирования или чтения решения.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_selectblockВыбирает область решения, содержащую заданную точку.
femm.ho_selectblock
ho_selectblock(x, y)Выбирает область решения, содержащую заданную точку.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
x | Первая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа. |
y | Вторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Повторный выбор того же объекта переключает его выделение. Для воспроизводимой выборки сначала снимайте выделение командой clearselected/clearblock соответствующего семейства.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_selectblock.\nСреда: встроенный MicroPython FEMM 5.\nВыбирает область решения, содержащую заданную точку.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
ho_clearblock()
ho_selectblock(x, y)
Ожидаемый результат. Выбирает область решения, содержащую заданную точку.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_groupselectblockВыбирает области решения по номеру группы.
femm.ho_groupselectblock
ho_groupselectblock(n=None)Выбирает области решения по номеру группы.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
n | Номер группы областей; без аргумента выбираются все области. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Вызов без n выбирает все области, хотя аргумент в основной записи PDF не помечен как необязательный.
- Повторный выбор того же объекта переключает его выделение. Для воспроизводимой выборки сначала снимайте выделение командой clearselected/clearblock соответствующего семейства.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_groupselectblock.\nСреда: встроенный MicroPython FEMM 5.\nВыбирает области решения по номеру группы.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
ho_clearblock()
# В примере выбираются все области независимо от номера группы.
ho_groupselectblock()
Ожидаемый результат. Выбирает области решения по номеру группы.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_selectconductorВыбирает объекты, относящиеся к указанному проводнику.
femm.ho_selectconductor
ho_selectconductor(name)Выбирает объекты, относящиеся к указанному проводнику.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
name | Имя выбираемого объекта, модуля или передаваемой переменной. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Стр.139 ошибочно переносит назначение weighted stress tensor из электрического раздела. В таблице ho_blockintegral (стр.138) тепловых сил и моментов нет; этой командой нельзя обосновывать механическую силу из температурного решения.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_selectconductor.\nСреда: встроенный MicroPython FEMM 5.\nВыбирает объекты, относящиеся к указанному проводнику.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
# В модели определено точное имя 'Terminal'.
value = ho_selectconductor("Terminal")
print(value)
Ожидаемый результат. Выбирает объекты, относящиеся к указанному проводнику.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_addcontourДобавляет точку в конец текущего контура интегрирования.
femm.ho_addcontour
ho_addcontour(x, y)Добавляет точку в конец текущего контура интегрирования.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
x | Первая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа. |
y | Вторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_addcontour.\nСреда: встроенный MicroPython FEMM 5.\nДобавляет точку в конец текущего контура интегрирования.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
n1 = ho_getnode(int(element[0]))
n2 = ho_getnode(int(element[1]))
ho_clearcontour()
ho_addcontour(n1[0], n1[1])
ho_addcontour(n2[0], n2[1])
Ожидаемый результат. Добавляет точку в конец текущего контура интегрирования.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_bendcontourЗаменяет последний прямой участок контура дугой с указанным углом и шагом.
femm.ho_bendcontour
ho_bendcontour(angle, anglestep=None)Заменяет последний прямой участок контура дугой с указанным углом и шагом.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
angle | Угол в градусах; смысл задаётся операцией дуги, поворота или чтения зазора. |
anglestep | Угловой шаг разбиения дуги контура, градусы. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Допустимый angle: от -180^\circ до +180^\circ; anglestep > 0. Если контур содержит менее двух точек, команда не изменяет его.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_bendcontour.\nСреда: встроенный MicroPython FEMM 5.\nЗаменяет последний прямой участок контура дугой с указанным углом и шагом.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
n1 = ho_getnode(int(element[0]))
n2 = ho_getnode(int(element[1]))
ho_clearcontour()
ho_addcontour(n1[0], n1[1])
ho_addcontour(n2[0], n2[1])
ho_bendcontour(30, 1) # Последний участок становится дугой 30°.
Ожидаемый результат. Заменяет последний прямой участок контура дугой с указанным углом и шагом.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_selectpointДобавляет к контуру ближайший узел исходной геометрии.
femm.ho_selectpoint
ho_selectpoint(x, y)Добавляет к контуру ближайший узел исходной геометрии.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
x | Первая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа. |
y | Вторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_selectpoint.\nСреда: встроенный MicroPython FEMM 5.\nДобавляет к контуру ближайший узел исходной геометрии.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
n1 = ho_getnode(int(element[0]))
n2 = ho_getnode(int(element[1]))
ho_clearcontour()
ho_addcontour(n1[0], n1[1])
ho_addcontour(n2[0], n2[1])
ho_clearcontour()
ho_selectpoint(n1[0], n1[1])
Ожидаемый результат. Добавляет к контуру ближайший узел исходной геометрии.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_clearcontourУдаляет текущий контур интегрирования.
femm.ho_clearcontour
ho_clearcontour()Удаляет текущий контур интегрирования.
Аргументы
Аргументы не требуются.
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_clearcontour.\nСреда: встроенный MicroPython FEMM 5.\nУдаляет текущий контур интегрирования.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
n1 = ho_getnode(int(element[0]))
n2 = ho_getnode(int(element[1]))
ho_clearcontour()
ho_addcontour(n1[0], n1[1])
ho_addcontour(n2[0], n2[1])
ho_clearcontour()
Ожидаемый результат. Удаляет текущий контур интегрирования.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_clearblockСнимает выбор областей решения.
femm.ho_clearblock
ho_clearblock()Снимает выбор областей решения.
Аргументы
Аргументы не требуются.
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_clearblock.\nСреда: встроенный MicroPython FEMM 5.\nСнимает выбор областей решения.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
ho_clearblock()
Ожидаемый результат. Снимает выбор областей решения.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_zoomnaturalПоказывает всю геометрию в доступном окне.
femm.ho_zoomnatural
ho_zoomnatural()Показывает всю геометрию в доступном окне.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_zoomnatural.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает всю геометрию в доступном окне.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_zoomnatural()
Ожидаемый результат. Показывает всю геометрию в доступном окне.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_zoominУвеличивает масштаб вида.
femm.ho_zoomin
ho_zoomin()Увеличивает масштаб вида.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_zoomin.\nСреда: встроенный MicroPython FEMM 5.\nУвеличивает масштаб вида.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_zoomin()
Ожидаемый результат. Увеличивает масштаб вида.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_zoomoutУменьшает масштаб вида.
femm.ho_zoomout
ho_zoomout()Уменьшает масштаб вида.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_zoomout.\nСреда: встроенный MicroPython FEMM 5.\nУменьшает масштаб вида.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_zoomout()
Ожидаемый результат. Уменьшает масштаб вида.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_zoomПоказывает прямоугольную область между заданными углами.
femm.ho_zoom
ho_zoom(x1, y1, x2, y2)Показывает прямоугольную область между заданными углами.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
x1 | Первая координата начальной точки или первого угла; единицы геометрии. |
y1 | Вторая координата начальной точки или первого угла; единицы геометрии. |
x2 | Первая координата конечной точки или второго угла; единицы геометрии. |
y2 | Вторая координата конечной точки или второго угла; единицы геометрии. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_zoom.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает прямоугольную область между заданными углами.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_zoom(0, 0, 20, 10)
Ожидаемый результат. Показывает прямоугольную область между заданными углами.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_showmeshПоказывает рёбра конечной сетки.
femm.ho_showmesh
ho_showmesh()Показывает рёбра конечной сетки.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_showmesh.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает рёбра конечной сетки.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_showmesh()
Ожидаемый результат. Показывает рёбра конечной сетки.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_hidemeshСкрывает рёбра конечной сетки.
femm.ho_hidemesh
ho_hidemesh()Скрывает рёбра конечной сетки.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_hidemesh.\nСреда: встроенный MicroPython FEMM 5.\nСкрывает рёбра конечной сетки.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_hidemesh()
Ожидаемый результат. Скрывает рёбра конечной сетки.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_showpointsПоказывает узлы исходной геометрии.
femm.ho_showpoints
ho_showpoints()Показывает узлы исходной геометрии.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_showpoints.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает узлы исходной геометрии.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_showpoints()
Ожидаемый результат. Показывает узлы исходной геометрии.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_hidepointsСкрывает узлы исходной геометрии.
femm.ho_hidepoints
ho_hidepoints()Скрывает узлы исходной геометрии.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_hidepoints.\nСреда: встроенный MicroPython FEMM 5.\nСкрывает узлы исходной геометрии.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_hidepoints()
Ожидаемый результат. Скрывает узлы исходной геометрии.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_smoothВключает или отключает сглаживание производных поля в постпроцессоре.
femm.ho_smooth
ho_smooth(flag)Включает или отключает сглаживание производных поля в постпроцессоре.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
flag | Строка on включает, off отключает этот режим. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_smooth.\nСреда: встроенный MicroPython FEMM 5.\nВключает или отключает сглаживание производных поля в постпроцессоре.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
ho_smooth("off")
Ожидаемый результат. Включает или отключает сглаживание производных поля в постпроцессоре.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_showgridПоказывает координатную сетку вида.
femm.ho_showgrid
ho_showgrid()Показывает координатную сетку вида.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_showgrid.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает координатную сетку вида.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_showgrid()
Ожидаемый результат. Показывает координатную сетку вида.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_hidegridСкрывает координатную сетку вида.
femm.ho_hidegrid
ho_hidegrid()Скрывает координатную сетку вида.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_hidegrid.\nСреда: встроенный MicroPython FEMM 5.\nСкрывает координатную сетку вида.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_hidegrid()
Ожидаемый результат. Скрывает координатную сетку вида.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_gridsnapВключает или отключает привязку координат к сетке вида.
femm.ho_gridsnap
ho_gridsnap(flag)Включает или отключает привязку координат к сетке вида.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
flag | Строка on включает, off отключает этот режим. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_gridsnap.\nСреда: встроенный MicroPython FEMM 5.\nВключает или отключает привязку координат к сетке вида.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
ho_gridsnap("off")
Ожидаемый результат. Включает или отключает привязку координат к сетке вида.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_setgridЗадаёт шаг и декартов либо полярный тип координатной сетки.
femm.ho_setgrid
ho_setgrid(density=None, type=None)Задаёт шаг и декартов либо полярный тип координатной сетки.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
density | Расстояние между точками координатной сетки; единицы геометрии. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
type | Система координат сетки вида: cart или polar. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Оба аргумента можно опустить; второй аргумент, если передан, должен быть строкой "cart" или "polar". Числовой код вместо строки вызывает TypeError.
Пример
"Пример femm.ho_setgrid.\nСреда: встроенный MicroPython FEMM 5.\nЗадаёт шаг и декартов либо полярный тип координатной сетки.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
ho_setgrid(1, "cart")
Ожидаемый результат. Задаёт шаг и декартов либо полярный тип координатной сетки.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_hidedensityplotСкрывает цветовую карту.
femm.ho_hidedensityplot
ho_hidedensityplot()Скрывает цветовую карту.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_hidedensityplot.\nСреда: встроенный MicroPython FEMM 5.\nСкрывает цветовую карту.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_hidedensityplot()
Ожидаемый результат. Скрывает цветовую карту.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_showdensityplotПоказывает цветовую карту выбранной величины с заданными пределами и легендой.
femm.ho_showdensityplot
ho_showdensityplot(legend=None, gscale=None, type=None, upper=None, lower=None)Показывает цветовую карту выбранной величины с заданными пределами и легендой.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
legend | Переключатель отображения легенды цветовой карты. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
gscale | Переключатель градаций серого вместо цветной шкалы. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
type | Код или имя величины цветовой карты; набор зависит от физического модуля. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
upper | Верхняя граница шкалы выбранной величины. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
lower | Нижняя граница шкалы выбранной величины. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- type = 0: T
- type = 1: |F|
- type = 2: |G|
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_showdensityplot.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает цветовую карту выбранной величины с заданными пределами и легендой.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
ho_showdensityplot(1, 0, 0, 400, 300)
Ожидаемый результат. Показывает цветовую карту выбранной величины с заданными пределами и легендой.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_hidecontourplotСкрывает изолинии потенциала.
femm.ho_hidecontourplot
ho_hidecontourplot()Скрывает изолинии потенциала.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_hidecontourplot.\nСреда: встроенный MicroPython FEMM 5.\nСкрывает изолинии потенциала.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_hidecontourplot()
Ожидаемый результат. Скрывает изолинии потенциала.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_showcontourplotПоказывает заданное число изолиний потенциала в выбранном диапазоне.
femm.ho_showcontourplot
ho_showcontourplot(numcontours, lower_V=None, upper_V=None)Показывает заданное число изолиний потенциала в выбранном диапазоне.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
numcontours | Число изолиний в заданном диапазоне. |
lower_V | Нижний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
upper_V | Верхний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- numcontours = −1: использовать настройки по умолчанию; остальные аргументы игнорируются.
- Сокращённый вызов с одним аргументом −1 использует настройки по умолчанию. Произвольное опускание остальных аргументов для другого numcontours здесь не утверждается.
- В подписи стр.141 осталась буква V из электрического раздела. В тепловом модуле отображаются изотермы T, К; имена аргументов lower_V/upper_V сохранены как в документации.
Пример
"Пример femm.ho_showcontourplot.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает заданное число изолиний потенциала в выбранном диапазоне.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_showcontourplot(20)
Ожидаемый результат. Показывает заданное число изолиний потенциала в выбранном диапазоне.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_showvectorplotПоказывает стрелки выбранного векторного поля с заданным масштабом.
femm.ho_showvectorplot
ho_showvectorplot(type, scalefactor)Показывает стрелки выбранного векторного поля с заданным масштабом.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
type | Код отображаемого вектора и его компоненты для выбранного физического модуля. |
scalefactor | Коэффициент масштаба геометрии либо стрелок, в зависимости от команды. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- type = 0: выключить
- type = 1: F
- type = 2: G; знак см. в примечании ho_getpointvalues
Пример
"Пример femm.ho_showvectorplot.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает стрелки выбранного векторного поля с заданным масштабом.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_showvectorplot(1, 1)
Ожидаемый результат. Показывает стрелки выбранного векторного поля с заданным масштабом.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_minimizeСворачивает окно документа.
femm.ho_minimize
ho_minimize()Сворачивает окно документа.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_minimize.\nСреда: встроенный MicroPython FEMM 5.\nСворачивает окно документа.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_minimize()
Ожидаемый результат. Сворачивает окно документа.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_maximizeРазворачивает окно документа.
femm.ho_maximize
ho_maximize()Разворачивает окно документа.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_maximize.\nСреда: встроенный MicroPython FEMM 5.\nРазворачивает окно документа.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_maximize()
Ожидаемый результат. Разворачивает окно документа.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_restoreВозвращает обычный размер окна документа.
femm.ho_restore
ho_restore()Возвращает обычный размер окна документа.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_restore.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает обычный размер окна документа.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_restore()
Ожидаемый результат. Возвращает обычный размер окна документа.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_resizeУстанавливает размер окна в пикселях.
femm.ho_resize
ho_resize(width, height)Устанавливает размер окна в пикселях.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
width | Ширина окна в пикселях. |
height | Высота окна в пикселях. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_resize.\nСреда: встроенный MicroPython FEMM 5.\nУстанавливает размер окна в пикселях.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_resize(1000, 700)
Ожидаемый результат. Устанавливает размер окна в пикселях.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_closeЗакрывает активный документ этого семейства.
femm.ho_close
ho_close()Закрывает активный документ этого семейства.
Аргументы
Аргументы не требуются.
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_close.\nСреда: встроенный MicroPython FEMM 5.\nЗакрывает активный документ этого семейства.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
ho_close()
Ожидаемый результат. Закрывает активный документ этого семейства.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_refreshviewПерерисовывает активное окно.
femm.ho_refreshview
ho_refreshview()Перерисовывает активное окно.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_refreshview.\nСреда: встроенный MicroPython FEMM 5.\nПерерисовывает активное окно.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_refreshview()
Ожидаемый результат. Перерисовывает активное окно.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_reloadПовторно загружает файл решения с диска.
femm.ho_reload
ho_reload()Повторно загружает файл решения с диска.
Аргументы
Аргументы не требуются.
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_reload.\nСреда: встроенный MicroPython FEMM 5.\nПовторно загружает файл решения с диска.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
ho_reload()
Ожидаемый результат. Повторно загружает файл решения с диска.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_setfocusВыбирает документ, к которому будут относиться следующие команды данного семейства.
femm.ho_setfocus
ho_setfocus(documentname=None)Выбирает документ, к которому будут относиться следующие команды данного семейства.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
documentname | Имя документа для выбора активного окна. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_setfocus.\nСреда: встроенный MicroPython FEMM 5.\nВыбирает документ, к которому будут относиться следующие команды данного семейства.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
# Файл sample.anh уже открыт в постпроцессоре.
ho_setfocus("sample.anh")
Ожидаемый результат. Выбирает документ, к которому будут относиться следующие команды данного семейства.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_savebitmapСохраняет изображение текущего вида в растровый файл; численные данные результата сохраняются отдельно.
femm.ho_savebitmap
ho_savebitmap(filename)Сохраняет изображение текущего вида в растровый файл; численные данные результата сохраняются отдельно.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
filename | Путь к читаемому или записываемому файлу. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_savebitmap.\nСреда: встроенный MicroPython FEMM 5.\nСохраняет изображение текущего вида в растровый файл; численные данные результата сохраняются отдельно.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
ho_savebitmap("solution.png")
Ожидаемый результат. Сохраняет изображение текущего вида в растровый файл; численные данные результата сохраняются отдельно.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_savemetafileСовместимое имя старого экспорта; в FEMM 5 Qt эта команда ничего не делает. Для изображения применяйте savebitmap соответствующего модуля.
femm.ho_savemetafile
ho_savemetafile(filename=None)Совместимое имя старого экспорта; в FEMM 5 Qt эта команда ничего не делает. Для изображения применяйте savebitmap соответствующего модуля.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
filename | Путь к читаемому или записываемому файлу. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_savemetafile.\nСреда: встроенный MicroPython FEMM 5.\nСовместимое имя старого экспорта; в FEMM 5 Qt эта команда ничего не делает. Для изображения применяйте savebitmap соответствующего модуля.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
ho_savemetafile("solution.emf")
Ожидаемый результат. Совместимое имя старого экспорта; в FEMM 5 Qt эта команда ничего не делает. Для изображения применяйте savebitmap соответствующего модуля.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_shownamesВключает или отключает показ имён меток областей.
femm.ho_shownames
ho_shownames(flag)Включает или отключает показ имён меток областей.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
flag | 0 отключает отображение, 1 включает. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_shownames.\nСреда: встроенный MicroPython FEMM 5.\nВключает или отключает показ имён меток областей.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_shownames(1)
Ожидаемый результат. Включает или отключает показ имён меток областей.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_numnodesВозвращает число узлов конечной сетки.
femm.ho_numnodes
ho_numnodes()Возвращает число узлов конечной сетки.
Аргументы
Аргументы не требуются.
Возвращаемое значение
Числовое значение float, равное целому числу узлов/элементов. Для range используйте int(result).
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_numnodes.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает число узлов конечной сетки.\nРезультат: Числовое значение float, равное целому числу узлов/элементов. Для range используйте int(result)."
# Уже открыто решение теплопроводности.
print(ho_numnodes())
Ожидаемый результат. Возвращает число узлов конечной сетки.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_numelementsВозвращает число треугольных элементов сетки.
femm.ho_numelements
ho_numelements()Возвращает число треугольных элементов сетки.
Аргументы
Аргументы не требуются.
Возвращаемое значение
Числовое значение float, равное целому числу узлов/элементов. Для range используйте int(result).
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_numelements.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает число треугольных элементов сетки.\nРезультат: Числовое значение float, равное целому числу узлов/элементов. Для range используйте int(result)."
# Уже открыто решение теплопроводности.
print(ho_numelements())
Ожидаемый результат. Возвращает число треугольных элементов сетки.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_getnodeВозвращает координаты узла сетки по индексу, начинающемуся с единицы.
femm.ho_getnode
ho_getnode(n)Возвращает координаты узла сетки по индексу, начинающемуся с единицы.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
n | Индекс узла сетки, начиная с 1. |
Возвращаемое значение
tuple из двух float: (x, y) или (r, z), в единицах геометрии. None при индексе вне сетки.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Возврат: координаты x,y либо r,z в единицах геометрии. Индекс n начинается с 1; индекс массива Python начинается с 0.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_getnode.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает координаты узла сетки по индексу, начинающемуся с единицы.\nРезультат: tuple из двух float: (x, y) или (r, z), в единицах геометрии. None при индексе вне сетки."
# Уже открыто решение теплопроводности.
print(ho_getnode(1)) # FEMM нумерует узлы и элементы с 1.
Ожидаемый результат. Возвращает координаты узла сетки по индексу, начинающемуся с единицы.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_getelementВозвращает три индекса узлов, центр, площадь и группу одного треугольника.
femm.ho_getelement
ho_getelement(n)Возвращает три индекса узлов, центр, площадь и группу одного треугольника.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
n | Индекс треугольника сетки, начиная с 1. |
Возвращаемое значение
tuple из 7 чисел: (n1, n2, n3, xc, yc, area, group); номера узлов начинаются с 1, площадь в квадрате единицы геометрии. None при неверном индексе.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Позиция результата 0 (индексация Python): номер первого узла (с 1)
- Позиция результата 1 (индексация Python): номер второго узла (с 1)
- Позиция результата 2 (индексация Python): номер третьего узла (с 1)
- Позиция результата 3 (индексация Python): координата центра x/r в единицах геометрии
- Позиция результата 4 (индексация Python): координата центра y/z в единицах геометрии
- Позиция результата 5 (индексация Python): площадь треугольника в квадрате единицы геометрии
- Позиция результата 6 (индексация Python): номер группы области
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_getelement.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает три индекса узлов, центр, площадь и группу одного треугольника.\nРезультат: tuple из 7 чисел: (n1, n2, n3, xc, yc, area, group); номера узлов начинаются с 1, площадь в квадрате единицы геометрии. None при неверном индексе."
# Уже открыто решение теплопроводности.
print(ho_getelement(1)) # FEMM нумерует узлы и элементы с 1.
Ожидаемый результат. Возвращает три индекса узлов, центр, площадь и группу одного треугольника.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_getallnodesВозвращает координаты всех узлов: во встроенном Python матрицу N\times 2.
femm.ho_getallnodes
ho_getallnodes()Возвращает координаты всех узлов: во встроенном Python матрицу N\times 2.
Аргументы
Аргументы не требуются.
Возвращаемое значение
ndarray формы Nn×2 float64 с координатами всех узлов в единицах геометрии.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Форма: Nn×2; строка k-1 содержит координаты узла k в единицах геометрии. Nn — число узлов, а Ne — число элементов; эти размеры обычно различаются.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_getallnodes.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает координаты всех узлов: во встроенном Python матрицу N\\times 2.\nРезультат: ndarray формы Nn×2 float64 с координатами всех узлов в единицах геометрии."
# Уже открыто решение теплопроводности.
data = ho_getallnodes()
print(data.shape)
print(data[0]) # Первая строка либо первое узловое значение.
Ожидаемый результат. Возвращает координаты всех узлов: во встроенном Python матрицу N\times 2.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_getallelementsЧитает топологию, центры, площади и группы всех элементов. Форма в PDF и текущей сборке различается; см. проверенное примечание ниже.
femm.ho_getallelements
ho_getallelements()Читает топологию, центры, площади и группы всех элементов. Форма в PDF и текущей сборке различается; см. проверенное примечание ниже.
Аргументы
Аргументы не требуются.
Возвращаемое значение
tuple (connectivity, centroids, areas, groups): ndarray форм Ne×3 int32, Ne×2 float64, Ne float64, Ne int32; connectivity содержит номера узлов с 1.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Нативная проверка 16.10.2026 на сохранённых решениях четырёх модулей: внутри FEMM возвращается tuple из четырёх ndarray — connectivity Ne×3 int32, centroids Ne×2 float64, areas Ne float64, groups Ne int32. Connectivity содержит номера узлов с 1 и сверена с getelement(1). Дополнительный аргумент dtype команда не принимает.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_getallelements.\nСреда: встроенный MicroPython FEMM 5.\nЧитает топологию, центры, площади и группы всех элементов. Форма в PDF и текущей сборке различается; см. проверенное примечание ниже.\nРезультат: tuple (connectivity, centroids, areas, groups): ndarray форм Ne×3 int32, Ne×2 float64, Ne float64, Ne int32; connectivity содержит номера узлов с 1."
# Уже открыто решение теплопроводности.
connectivity, centroids, areas, groups = ho_getallelements()
print(connectivity.shape, centroids.shape, areas.shape, groups.shape)
# Индексы узлов connectivity начинаются с 1.
Ожидаемый результат. Читает топологию, центры, площади и группы всех элементов. Форма в PDF и текущей сборке различается; см. проверенное примечание ниже.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_getallfВозвращает компоненты плотности теплового потока в центрах элементов.
femm.ho_getallf
ho_getallf()Возвращает компоненты плотности теплового потока в центрах элементов.
Аргументы
Аргументы не требуются.
Возвращаемое значение
ndarray формы Ne×2 с двумя компонентами поля в центрах конечных элементов; физическая величина и единицы указаны ниже.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Форма результата: Ne×2; расположение значений: элементы; состав: F_x/r, F_y/z, Вт/м²; без сглаживания и поиска точки.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_getallf.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает компоненты плотности теплового потока в центрах элементов.\nРезультат: ndarray формы Ne×2 с двумя компонентами поля в центрах конечных элементов; физическая величина и единицы указаны ниже."
# Уже открыто решение теплопроводности.
data = ho_getallf()
print(data.shape)
print(data[0]) # Первая строка либо первое узловое значение.
Ожидаемый результат. Возвращает компоненты плотности теплового потока в центрах элементов.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_getalltВозвращает температуру во всех узлах сетки; это узловой вектор, а не значения в центрах элементов.
femm.ho_getallt
ho_getallt()Возвращает температуру во всех узлах сетки; это узловой вектор, а не значения в центрах элементов.
Аргументы
Аргументы не требуются.
Возвращаемое значение
Одномерный ndarray: getalla — Ne значений по элементам; getallv/getallt — Nn значений по узлам. Физическая величина и единицы указаны ниже.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Форма результата: Nn; расположение значений: узлы; состав: T, К.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_getallt.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает температуру во всех узлах сетки; это узловой вектор, а не значения в центрах элементов.\nРезультат: Одномерный ndarray: getalla — Ne значений по элементам; getallv/getallt — Nn значений по узлам. Физическая величина и единицы указаны ниже."
# Уже открыто решение теплопроводности.
data = ho_getallt()
print(data.shape)
print(data[0]) # Первая строка либо первое узловое значение.
Ожидаемый результат. Возвращает температуру во всех узлах сетки; это узловой вектор, а не значения в центрах элементов.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_gettitleВозвращает путь текущего документа.
femm.ho_gettitle
ho_gettitle()Возвращает путь текущего документа.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: имя/путь активного документа; у несохранённого документа может быть пустой путь.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_gettitle.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает путь текущего документа.\nРезультат: str: имя/путь активного документа; у несохранённого документа может быть пустой путь."
# Уже открыто решение теплопроводности.
print(ho_gettitle())
Ожидаемый результат. Возвращает путь текущего документа.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_selectlineАльтернативное имя ho_selectpoint; аргументы, действие и результат совпадают.
femm.ho_selectline
ho_selectline(x, y)Альтернативное имя ho_selectpoint; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
x | Первая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа. |
y | Вторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_selectline.\nСреда: встроенный MicroPython FEMM 5.\nАльтернативное имя ho_selectpoint; аргументы, действие и результат совпадают.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = ho_getelement(1)
x, y = element[3], element[4]
n1 = ho_getnode(int(element[0]))
n2 = ho_getnode(int(element[1]))
ho_clearcontour()
ho_addcontour(n1[0], n1[1])
ho_addcontour(n2[0], n2[1])
ho_clearcontour()
ho_selectline(n1[0], n1[1])
Ожидаемый результат. Добавляет к контуру ближайший узел исходной геометрии.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_showdensityАльтернативное имя ho_showdensityplot; аргументы, действие и результат совпадают.
femm.ho_showdensity
ho_showdensity(legend=None, gscale=None, type=None, upper=None, lower=None)Альтернативное имя ho_showdensityplot; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
legend | Переключатель отображения легенды цветовой карты. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
gscale | Переключатель градаций серого вместо цветной шкалы. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
type | Код или имя величины цветовой карты; набор зависит от физического модуля. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
upper | Верхняя граница шкалы выбранной величины. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
lower | Нижняя граница шкалы выбранной величины. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- type = 0: T
- type = 1: |F|
- type = 2: |G|
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_showdensity.\nСреда: встроенный MicroPython FEMM 5.\nАльтернативное имя ho_showdensityplot; аргументы, действие и результат совпадают.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
ho_showdensity(1, 0, 0, 400, 300)
Ожидаемый результат. Показывает цветовую карту выбранной величины с заданными пределами и легендой.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_hidedensityАльтернативное имя ho_hidedensityplot; аргументы, действие и результат совпадают.
femm.ho_hidedensity
ho_hidedensity()Альтернативное имя ho_hidedensityplot; аргументы, действие и результат совпадают.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_hidedensity.\nСреда: встроенный MicroPython FEMM 5.\nАльтернативное имя ho_hidedensityplot; аргументы, действие и результат совпадают.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_hidedensity()
Ожидаемый результат. Скрывает цветовую карту.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_showcontourАльтернативное имя ho_showcontourplot; аргументы, действие и результат совпадают.
femm.ho_showcontour
ho_showcontour(numcontours, lower_V=None, upper_V=None)Альтернативное имя ho_showcontourplot; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
numcontours | Число изолиний в заданном диапазоне. |
lower_V | Нижний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
upper_V | Верхний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- numcontours = −1: использовать настройки по умолчанию; остальные аргументы игнорируются.
- Сокращённый вызов с одним аргументом −1 использует настройки по умолчанию. Произвольное опускание остальных аргументов для другого numcontours здесь не утверждается.
- В подписи стр.141 осталась буква V из электрического раздела. В тепловом модуле отображаются изотермы T, К; имена аргументов lower_V/upper_V сохранены как в документации.
Пример
"Пример femm.ho_showcontour.\nСреда: встроенный MicroPython FEMM 5.\nАльтернативное имя ho_showcontourplot; аргументы, действие и результат совпадают.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_showcontour(20)
Ожидаемый результат. Показывает заданное число изолиний потенциала в выбранном диапазоне.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_hidecontourАльтернативное имя ho_hidecontourplot; аргументы, действие и результат совпадают.
femm.ho_hidecontour
ho_hidecontour()Альтернативное имя ho_hidecontourplot; аргументы, действие и результат совпадают.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_hidecontour.\nСреда: встроенный MicroPython FEMM 5.\nАльтернативное имя ho_hidecontourplot; аргументы, действие и результат совпадают.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_hidecontour()
Ожидаемый результат. Скрывает изолинии потенциала.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_vectorplotАльтернативное имя ho_showvectorplot; аргументы, действие и результат совпадают.
femm.ho_vectorplot
ho_vectorplot(type, scalefactor)Альтернативное имя ho_showvectorplot; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
type | Код отображаемого вектора и его компоненты для выбранного физического модуля. |
scalefactor | Коэффициент масштаба геометрии либо стрелок, в зависимости от команды. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- type = 0: выключить
- type = 1: F
- type = 2: G; знак см. в примечании ho_getpointvalues
Пример
"Пример femm.ho_vectorplot.\nСреда: встроенный MicroPython FEMM 5.\nАльтернативное имя ho_showvectorplot; аргументы, действие и результат совпадают.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение теплопроводности.
ho_vectorplot(1, 1)
Ожидаемый результат. Показывает стрелки выбранного векторного поля с заданным масштабом.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_smoothingАльтернативное имя ho_smooth; аргументы, действие и результат совпадают.
femm.ho_smoothing
ho_smoothing(flag)Альтернативное имя ho_smooth; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
flag | Строка on включает, off отключает этот режим. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.ho_smoothing.\nСреда: встроенный MicroPython FEMM 5.\nАльтернативное имя ho_smooth; аргументы, действие и результат совпадают.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение теплопроводности.
ho_smoothing("off")
Ожидаемый результат. Включает или отключает сглаживание производных поля в постпроцессоре.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.ho_getconductorpropsАльтернативное имя ho_getconductorproperties; аргументы, действие и результат совпадают.
femm.ho_getconductorprops
ho_getconductorprops(conductor)Альтернативное имя ho_getconductorproperties; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
conductor | Имя проводника. |
Возвращаемое значение
tuple из двух величин: (потенциал, суммарный заряд/ток) либо (температура, суммарная тепловая мощность). Порядок и единицы указаны ниже; неизвестное имя вызывает RuntimeError.
Особенности вызова
- Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
- Позиция результата 0 (индексация Python): температура, К
- Позиция результата 1 (индексация Python): суммарный тепловой поток, Вт
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.ho_getconductorprops.\nСреда: встроенный MicroPython FEMM 5.\nАльтернативное имя ho_getconductorproperties; аргументы, действие и результат совпадают.\nРезультат: tuple из двух величин: (потенциал, суммарный заряд/ток) либо (температура, суммарная тепловая мощность). Порядок и единицы указаны ниже; неизвестное имя вызывает RuntimeError."
# Уже открыто решение теплопроводности.
# В модели определено точное имя 'Terminal'.
value = ho_getconductorprops("Terminal")
print(value)
Ожидаемый результат. Возвращает потенциал и суммарную ответную величину именованного проводника.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
Имена в установленной сборке
Перечень получен во встроенном интерпретаторе. Он включает функции, классы и константы. Ссылки ведут к контрактам; для прямого доступа ulab учитывайте условия этого раздела.
ho_lineintegralho_blockintegralho_getpointvaluesho_makeplotho_getprobleminfoho_getconductorpropertiesho_seteditmodeho_selectblockho_groupselectblockho_selectconductorho_addcontourho_bendcontourho_selectpointho_clearcontourho_clearblockho_zoomnaturalho_zoominho_zoomoutho_zoomho_showmeshho_hidemeshho_showpointsho_hidepointsho_smoothho_showgridho_hidegridho_gridsnapho_setgridho_hidedensityplotho_showdensityplotho_hidecontourplotho_showcontourplotho_showvectorplotho_minimizeho_maximizeho_restoreho_resizeho_closeho_refreshviewho_reloadho_setfocusho_savebitmapho_savemetafileho_shownamesho_numnodesho_numelementsho_getnodeho_getelementho_getallnodesho_getallelementsho_getallfho_getalltho_gettitleho_selectlineho_showdensityho_hidedensityho_showcontourho_hidecontourho_vectorplotho_smoothingho_getconductorprops