FEMM 5

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

femm · Решение токопроводимости

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

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

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

femm.co_lineintegral

co_lineintegral(type)

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

Аргументы

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

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

tuple из четырёх complex; смысл позиций зависит от type. Для type=2: (длина+0j, площадь+0j, 0j, 0j), м и м². В других режимах мнимая часть может кодировать вторую реальную компоненту, поэтому её нельзя автоматически отбрасывать.

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • type = 0: интеграл E\cdot t
  • type = 1: интеграл J\cdot n
  • type = 2: длина и площадь поверхности
  • type = 3: средний потенциал
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
  • В проверенной сборке допустимы type=0…3. Коды силы/момента 4 и 5, перечисленные в таблице руководства, текущая реализация отклоняет исключением RuntimeError.

Пример

MicroPython FEMM 5
"Пример femm.co_lineintegral.\nСреда: встроенный MicroPython FEMM 5.\nВычисляет выбранный линейный интеграл по текущему ориентированному контуру.\nРезультат: tuple из четырёх complex; смысл позиций зависит от type. Для type=2: (длина+0j, площадь+0j, 0j, 0j), м и м². В других режимах мнимая часть может кодировать вторую реальную компоненту, поэтому её нельзя автоматически отбрасывать."

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
n1 = co_getnode(int(element[0]))
n2 = co_getnode(int(element[1]))
co_clearcontour()
co_addcontour(n1[0], n1[1])
co_addcontour(n2[0], n2[1])
result = co_lineintegral(2)
print(result)  # Геометрические величины контура в СИ.

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

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

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

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

femm.co_blockintegral

co_blockintegral(type)

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

Аргументы

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

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

Одно число float для вещественной величины или complex для фазорной величины; тип определяется кодом интеграла и частотой. Единицы СИ; выбор областей обязателен.

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • type = 0: активная мощность
  • type = 1: реактивная мощность
  • type = 2: полная мощность
  • type = 3: усреднённая во времени энергия
  • type = 4: площадь
  • type = 5: объём
  • type = 6: постоянная взвешенная сила x/r
  • type = 7: постоянная взвешенная сила y/z
  • type = 8: взвешенная сила 2\omega по x/r
  • type = 9: взвешенная сила 2\omega по y/z
  • type = 10: постоянный взвешенный момент
  • type = 11: взвешенный момент 2\omega
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример femm.co_blockintegral.\nСреда: встроенный MicroPython FEMM 5.\nВычисляет выбранный интеграл по отмеченным областям; код операции зависит от физического модуля.\nРезультат: Одно число float для вещественной величины или complex для фазорной величины; тип определяется кодом интеграла и частотой. Единицы СИ; выбор областей обязателен."

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
co_clearblock()
co_selectblock(x, y)
area_result = co_blockintegral(4)
print(area_result)  # Площадь выбранной области, м².

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

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

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

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

femm.co_getpointvalues

co_getpointvalues(X, Y)

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

Аргументы

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

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

tuple из 15 локальных величин в порядке, приведённом ниже; None, если точка вне расчётной сетки. Магнитные и токовые величины с фазой при ненулевой частоте комплексные.

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • Позиция результата 0 (индексация Python): V — потенциал, В
  • Позиция результата 1 (индексация Python): Jx — компонента плотности полного тока Jx/r, А/м²
  • Позиция результата 2 (индексация Python): Jy — компонента плотности полного тока Jy/z, А/м²
  • Позиция результата 3 (индексация Python): Kx — эффективная комплексная проводимость по x/r, См/м
  • Позиция результата 4 (индексация Python): Ky — эффективная комплексная проводимость по y/z, См/м
  • Позиция результата 5 (индексация Python): Ex — компонента напряжённости Ex/r, В/м
  • Позиция результата 6 (индексация Python): Ey — компонента напряжённости Ey/z, В/м
  • Позиция результата 7 (индексация Python): ex — относительная \varepsilon _{x}/r, безразмерная
  • Позиция результата 8 (индексация Python): ey — относительная \varepsilon _{y}/z, безразмерная
  • Позиция результата 9 (индексация Python): Jdx — компонента плотности тока смещения Jdx/r, А/м²
  • Позиция результата 10 (индексация Python): Jdy — компонента плотности тока смещения Jdy/z, А/м²
  • Позиция результата 11 (индексация Python): ox — параметр проводимости \sigma _{x}/r, См/м; см. замечание
  • Позиция результата 12 (индексация Python): oy — параметр проводимости \sigma _{y}/z, См/м; см. замечание
  • Позиция результата 13 (индексация Python): Jcx — компонента плотности тока проводимости Jcx/r, А/м²
  • Позиция результата 14 (индексация Python): Jcy — компонента плотности тока проводимости Jcy/z, А/м²
  • В таблице стр.152 ox/oy названы проницаемостью, однако параметры материала с этими именами на стр.148 — проводимости. Это несогласованность PDF; возвращаемые ox/oy отдельно не верифицированы.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

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

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
values = co_getpointvalues(x, y)
print(values)

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

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

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

femm.co_makeplotВыполняет выборку выбранной величины вдоль текущего контура; при заданном имени файла сохраняет значения в CSV.

femm.co_makeplot

co_makeplot(PlotType, NumPoints=None, Filename=None, FileFormat=None)

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

Аргументы

Аргументы вызова femm.co_makeplot
ИмяНазначение и допустимые значения
PlotTypeКод скалярной или компонентной величины для графика по контуру.
NumPointsЧисло точек выборки вдоль контура. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
FilenameПуть для выгрузки точек графика; при отсутствии показывается график. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.
FileFormatСовместимый четвёртый аргумент makeplot: в FEMM5 принимается, но игнорируется; данные записываются в CSV. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию.

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

float: число точек, фактически выбранных вдоль контура. При заданном Filename дополнительно записывается CSV; ошибка файла вызывает RuntimeError.

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • При заданном Filename FEMM 5 записывает CSV с заголовком. FileFormat сохранён для совместимости и игнорируется; это не экспорт метафайла.
  • PlotType = 0: V
  • PlotType = 1: |J|
  • PlotType = 2: J\cdot n
  • PlotType = 3: J\cdot t
  • PlotType = 4: |E|
  • PlotType = 5: E\cdot n
  • PlotType = 6: E\cdot t
  • PlotType = 7: |J_c|
  • PlotType = 8: J_c\cdot n
  • PlotType = 9: J_c\cdot t
  • PlotType = 10: |J_d|
  • PlotType = 11: J_d\cdot n
  • PlotType = 12: J_d\cdot t
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
  • NumPoints по умолчанию 150; значения меньше 2 повышаются до 2. Нужен контур хотя бы из двух точек. Возвращается число выбранных точек; CSV сохраняется только при непустом Filename.

Пример

MicroPython FEMM 5
"Пример femm.co_makeplot.\nСреда: встроенный MicroPython FEMM 5.\nВыполняет выборку выбранной величины вдоль текущего контура; при заданном имени файла сохраняет значения в CSV.\nРезультат: float: число точек, фактически выбранных вдоль контура. При заданном Filename дополнительно записывается CSV; ошибка файла вызывает RuntimeError."

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
n1 = co_getnode(int(element[0]))
n2 = co_getnode(int(element[1]))
co_clearcontour()
co_addcontour(n1[0], n1[1])
co_addcontour(n2[0], n2[1])
co_makeplot(0, 101, "contour.csv")  # 101 точка вдоль построенного контура.

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

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

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

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

femm.co_getprobleminfo

co_getprobleminfo()

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

Аргументы

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

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

tuple параметров решения; позиции и единицы перечислены ниже. Глубина и коэффициент перевода геометрии возвращаются в метрах.

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

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

Пример

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

# Уже открыто решение протекания тока.
print(co_getprobleminfo())

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

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

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

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

femm.co_getconductorproperties

co_getconductorproperties(conductor)

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

Аргументы

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

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

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

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

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

Пример

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

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

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

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

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

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

femm.co_seteditmode

co_seteditmode(mode)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_seteditmode("area")

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

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

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

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

femm.co_selectblock

co_selectblock(x, y)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
co_clearblock()
co_selectblock(x, y)

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

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

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

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

femm.co_groupselectblock

co_groupselectblock(n=None)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
co_clearblock()
# В примере выбираются все области независимо от номера группы.
co_groupselectblock()

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

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

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

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

femm.co_selectconductor

co_selectconductor(name)

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

Аргументы

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

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

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

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

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

Пример

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

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

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

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

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

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

femm.co_addcontour

co_addcontour(x, y)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
n1 = co_getnode(int(element[0]))
n2 = co_getnode(int(element[1]))
co_clearcontour()
co_addcontour(n1[0], n1[1])
co_addcontour(n2[0], n2[1])

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

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

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

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

femm.co_bendcontour

co_bendcontour(angle, anglestep=None)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
n1 = co_getnode(int(element[0]))
n2 = co_getnode(int(element[1]))
co_clearcontour()
co_addcontour(n1[0], n1[1])
co_addcontour(n2[0], n2[1])
co_bendcontour(30, 1)  # Последний участок становится дугой 30°.

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

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

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

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

femm.co_selectpoint

co_selectpoint(x, y)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
n1 = co_getnode(int(element[0]))
n2 = co_getnode(int(element[1]))
co_clearcontour()
co_addcontour(n1[0], n1[1])
co_addcontour(n2[0], n2[1])
co_clearcontour()
co_selectpoint(n1[0], n1[1])

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

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

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

femm.co_clearcontourУдаляет текущий контур интегрирования.

femm.co_clearcontour

co_clearcontour()

Удаляет текущий контур интегрирования.

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
n1 = co_getnode(int(element[0]))
n2 = co_getnode(int(element[1]))
co_clearcontour()
co_addcontour(n1[0], n1[1])
co_addcontour(n2[0], n2[1])
co_clearcontour()

Ожидаемый результат. Удаляет текущий контур интегрирования.

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

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

femm.co_clearblockСнимает выбор областей решения.

femm.co_clearblock

co_clearblock()

Снимает выбор областей решения.

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
co_clearblock()

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

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

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

femm.co_zoomnaturalПоказывает всю геометрию в доступном окне.

femm.co_zoomnatural

co_zoomnatural()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_zoomnatural()

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

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

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

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

femm.co_zoomin

co_zoomin()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_zoomin()

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

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

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

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

femm.co_zoomout

co_zoomout()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_zoomout()

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

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

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

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

femm.co_zoom

co_zoom(x1, y1, x2, y2)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_zoom(0, 0, 20, 10)

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

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

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

femm.co_showmeshПоказывает рёбра конечной сетки.

femm.co_showmesh

co_showmesh()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_showmesh()

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

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

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

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

femm.co_hidemesh

co_hidemesh()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_hidemesh()

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

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

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

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

femm.co_showpoints

co_showpoints()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_showpoints()

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

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

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

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

femm.co_hidepoints

co_hidepoints()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_hidepoints()

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

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

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

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

femm.co_smooth

co_smooth(flag)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_smooth("off")

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

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

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

femm.co_showgridПоказывает координатную сетку вида.

femm.co_showgrid

co_showgrid()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_showgrid()

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

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

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

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

femm.co_hidegrid

co_hidegrid()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_hidegrid()

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

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

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

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

femm.co_gridsnap

co_gridsnap(flag)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_gridsnap("off")

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

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

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

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

femm.co_setgrid

co_setgrid(density=None, type=None)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_setgrid(1, "cart")

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

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

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

femm.co_hidedensityplotСкрывает цветовую карту.

femm.co_hidedensityplot

co_hidedensityplot()

Скрывает цветовую карту.

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_hidedensityplot()

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

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

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

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

femm.co_showdensityplot

co_showdensityplot(legend=None, gscale=None, type=None, upper=None, lower=None)

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

Аргументы

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

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

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

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • type = 0: |V|
  • type = 1: |\operatorname{Re} V|
  • type = 2: |\operatorname{Im} V|
  • type = 3: |J|
  • type = 4: |\operatorname{Re} J|
  • type = 5: |\operatorname{Im} J|
  • type = 6: |E|
  • type = 7: |\operatorname{Re} E|
  • type = 8: |\operatorname{Im} E|
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

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

# Уже открыто решение протекания тока.
co_showdensityplot(1, 0, 0, 1, 0)

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

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

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

femm.co_hidecontourplotСкрывает изолинии потенциала.

femm.co_hidecontourplot

co_hidecontourplot()

Скрывает изолинии потенциала.

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_hidecontourplot()

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

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

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

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

femm.co_showcontourplot

co_showcontourplot(numcontours, lower_V=None, upper_V=None, type=None)

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

Аргументы

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

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

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

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • На стр.155 аргумент type напечатан после закрывающей скобки. Он возвращён в список по следующему описанию параметров.
  • numcontours = −1: использовать настройки по умолчанию; остальные аргументы игнорируются.
  • Сокращённый вызов с одним аргументом −1 использует настройки по умолчанию. Произвольное опускание остальных аргументов для другого numcontours здесь не утверждается.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

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

# Уже открыто решение протекания тока.
co_showcontourplot(20)

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

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

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

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

femm.co_showvectorplot

co_showvectorplot(type, scalefactor)

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

Аргументы

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

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

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

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • type = 0: выключить
  • type = 1: \operatorname{Re} J
  • type = 2: \operatorname{Re} E
  • type = 3: \operatorname{Im} J
  • type = 4: \operatorname{Im} E
  • type = 5: \operatorname{Re} J и \operatorname{Im} J
  • type = 6: \operatorname{Re} E и \operatorname{Im} E

Пример

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

# Уже открыто решение протекания тока.
co_showvectorplot(1, 1)

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

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

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

femm.co_minimizeСворачивает окно документа.

femm.co_minimize

co_minimize()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_minimize()

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

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

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

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

femm.co_maximize

co_maximize()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_maximize()

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

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

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

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

femm.co_restore

co_restore()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_restore()

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

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

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

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

femm.co_resize

co_resize(width, height)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_resize(1000, 700)

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

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

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

femm.co_closeЗакрывает активный документ этого семейства.

femm.co_close

co_close()

Закрывает активный документ этого семейства.

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_close()

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

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

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

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

femm.co_refreshview

co_refreshview()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_refreshview()

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

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

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

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

femm.co_reload

co_reload()

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_reload()

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

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

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

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

femm.co_setfocus

co_setfocus(documentname=None)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
# Файл sample.anc уже открыт в постпроцессоре.
co_setfocus("sample.anc")

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

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

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

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

femm.co_savebitmap

co_savebitmap(filename)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_savebitmap("solution.png")

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

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

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

femm.co_savemetafileСовместимое имя старого экспорта; в FEMM 5 Qt эта команда ничего не делает. Для изображения применяйте savebitmap соответствующего модуля.

femm.co_savemetafile

co_savemetafile(filename=None)

Совместимое имя старого экспорта; в FEMM 5 Qt эта команда ничего не делает. Для изображения применяйте savebitmap соответствующего модуля.

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_savemetafile("solution.emf")

Ожидаемый результат. Совместимое имя старого экспорта; в FEMM 5 Qt эта команда ничего не делает. Для изображения применяйте savebitmap соответствующего модуля.

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

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

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

femm.co_shownames

co_shownames(flag)

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

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_shownames(1)

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

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

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

femm.co_numnodesВозвращает число узлов конечной сетки.

femm.co_numnodes

co_numnodes()

Возвращает число узлов конечной сетки.

Аргументы

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

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

Числовое значение float, равное целому числу узлов/элементов. Для range используйте int(result).

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

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

Пример

MicroPython FEMM 5
"Пример femm.co_numnodes.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает число узлов конечной сетки.\nРезультат: Числовое значение float, равное целому числу узлов/элементов. Для range используйте int(result)."

# Уже открыто решение протекания тока.
print(co_numnodes())

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

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

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

femm.co_numelementsВозвращает число треугольных элементов сетки.

femm.co_numelements

co_numelements()

Возвращает число треугольных элементов сетки.

Аргументы

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

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

Числовое значение float, равное целому числу узлов/элементов. Для range используйте int(result).

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

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

Пример

MicroPython FEMM 5
"Пример femm.co_numelements.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает число треугольных элементов сетки.\nРезультат: Числовое значение float, равное целому числу узлов/элементов. Для range используйте int(result)."

# Уже открыто решение протекания тока.
print(co_numelements())

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

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

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

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

femm.co_getnode

co_getnode(n)

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

Аргументы

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

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

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

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

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

Пример

MicroPython FEMM 5
"Пример femm.co_getnode.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает координаты узла сетки по индексу, начинающемуся с единицы.\nРезультат: tuple из двух float: (x, y) или (r, z), в единицах геометрии. None при индексе вне сетки."

# Уже открыто решение протекания тока.
print(co_getnode(1))  # FEMM нумерует узлы и элементы с 1.

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

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

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

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

femm.co_getelement

co_getelement(n)

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

Аргументы

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

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

tuple из 7 чисел: (n1, n2, n3, xc, yc, area, group); номера узлов начинаются с 1, площадь в квадрате единицы геометрии. None при неверном индексе.

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

  • Предусловие: загружено решение протекания тока командой ci_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.co_getelement.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает три индекса узлов, центр, площадь и группу одного треугольника.\nРезультат: tuple из 7 чисел: (n1, n2, n3, xc, yc, area, group); номера узлов начинаются с 1, площадь в квадрате единицы геометрии. None при неверном индексе."

# Уже открыто решение протекания тока.
print(co_getelement(1))  # FEMM нумерует узлы и элементы с 1.

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

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

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

femm.co_getallnodesВозвращает координаты всех узлов: во встроенном Python матрицу N\times 2.

femm.co_getallnodes

co_getallnodes()

Возвращает координаты всех узлов: во встроенном Python матрицу N\times 2.

Аргументы

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

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

ndarray формы Nn×2 float64 с координатами всех узлов в единицах геометрии.

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • Форма: Nn×2; строка k-1 содержит координаты узла k в единицах геометрии. Nn — число узлов, а Ne — число элементов; эти размеры обычно различаются.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример femm.co_getallnodes.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает координаты всех узлов: во встроенном Python матрицу N\\times 2.\nРезультат: ndarray формы Nn×2 float64 с координатами всех узлов в единицах геометрии."

# Уже открыто решение протекания тока.
data = co_getallnodes()
print(data.shape)
print(data[0])  # Первая строка либо первое узловое значение.

Ожидаемый результат. Возвращает координаты всех узлов: во встроенном Python матрицу N\times 2.

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

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

femm.co_getallelementsЧитает топологию, центры, площади и группы всех элементов. Форма в PDF и текущей сборке различается; см. проверенное примечание ниже.

femm.co_getallelements

co_getallelements()

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

Аргументы

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

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

tuple (connectivity, centroids, areas, groups): ndarray форм Ne×3 int32, Ne×2 float64, Ne float64, Ne int32; connectivity содержит номера узлов с 1.

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

  • Предусловие: загружено решение протекания тока командой ci_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.co_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 = co_getallelements()
print(connectivity.shape, centroids.shape, areas.shape, groups.shape)
# Индексы узлов connectivity начинаются с 1.

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

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

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

femm.co_getalljВозвращает компоненты плотности тока в центрах элементов.

femm.co_getallj

co_getallj()

Возвращает компоненты плотности тока в центрах элементов.

Аргументы

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

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

ndarray формы Ne×2 с двумя компонентами поля в центрах конечных элементов; физическая величина и единицы указаны ниже.

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • Форма результата: Ne×2; расположение значений: элементы; состав: Jx/r, Jy/z, А/м²; без сглаживания и поиска точки.
  • В магнитной и токовой гармонических задачах величины с фазой могут быть комплексными; не отбрасывайте мнимую часть при сохранении.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

MicroPython FEMM 5
"Пример femm.co_getallj.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает компоненты плотности тока в центрах элементов.\nРезультат: ndarray формы Ne×2 с двумя компонентами поля в центрах конечных элементов; физическая величина и единицы указаны ниже."

# Уже открыто решение протекания тока.
data = co_getallj()
print(data.shape)
print(data[0])  # Первая строка либо первое узловое значение.

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

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

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

femm.co_getallvВозвращает электрический потенциал во всех узлах сетки; это узловой вектор, а не значения в центрах элементов.

femm.co_getallv

co_getallv()

Возвращает электрический потенциал во всех узлах сетки; это узловой вектор, а не значения в центрах элементов.

Аргументы

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

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

Одномерный ndarray: getalla — Ne значений по элементам; getallv/getallt — Nn значений по узлам. Физическая величина и единицы указаны ниже.

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

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

Пример

MicroPython FEMM 5
"Пример femm.co_getallv.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает электрический потенциал во всех узлах сетки; это узловой вектор, а не значения в центрах элементов.\nРезультат: Одномерный ndarray: getalla — Ne значений по элементам; getallv/getallt — Nn значений по узлам. Физическая величина и единицы указаны ниже."

# Уже открыто решение протекания тока.
data = co_getallv()
print(data.shape)
print(data[0])  # Первая строка либо первое узловое значение.

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

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

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

femm.co_gettitleВозвращает путь текущего документа.

femm.co_gettitle

co_gettitle()

Возвращает путь текущего документа.

Аргументы

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

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

str: имя/путь активного документа; у несохранённого документа может быть пустой путь.

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

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

Пример

MicroPython FEMM 5
"Пример femm.co_gettitle.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает путь текущего документа.\nРезультат: str: имя/путь активного документа; у несохранённого документа может быть пустой путь."

# Уже открыто решение протекания тока.
print(co_gettitle())

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

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

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

femm.co_selectlineАльтернативное имя co_selectpoint; аргументы, действие и результат совпадают.

femm.co_selectline

co_selectline(x, y)

Альтернативное имя co_selectpoint; аргументы, действие и результат совпадают.

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
# Центр первого конечного элемента заведомо принадлежит сетке.
element = co_getelement(1)
x, y = element[3], element[4]
n1 = co_getnode(int(element[0]))
n2 = co_getnode(int(element[1]))
co_clearcontour()
co_addcontour(n1[0], n1[1])
co_addcontour(n2[0], n2[1])
co_clearcontour()
co_selectline(n1[0], n1[1])

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

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

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

femm.co_showdensityАльтернативное имя co_showdensityplot; аргументы, действие и результат совпадают.

femm.co_showdensity

co_showdensity(legend=None, gscale=None, type=None, upper=None, lower=None)

Альтернативное имя co_showdensityplot; аргументы, действие и результат совпадают.

Аргументы

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

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

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

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • type = 0: |V|
  • type = 1: |\operatorname{Re} V|
  • type = 2: |\operatorname{Im} V|
  • type = 3: |J|
  • type = 4: |\operatorname{Re} J|
  • type = 5: |\operatorname{Im} J|
  • type = 6: |E|
  • type = 7: |\operatorname{Re} E|
  • type = 8: |\operatorname{Im} E|
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

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

# Уже открыто решение протекания тока.
co_showdensity(1, 0, 0, 1, 0)

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

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

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

femm.co_hidedensityАльтернативное имя co_hidedensityplot; аргументы, действие и результат совпадают.

femm.co_hidedensity

co_hidedensity()

Альтернативное имя co_hidedensityplot; аргументы, действие и результат совпадают.

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_hidedensity()

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

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

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

femm.co_showcontourАльтернативное имя co_showcontourplot; аргументы, действие и результат совпадают.

femm.co_showcontour

co_showcontour(numcontours, lower_V=None, upper_V=None, type=None)

Альтернативное имя co_showcontourplot; аргументы, действие и результат совпадают.

Аргументы

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

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

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

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • На стр.155 аргумент type напечатан после закрывающей скобки. Он возвращён в список по следующему описанию параметров.
  • numcontours = −1: использовать настройки по умолчанию; остальные аргументы игнорируются.
  • Сокращённый вызов с одним аргументом −1 использует настройки по умолчанию. Произвольное опускание остальных аргументов для другого numcontours здесь не утверждается.
  • Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.

Пример

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

# Уже открыто решение протекания тока.
co_showcontour(20)

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

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

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

femm.co_hidecontourАльтернативное имя co_hidecontourplot; аргументы, действие и результат совпадают.

femm.co_hidecontour

co_hidecontour()

Альтернативное имя co_hidecontourplot; аргументы, действие и результат совпадают.

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_hidecontour()

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

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

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

femm.co_vectorplotАльтернативное имя co_showvectorplot; аргументы, действие и результат совпадают.

femm.co_vectorplot

co_vectorplot(type, scalefactor)

Альтернативное имя co_showvectorplot; аргументы, действие и результат совпадают.

Аргументы

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

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

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

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

  • Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
  • type = 0: выключить
  • type = 1: \operatorname{Re} J
  • type = 2: \operatorname{Re} E
  • type = 3: \operatorname{Im} J
  • type = 4: \operatorname{Im} E
  • type = 5: \operatorname{Re} J и \operatorname{Im} J
  • type = 6: \operatorname{Re} E и \operatorname{Im} E

Пример

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

# Уже открыто решение протекания тока.
co_vectorplot(1, 1)

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

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

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

femm.co_smoothingАльтернативное имя co_smooth; аргументы, действие и результат совпадают.

femm.co_smoothing

co_smoothing(flag)

Альтернативное имя co_smooth; аргументы, действие и результат совпадают.

Аргументы

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

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

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

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

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

Пример

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

# Уже открыто решение протекания тока.
co_smoothing("off")

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

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

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

femm.co_getconductorpropsАльтернативное имя co_getconductorproperties; аргументы, действие и результат совпадают.

femm.co_getconductorprops

co_getconductorprops(conductor)

Альтернативное имя co_getconductorproperties; аргументы, действие и результат совпадают.

Аргументы

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

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

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

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

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

Пример

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

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

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

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

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

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

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