Модули и функции · встроенный MicroPython FEMM 5
femm · Решение токопроводимости
Команды FEMM обеспечивают подготовку документов, построение геометрии, назначение свойств, создание сетки и решение задачи. Обработка результатов включает вычисление интегралов и пакетное чтение полевых величин во всех четырёх физических модулях.
Условия работы
- Во встроенном сценарии команды вызываются непосредственно: newdocument(0), mi_drawrectangle(...), mi_loadsolution(), mo_getpointvalues(...). Доступен также import femm с обращением femm.mi_drawrectangle(...).
- Создание/открытие входного документа регистрирует его семейство команд mi_/ei_/hi_/ci_; загрузка решения регистрирует mo_/eo_/ho_/co_. До открытия соответствующего документа список доступных имён неполон.
- Координаты редактора и запросов точки используют единицы длины документа; интегралы и физические поля используют указанные для каждой величины единицы СИ. Исключения, например МСм/м в магнитном материале, отмечены в аргументах.
- Примеры геометрии создают отдельный образец 20 × 10 мм. Примеры постпроцессора рассчитаны на уже открытое решение и выбирают центр первого конечного элемента вместо произвольной точки.
- Запуск сценария, который изменяет геометрию, выделение, файлы или окна, является отдельным действием пользователя. Такие карточки помечены как контекстные; автоматическая проверка примеров выполняется только для явно отмеченных независимых запросов.
femm.co_lineintegralfemm.co_blockintegralfemm.co_getpointvaluesfemm.co_makeplotfemm.co_getprobleminfofemm.co_getconductorpropertiesfemm.co_seteditmodefemm.co_selectblockfemm.co_groupselectblockfemm.co_selectconductorfemm.co_addcontourfemm.co_bendcontourfemm.co_selectpointfemm.co_clearcontourfemm.co_clearblockfemm.co_zoomnaturalfemm.co_zoominfemm.co_zoomoutfemm.co_zoomfemm.co_showmeshfemm.co_hidemeshfemm.co_showpointsfemm.co_hidepointsfemm.co_smoothfemm.co_showgridfemm.co_hidegridfemm.co_gridsnapfemm.co_setgridfemm.co_hidedensityplotfemm.co_showdensityplotfemm.co_hidecontourplotfemm.co_showcontourplotfemm.co_showvectorplotfemm.co_minimizefemm.co_maximizefemm.co_restorefemm.co_resizefemm.co_closefemm.co_refreshviewfemm.co_reloadfemm.co_setfocusfemm.co_savebitmapfemm.co_savemetafilefemm.co_shownamesfemm.co_numnodesfemm.co_numelementsfemm.co_getnodefemm.co_getelementfemm.co_getallnodesfemm.co_getallelementsfemm.co_getalljfemm.co_getallvfemm.co_gettitlefemm.co_selectlinefemm.co_showdensityfemm.co_hidedensityfemm.co_showcontourfemm.co_hidecontourfemm.co_vectorplotfemm.co_smoothingfemm.co_getconductorpropsfemm.co_lineintegralВычисляет выбранный линейный интеграл по текущему ориентированному контуру.
femm.co_lineintegral
co_lineintegral(type)Вычисляет выбранный линейный интеграл по текущему ориентированному контуру.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
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.
Пример
"Пример 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)Вычисляет выбранный интеграл по отмеченным областям; код операции зависит от физического модуля.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
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
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Возвращает упорядоченный набор локальных величин в заданной точке решения.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
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 отдельно не верифицированы.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
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.
Пример
"Пример 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): длина единицы геометрии, м
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.co_getprobleminfo.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает тип постановки, единицы и другие параметры загруженного решения.\nРезультат: tuple параметров решения; позиции и единицы перечислены ниже. Глубина и коэффициент перевода геометрии возвращаются в метрах."
# Уже открыто решение протекания тока.
print(co_getprobleminfo())
Ожидаемый результат. Возвращает тип постановки, единицы и другие параметры загруженного решения.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_getconductorpropertiesВозвращает потенциал и суммарную ответную величину именованного проводника.
femm.co_getconductorproperties
co_getconductorproperties(conductor)Возвращает потенциал и суммарную ответную величину именованного проводника.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
conductor | Имя проводника. |
Возвращаемое значение
tuple из двух величин: (потенциал, суммарный заряд/ток) либо (температура, суммарная тепловая мощность). Порядок и единицы указаны ниже; неизвестное имя вызывает RuntimeError.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Позиция результата 0 (индексация Python): потенциал, В
- Позиция результата 1 (индексация Python): суммарный ток, А
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Выбирает класс объектов для следующих операций редактирования или чтения решения.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
mode | Режим чтения решения: point, contour или area. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.co_seteditmode.\nСреда: встроенный MicroPython FEMM 5.\nВыбирает класс объектов для следующих операций редактирования или чтения решения.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение протекания тока.
co_seteditmode("area")
Ожидаемый результат. Выбирает класс объектов для следующих операций редактирования или чтения решения.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_selectblockВыбирает область решения, содержащую заданную точку.
femm.co_selectblock
co_selectblock(x, y)Выбирает область решения, содержащую заданную точку.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
x | Первая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа. |
y | Вторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Повторный выбор того же объекта переключает его выделение. Для воспроизводимой выборки сначала снимайте выделение командой clearselected/clearblock соответствующего семейства.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Выбирает области решения по номеру группы.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
n | Номер группы областей; без аргумента выбираются все области. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Вызов без n выбирает все области, хотя аргумент в основной записи PDF не помечен как необязательный.
- Повторный выбор того же объекта переключает его выделение. Для воспроизводимой выборки сначала снимайте выделение командой clearselected/clearblock соответствующего семейства.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Выбирает объекты, относящиеся к указанному проводнику.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
name | Имя выбираемого объекта, модуля или передаваемой переменной. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Добавляет точку в конец текущего контура интегрирования.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
x | Первая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа. |
y | Вторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Заменяет последний прямой участок контура дугой с указанным углом и шагом.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
angle | Угол в градусах; смысл задаётся операцией дуги, поворота или чтения зазора. |
anglestep | Угловой шаг разбиения дуги контура, градусы. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Допустимый angle: от -180^\circ до +180^\circ; anglestep > 0. Если контур содержит менее двух точек, команда не изменяет его.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Добавляет к контуру ближайший узел исходной геометрии.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
x | Первая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа. |
y | Вторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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() либо открытием сохранённого результата.
Пример
"Пример femm.co_zoomnatural.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает всю геометрию в доступном окне.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_zoomnatural()
Ожидаемый результат. Показывает всю геометрию в доступном окне.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_zoominУвеличивает масштаб вида.
femm.co_zoomin
co_zoomin()Увеличивает масштаб вида.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.co_zoomin.\nСреда: встроенный MicroPython FEMM 5.\nУвеличивает масштаб вида.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_zoomin()
Ожидаемый результат. Увеличивает масштаб вида.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_zoomoutУменьшает масштаб вида.
femm.co_zoomout
co_zoomout()Уменьшает масштаб вида.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример 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)Показывает прямоугольную область между заданными углами.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
x1 | Первая координата начальной точки или первого угла; единицы геометрии. |
y1 | Вторая координата начальной точки или первого угла; единицы геометрии. |
x2 | Первая координата конечной точки или второго угла; единицы геометрии. |
y2 | Вторая координата конечной точки или второго угла; единицы геометрии. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример 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() либо открытием сохранённого результата.
Пример
"Пример femm.co_showmesh.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает рёбра конечной сетки.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_showmesh()
Ожидаемый результат. Показывает рёбра конечной сетки.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_hidemeshСкрывает рёбра конечной сетки.
femm.co_hidemesh
co_hidemesh()Скрывает рёбра конечной сетки.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.co_hidemesh.\nСреда: встроенный MicroPython FEMM 5.\nСкрывает рёбра конечной сетки.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_hidemesh()
Ожидаемый результат. Скрывает рёбра конечной сетки.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_showpointsПоказывает узлы исходной геометрии.
femm.co_showpoints
co_showpoints()Показывает узлы исходной геометрии.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.co_showpoints.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает узлы исходной геометрии.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_showpoints()
Ожидаемый результат. Показывает узлы исходной геометрии.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_hidepointsСкрывает узлы исходной геометрии.
femm.co_hidepoints
co_hidepoints()Скрывает узлы исходной геометрии.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.co_hidepoints.\nСреда: встроенный MicroPython FEMM 5.\nСкрывает узлы исходной геометрии.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_hidepoints()
Ожидаемый результат. Скрывает узлы исходной геометрии.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_smoothВключает или отключает сглаживание производных поля в постпроцессоре.
femm.co_smooth
co_smooth(flag)Включает или отключает сглаживание производных поля в постпроцессоре.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
flag | Строка on включает, off отключает этот режим. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример 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() либо открытием сохранённого результата.
Пример
"Пример femm.co_showgrid.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает координатную сетку вида.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_showgrid()
Ожидаемый результат. Показывает координатную сетку вида.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_hidegridСкрывает координатную сетку вида.
femm.co_hidegrid
co_hidegrid()Скрывает координатную сетку вида.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.co_hidegrid.\nСреда: встроенный MicroPython FEMM 5.\nСкрывает координатную сетку вида.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_hidegrid()
Ожидаемый результат. Скрывает координатную сетку вида.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_gridsnapВключает или отключает привязку координат к сетке вида.
femm.co_gridsnap
co_gridsnap(flag)Включает или отключает привязку координат к сетке вида.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
flag | Строка on включает, off отключает этот режим. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Задаёт шаг и декартов либо полярный тип координатной сетки.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
density | Расстояние между точками координатной сетки; единицы геометрии. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
type | Система координат сетки вида: cart или polar. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Оба аргумента можно опустить; второй аргумент, если передан, должен быть строкой "cart" или "polar". Числовой код вместо строки вызывает TypeError.
Пример
"Пример 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() либо открытием сохранённого результата.
Пример
"Пример 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)Показывает цветовую карту выбранной величины с заданными пределами и легендой.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
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|
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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() либо открытием сохранённого результата.
Пример
"Пример 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)Показывает заданное число изолиний потенциала в выбранном диапазоне.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
numcontours | Число изолиний в заданном диапазоне. |
lower_V | Нижний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
upper_V | Верхний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
type | Компонента комплексного потенциала для изолиний гармонического решения. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- На стр.155 аргумент type напечатан после закрывающей скобки. Он возвращён в список по следующему описанию параметров.
- numcontours = −1: использовать настройки по умолчанию; остальные аргументы игнорируются.
- Сокращённый вызов с одним аргументом −1 использует настройки по умолчанию. Произвольное опускание остальных аргументов для другого numcontours здесь не утверждается.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.co_showcontourplot.\nСреда: встроенный MicroPython FEMM 5.\nПоказывает заданное число изолиний потенциала в выбранном диапазоне.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_showcontourplot(20)
Ожидаемый результат. Показывает заданное число изолиний потенциала в выбранном диапазоне.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_showvectorplotПоказывает стрелки выбранного векторного поля с заданным масштабом.
femm.co_showvectorplot
co_showvectorplot(type, scalefactor)Показывает стрелки выбранного векторного поля с заданным масштабом.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
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
Пример
"Пример 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() либо открытием сохранённого результата.
Пример
"Пример femm.co_minimize.\nСреда: встроенный MicroPython FEMM 5.\nСворачивает окно документа.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_minimize()
Ожидаемый результат. Сворачивает окно документа.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_maximizeРазворачивает окно документа.
femm.co_maximize
co_maximize()Разворачивает окно документа.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.co_maximize.\nСреда: встроенный MicroPython FEMM 5.\nРазворачивает окно документа.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_maximize()
Ожидаемый результат. Разворачивает окно документа.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_restoreВозвращает обычный размер окна документа.
femm.co_restore
co_restore()Возвращает обычный размер окна документа.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.co_restore.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает обычный размер окна документа.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_restore()
Ожидаемый результат. Возвращает обычный размер окна документа.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_resizeУстанавливает размер окна в пикселях.
femm.co_resize
co_resize(width, height)Устанавливает размер окна в пикселях.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
width | Ширина окна в пикселях. |
height | Высота окна в пикселях. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример 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() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.co_close.\nСреда: встроенный MicroPython FEMM 5.\nЗакрывает активный документ этого семейства.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение протекания тока.
co_close()
Ожидаемый результат. Закрывает активный документ этого семейства.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_refreshviewПерерисовывает активное окно.
femm.co_refreshview
co_refreshview()Перерисовывает активное окно.
Аргументы
Аргументы не требуются.
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример femm.co_refreshview.\nСреда: встроенный MicroPython FEMM 5.\nПерерисовывает активное окно.\nРезультат: str: ответ команды окна; при обычном изменении вида пустая строка \"\". Основной результат — изменение отображения постпроцессора."
# Уже открыто решение протекания тока.
co_refreshview()
Ожидаемый результат. Перерисовывает активное окно.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_reloadПовторно загружает файл решения с диска.
femm.co_reload
co_reload()Повторно загружает файл решения с диска.
Аргументы
Аргументы не требуются.
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.co_reload.\nСреда: встроенный MicroPython FEMM 5.\nПовторно загружает файл решения с диска.\nРезультат: None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами."
# Уже открыто решение протекания тока.
co_reload()
Ожидаемый результат. Повторно загружает файл решения с диска.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
femm.co_setfocusВыбирает документ, к которому будут относиться следующие команды данного семейства.
femm.co_setfocus
co_setfocus(documentname=None)Выбирает документ, к которому будут относиться следующие команды данного семейства.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
documentname | Имя документа для выбора активного окна. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Сохраняет изображение текущего вида в растровый файл; численные данные результата сохраняются отдельно.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
filename | Путь к читаемому или записываемому файлу. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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 соответствующего модуля.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
filename | Путь к читаемому или записываемому файлу. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Включает или отключает показ имён меток областей.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
flag | 0 отключает отображение, 1 включает. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример 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() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Возвращает координаты узла сетки по индексу, начинающемуся с единицы.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
n | Индекс узла сетки, начиная с 1. |
Возвращаемое значение
tuple из двух float: (x, y) или (r, z), в единицах геометрии. None при индексе вне сетки.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Возврат: координаты x,y либо r,z в единицах геометрии. Индекс n начинается с 1; индекс массива Python начинается с 0.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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)Возвращает три индекса узлов, центр, площадь и группу одного треугольника.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
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): номер группы области
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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 — число элементов; эти размеры обычно различаются.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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 команда не принимает.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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, А/м²; без сглаживания и поиска точки.
- В магнитной и токовой гармонических задачах величины с фазой могут быть комплексными; не отбрасывайте мнимую часть при сохранении.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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, В.
- В магнитной и токовой гармонических задачах величины с фазой могут быть комплексными; не отбрасывайте мнимую часть при сохранении.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
x | Первая координата: x в плоской модели или r в осесимметричной; единицы геометрии документа. |
y | Вторая координата: y в плоской модели или z в осесимметричной; единицы геометрии документа. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
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|
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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() либо открытием сохранённого результата.
Пример
"Пример 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; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
numcontours | Число изолиний в заданном диапазоне. |
lower_V | Нижний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
upper_V | Верхний уровень электрического потенциала либо температуры. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
type | Компонента комплексного потенциала для изолиний гармонического решения. Необязательный завершающий аргумент; пропуск сохраняет предусмотренное командой значение по умолчанию. |
Возвращаемое значение
str: ответ команды окна; при обычном изменении вида пустая строка "". Основной результат — изменение отображения постпроцессора.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- На стр.155 аргумент type напечатан после закрывающей скобки. Он возвращён в список по следующему описанию параметров.
- numcontours = −1: использовать настройки по умолчанию; остальные аргументы игнорируются.
- Сокращённый вызов с одним аргументом −1 использует настройки по умолчанию. Произвольное опускание остальных аргументов для другого numcontours здесь не утверждается.
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример 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() либо открытием сохранённого результата.
Пример
"Пример 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; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
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
Пример
"Пример 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; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
flag | Строка on включает, off отключает этот режим. |
Возвращаемое значение
None. Результат команды — изменение документа, выделения, файла или отображения; числовые результаты читаются отдельными запросами.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
Пример
"Пример 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; аргументы, действие и результат совпадают.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
conductor | Имя проводника. |
Возвращаемое значение
tuple из двух величин: (потенциал, суммарный заряд/ток) либо (температура, суммарная тепловая мощность). Порядок и единицы указаны ниже; неизвестное имя вызывает RuntimeError.
Особенности вызова
- Предусловие: загружено решение протекания тока командой ci_loadsolution() либо открытием сохранённого результата.
- Позиция результата 0 (индексация Python): потенциал, В
- Позиция результата 1 (индексация Python): суммарный ток, А
- Аргументы нативной команды передаются позиционно; именованные аргументы не принимаются.
Пример
"Пример femm.co_getconductorprops.\nСреда: встроенный MicroPython FEMM 5.\nАльтернативное имя co_getconductorproperties; аргументы, действие и результат совпадают.\nРезультат: tuple из двух величин: (потенциал, суммарный заряд/ток) либо (температура, суммарная тепловая мощность). Порядок и единицы указаны ниже; неизвестное имя вызывает RuntimeError."
# Уже открыто решение протекания тока.
# В модели определено точное имя 'Terminal'.
value = co_getconductorprops("Terminal")
print(value)
Ожидаемый результат. Возвращает потенциал и суммарную ответную величину именованного проводника.
Скачать пример · Ссылка на функцию · Подробности команды FEMM
Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.
Имена в установленной сборке
Перечень получен во встроенном интерпретаторе. Он включает функции, классы и константы. Ссылки ведут к контрактам; для прямого доступа ulab учитывайте условия этого раздела.
co_lineintegralco_blockintegralco_getpointvaluesco_makeplotco_getprobleminfoco_getconductorpropertiesco_seteditmodeco_selectblockco_groupselectblockco_selectconductorco_addcontourco_bendcontourco_selectpointco_clearcontourco_clearblockco_zoomnaturalco_zoominco_zoomoutco_zoomco_showmeshco_hidemeshco_showpointsco_hidepointsco_smoothco_showgridco_hidegridco_gridsnapco_setgridco_hidedensityplotco_showdensityplotco_hidecontourplotco_showcontourplotco_showvectorplotco_minimizeco_maximizeco_restoreco_resizeco_closeco_refreshviewco_reloadco_setfocusco_savebitmapco_savemetafileco_shownamesco_numnodesco_numelementsco_getnodeco_getelementco_getallnodesco_getallelementsco_getalljco_getallvco_gettitleco_selectlineco_showdensityco_hidedensityco_showcontourco_hidecontourco_vectorplotco_smoothingco_getconductorprops