FEMM 5

Модули и функции · встроенный MicroPython FEMM 5

femm · Тепловое решение

Команды FEMM обеспечивают подготовку документов, построение геометрии, назначение свойств, создание сетки и решение задачи. Обработка результатов включает вычисление интегралов и пакетное чтение полевых величин во всех четырёх физических модулях.

Условия работы

femm.ho_lineintegralВычисляет выбранный линейный интеграл по текущему ориентированному контуру.

femm.ho_lineintegral

ho_lineintegral(type)

Вычисляет выбранный линейный интеграл по текущему ориентированному контуру.

Аргументы

Аргументы вызова femm.ho_lineintegral
ИмяНазначение и допустимые значения
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 относится к геометрии контура.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Вычисляет выбранный интеграл по отмеченным областям; код операции зависит от физического модуля.

Аргументы

Аргументы вызова femm.ho_blockintegral
ИмяНазначение и допустимые значения
typeКод интеграла по области; список допустимых кодов приведён ниже.

Возвращаемое значение

tuple из двух float (основная величина, вторая компонента); назначение пары зависит от type. Для площади/энергии/температуры скалярная величина находится в result[0], вторая компонента равна 0.0.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • type = 0: средняя температура
  • type = 1: площадь
  • type = 2: объём
  • type = 3: среднее F
  • type = 4: среднее G
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Возвращает упорядоченный набор локальных величин в заданной точке решения.

Аргументы

Аргументы вызова femm.ho_getpointvalues
ИмяНазначение и допустимые значения
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.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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.

Аргументы

Аргументы вызова femm.ho_makeplot
ИмяНазначение и допустимые значения
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.

Пример

MicroPython FEMM 5
"Пример 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): длина единицы геометрии, м
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример femm.ho_getprobleminfo.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает тип постановки, единицы и другие параметры загруженного решения.\nРезультат: tuple параметров решения; позиции и единицы перечислены ниже. Глубина и коэффициент перевода геометрии возвращаются в метрах."

# Уже открыто решение теплопроводности.
print(ho_getprobleminfo())

Ожидаемый результат. Возвращает тип постановки, единицы и другие параметры загруженного решения.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_getconductorpropertiesВозвращает потенциал и суммарную ответную величину именованного проводника.

femm.ho_getconductorproperties

ho_getconductorproperties(conductor)

Возвращает потенциал и суммарную ответную величину именованного проводника.

Аргументы

Аргументы вызова femm.ho_getconductorproperties
ИмяНазначение и допустимые значения
conductorИмя проводника.

Возвращаемое значение

tuple из двух величин: (потенциал, суммарный заряд/ток) либо (температура, суммарная тепловая мощность). Порядок и единицы указаны ниже; неизвестное имя вызывает RuntimeError.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Позиция результата 0 (индексация Python): температура, К
  • Позиция результата 1 (индексация Python): суммарный тепловой поток, Вт
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Выбирает класс объектов для следующих операций редактирования или чтения решения.

Аргументы

Аргументы вызова femm.ho_seteditmode
ИмяНазначение и допустимые значения
modeРежим чтения решения: point, contour или area.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример femm.ho_seteditmode.\nСреда: встроенный MicroPython FEMM 5.\nВыбирает класс объектов для следующих операций редактирования или чтения решения.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."

# Уже открыто решение теплопроводности.
ho_seteditmode("area")

Ожидаемый результат. Выбирает класс объектов для следующих операций редактирования или чтения решения.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_selectblockВыбирает область решения, содержащую заданную точку.

femm.ho_selectblock

ho_selectblock(x, y)

Выбирает область решения, содержащую заданную точку.

Аргументы

Аргументы вызова femm.ho_selectblock
ИмяНазначение и допустимые значения
xПервая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа.
yВторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Повторный выбор того же объекта переключает его выделение. Для воспроизводимой выборки сначала снимайте выделение командой clearselected/clearblock соответствующего семейства.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Выбирает области решения по номеру группы.

Аргументы

Аргументы вызова femm.ho_groupselectblock
ИмяНазначение и допустимые значения
nНомер группы областей; без аргумента выбираются все области. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Вызов без n выбирает все области, хотя аргумент в основной записи PDF не помечен как необязательный.
  • Повторный выбор того же объекта переключает его выделение. Для воспроизводимой выборки сначала снимайте выделение командой clearselected/clearblock соответствующего семейства.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Выбирает объекты, относящиеся к указанному проводнику.

Аргументы

Аргументы вызова femm.ho_selectconductor
ИмяНазначение и допустимые значения
nameИмя выбираемого объекта, модуля или передаваемой переменной.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Стр.139 ошибочно переносит назначение weighted stress tensor из электрического раздела. В таблице ho_blockintegral (стр.138) тепловых сил и моментов нет; этой командой нельзя обосновывать механическую силу из температурного решения.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Добавляет точку в конец текущего контура интегрирования.

Аргументы

Аргументы вызова femm.ho_addcontour
ИмяНазначение и допустимые значения
xПервая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа.
yВторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Заменяет последний прямой участок контура дугой с указанным углом и шагом.

Аргументы

Аргументы вызова femm.ho_bendcontour
ИмяНазначение и допустимые значения
angleУгол в градусах; смысл задаётся операцией дуги, поворота или чтения зазора.
anglestepУгловой шаг разбиения дуги контура, градусы. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Допустимый angle: от -180^\circ до +180^\circ; anglestep > 0. Если контур содержит менее двух точек, команда не изменяет его.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Добавляет к контуру ближайший узел исходной геометрии.

Аргументы

Аргументы вызова femm.ho_selectpoint
ИмяНазначение и допустимые значения
xПервая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа.
yВторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_zoomnatural.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает всю геометрию в доступном окне.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_zoomnatural()

Ожидаемый результат. Показывает всю геометрию в доступном окне.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_zoominУвеличивает масштаб вида.

femm.ho_zoomin

ho_zoomin()

Увеличивает масштаб вида.

Аргументы

Аргументы не требуются.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_zoomin.\nСреда: встроенный MicroPython FEMM 5.\nУвеличивает масштаб вида.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_zoomin()

Ожидаемый результат. Увеличивает масштаб вида.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_zoomoutУменьшает масштаб вида.

femm.ho_zoomout

ho_zoomout()

Уменьшает масштаб вида.

Аргументы

Аргументы не требуются.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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)

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

Аргументы

Аргументы вызова femm.ho_zoom
ИмяНазначение и допустимые значения
x1Первая координата начальной точки или первого угла; единицы геометрии.
y1Вторая координата начальной точки или первого угла; единицы геометрии.
x2Первая координата конечной точки или второго угла; единицы геометрии.
y2Вторая координата конечной точки или второго угла; единицы геометрии.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_showmesh.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает рёбра конечной сетки.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_showmesh()

Ожидаемый результат. Показывает рёбра конечной сетки.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_hidemeshСкрывает рёбра конечной сетки.

femm.ho_hidemesh

ho_hidemesh()

Скрывает рёбра конечной сетки.

Аргументы

Аргументы не требуются.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_hidemesh.\nСреда: встроенный MicroPython FEMM 5.\nСкрывает рёбра конечной сетки.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_hidemesh()

Ожидаемый результат. Скрывает рёбра конечной сетки.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_showpointsПоказывает узлы исходной геометрии.

femm.ho_showpoints

ho_showpoints()

Показывает узлы исходной геометрии.

Аргументы

Аргументы не требуются.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_showpoints.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает узлы исходной геометрии.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_showpoints()

Ожидаемый результат. Показывает узлы исходной геометрии.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_hidepointsСкрывает узлы исходной геометрии.

femm.ho_hidepoints

ho_hidepoints()

Скрывает узлы исходной геометрии.

Аргументы

Аргументы не требуются.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_hidepoints.\nСреда: встроенный MicroPython FEMM 5.\nСкрывает узлы исходной геометрии.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_hidepoints()

Ожидаемый результат. Скрывает узлы исходной геометрии.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_smoothВключает или отключает сглаживание производных поля в постпроцессоре.

femm.ho_smooth

ho_smooth(flag)

Включает или отключает сглаживание производных поля в постпроцессоре.

Аргументы

Аргументы вызова femm.ho_smooth
ИмяНазначение и допустимые значения
flagСтрока on включает, off отключает этот режим.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_showgrid.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает координатную сетку вида.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_showgrid()

Ожидаемый результат. Показывает координатную сетку вида.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_hidegridСкрывает координатную сетку вида.

femm.ho_hidegrid

ho_hidegrid()

Скрывает координатную сетку вида.

Аргументы

Аргументы не требуются.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_hidegrid.\nСреда: встроенный MicroPython FEMM 5.\nСкрывает координатную сетку вида.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_hidegrid()

Ожидаемый результат. Скрывает координатную сетку вида.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_gridsnapВключает или отключает привязку координат к сетке вида.

femm.ho_gridsnap

ho_gridsnap(flag)

Включает или отключает привязку координат к сетке вида.

Аргументы

Аргументы вызова femm.ho_gridsnap
ИмяНазначение и допустимые значения
flagСтрока on включает, off отключает этот режим.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Задаёт шаг и декартов либо полярный тип координатной сетки.

Аргументы

Аргументы вызова femm.ho_setgrid
ИмяНазначение и допустимые значения
densityРасстояние между точками координатной сетки; единицы геометрии. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
typeСистема координат сетки вида: cart или polar. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Оба аргумента можно опустить; второй аргумент, если передан, должен быть строкой "cart" или "polar". Числовой код вместо строки вызывает TypeError.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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)

Показывает цветовую карту выбранной величины с заданными пределами и легендой.

Аргументы

Аргументы вызова femm.ho_showdensityplot
ИмяНазначение и допустимые значения
legendПереключатель отображения легенды цветовой карты. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
gscaleПереключатель градаций серого вместо цветной шкалы. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
typeКод или имя величины цветовой карты; набор зависит от физического модуля. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
upperВерхняя граница шкалы выбранной величины. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
lowerНижняя граница шкалы выбранной величины. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • type = 0: T
  • type = 1: |F|
  • type = 2: |G|
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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)

Показывает заданное число изолиний потенциала в выбранном диапазоне.

Аргументы

Аргументы вызова femm.ho_showcontourplot
ИмяНазначение и допустимые значения
numcontoursЧисло изолиний в заданном диапазоне.
lower_VНижний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
upper_VВерхний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • numcontours = −1: использовать настройки по умолчанию; остальные аргументы игнорируются.
  • Сокращённый вызов с одним аргументом −1 использует настройки по умолчанию. Произвольное опускание остальных аргументов для другого numcontours здесь не утверждается.
  • В подписи стр.141 осталась буква V из электрического раздела. В тепловом модуле отображаются изотермы T, К; имена аргументов lower_V/upper_V сохранены как в документации.

Пример

MicroPython FEMM 5
"Пример femm.ho_showcontourplot.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает заданное число изолиний потенциала в выбранном диапазоне.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_showcontourplot(20)

Ожидаемый результат. Показывает заданное число изолиний потенциала в выбранном диапазоне.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_showvectorplotПоказывает стрелки выбранного векторного поля с заданным масштабом.

femm.ho_showvectorplot

ho_showvectorplot(type, scalefactor)

Показывает стрелки выбранного векторного поля с заданным масштабом.

Аргументы

Аргументы вызова femm.ho_showvectorplot
ИмяНазначение и допустимые значения
typeКод отображаемого вектора и его компоненты для выбранного физического модуля.
scalefactorКоэффициент масштаба геометрии либо стрелок, в зависимости от команды.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • type = 0: выключить
  • type = 1: F
  • type = 2: G; знак см. в примечании ho_getpointvalues

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_minimize.\nСреда: встроенный MicroPython FEMM 5.\nСворачивает окно документа.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_minimize()

Ожидаемый результат. Сворачивает окно документа.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_maximizeРазворачивает окно документа.

femm.ho_maximize

ho_maximize()

Разворачивает окно документа.

Аргументы

Аргументы не требуются.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_maximize.\nСреда: встроенный MicroPython FEMM 5.\nРазворачивает окно документа.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_maximize()

Ожидаемый результат. Разворачивает окно документа.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_restoreВозвращает обычный размер окна документа.

femm.ho_restore

ho_restore()

Возвращает обычный размер окна документа.

Аргументы

Аргументы не требуются.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_restore.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает обычный размер окна документа.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_restore()

Ожидаемый результат. Возвращает обычный размер окна документа.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_resizeУстанавливает размер окна в пикселях.

femm.ho_resize

ho_resize(width, height)

Устанавливает размер окна в пикселях.

Аргументы

Аргументы вызова femm.ho_resize
ИмяНазначение и допустимые значения
widthШирина окна в пикселях.
heightВысота окна в пикселях.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример femm.ho_close.\nСреда: встроенный MicroPython FEMM 5.\nЗакрывает активный документ этого семейства.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."

# Уже открыто решение теплопроводности.
ho_close()

Ожидаемый результат. Закрывает активный документ этого семейства.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_refreshviewПерерисовывает активное окно.

femm.ho_refreshview

ho_refreshview()

Перерисовывает активное окно.

Аргументы

Аргументы не требуются.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример femm.ho_refreshview.\nСреда: встроенный MicroPython FEMM 5.\nПерерисовывает активное окно.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."

# Уже открыто решение теплопроводности.
ho_refreshview()

Ожидаемый результат. Перерисовывает активное окно.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_reloadПовторно загружает файл решения с диска.

femm.ho_reload

ho_reload()

Повторно загружает файл решения с диска.

Аргументы

Аргументы не требуются.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример femm.ho_reload.\nСреда: встроенный MicroPython FEMM 5.\nПовторно загружает файл решения с диска.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."

# Уже открыто решение теплопроводности.
ho_reload()

Ожидаемый результат. Повторно загружает файл решения с диска.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

femm.ho_setfocusВыбирает документ, к которому будут относиться следующие команды данного семейства.

femm.ho_setfocus

ho_setfocus(documentname=None)

Выбирает документ, к которому будут относиться следующие команды данного семейства.

Аргументы

Аргументы вызова femm.ho_setfocus
ИмяНазначение и допустимые значения
documentnameИмя документа для выбора активного окна. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Сохраняет изображение текущего вида в растровый файл; численные данные результата сохраняются отдельно.

Аргументы

Аргументы вызова femm.ho_savebitmap
ИмяНазначение и допустимые значения
filenameПуть к читаемому или записываемому файлу.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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 соответствующего модуля.

Аргументы

Аргументы вызова femm.ho_savemetafile
ИмяНазначение и допустимые значения
filenameПуть к читаемому или записываемому файлу. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Включает или отключает показ имён меток областей.

Аргументы

Аргументы вызова femm.ho_shownames
ИмяНазначение и допустимые значения
flag0 отключает отображение, 1 включает.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Возвращает координаты узла сетки по индексу, начинающемуся с единицы.

Аргументы

Аргументы вызова femm.ho_getnode
ИмяНазначение и допустимые значения
nИндекс узла сетки, начиная с 1.

Возвращаемое значение

tuple из двух float: (x, y) или (r, z), в единицах геометрии. None при индексе вне сетки.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Возврат: координаты x,y либо r,z в единицах геометрии. Индекс n начинается с 1; индекс массива Python начинается с 0.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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)

Возвращает три индекса узлов, центр, площадь и группу одного треугольника.

Аргументы

Аргументы вызова femm.ho_getelement
ИмяНазначение и допустимые значения
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): номер группы области
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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 — число элементов; эти размеры обычно различаются.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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 команда не принимает.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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, Вт/м²; без сглаживания и поиска точки.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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, К.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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; аргументы, действие и результат совпадают.

Аргументы

Аргументы вызова femm.ho_selectline
ИмяНазначение и допустимые значения
xПервая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа.
yВторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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; аргументы, действие и результат совпадают.

Аргументы

Аргументы вызова femm.ho_showdensity
ИмяНазначение и допустимые значения
legendПереключатель отображения легенды цветовой карты. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
gscaleПереключатель градаций серого вместо цветной шкалы. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
typeКод или имя величины цветовой карты; набор зависит от физического модуля. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
upperВерхняя граница шкалы выбранной величины. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
lowerНижняя граница шкалы выбранной величины. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • type = 0: T
  • type = 1: |F|
  • type = 2: |G|
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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; аргументы, действие и результат совпадают.

Аргументы

Аргументы вызова femm.ho_showcontour
ИмяНазначение и допустимые значения
numcontoursЧисло изолиний в заданном диапазоне.
lower_VНижний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
upper_VВерхний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • numcontours = −1: использовать настройки по умолчанию; остальные аргументы игнорируются.
  • Сокращённый вызов с одним аргументом −1 использует настройки по умолчанию. Произвольное опускание остальных аргументов для другого numcontours здесь не утверждается.
  • В подписи стр.141 осталась буква V из электрического раздела. В тепловом модуле отображаются изотермы T, К; имена аргументов lower_V/upper_V сохранены как в документации.

Пример

MicroPython FEMM 5
"Пример 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() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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; аргументы, действие и результат совпадают.

Аргументы

Аргументы вызова femm.ho_vectorplot
ИмяНазначение и допустимые значения
typeКод отображаемого вектора и его компоненты для выбранного физического модуля.
scalefactorКоэффициент масштаба геометрии либо стрелок, в зависимости от команды.

Возвращаемое значение

str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • type = 0: выключить
  • type = 1: F
  • type = 2: G; знак см. в примечании ho_getpointvalues

Пример

MicroPython FEMM 5
"Пример 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; аргументы, действие и результат совпадают.

Аргументы

Аргументы вызова femm.ho_smoothing
ИмяНазначение и допустимые значения
flagСтрока on включает, off отключает этот режим.

Возвращаемое значение

None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.

Пример

MicroPython FEMM 5
"Пример 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; аргументы, действие и результат совпадают.

Аргументы

Аргументы вызова femm.ho_getconductorprops
ИмяНазначение и допустимые значения
conductorИмя проводника.

Возвращаемое значение

tuple из двух величин: (потенциал, суммарный заряд/ток) либо (температура, суммарная тепловая мощность). Порядок и единицы указаны ниже; неизвестное имя вызывает RuntimeError.

Особенности вызова

  • Предусловие: загружено решение теплопроводности командой hi_loadsolution() либо открытием сохранённого результата.
  • Позиция результата 0 (индексация Python): температура, К
  • Позиция результата 1 (индексация Python): суммарный тепловой поток, Вт
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример femm.ho_getconductorprops.\nСреда: встроенный MicroPython FEMM 5.\nАльтернативное имя ho_getconductorproperties; аргументы, действие и результат совпадают.\nРезультат: tuple из двух величин: (потенциал, суммарный заряд/ток) либо (температура, суммарная тепловая мощность). Порядок и единицы указаны ниже; неизвестное имя вызывает RuntimeError."

# Уже открыто решение теплопроводности.
# В модели определено точное имя 'Terminal'.
value = ho_getconductorprops("Terminal")
print(value)

Ожидаемый результат. Возвращает потенциал и суммарную ответную величину именованного проводника.

Скачать пример · Ссылка на функцию · Подробности команды FEMM

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

Имена в установленной сборке

Перечень получен во встроенном интерпретаторе. Он включает функции, классы и константы. Ссылки ведут к контрактам; для прямого доступа ulab учитывайте условия этого раздела.