Air-Gap Force FFT

Python postprocessor for motor air-gap flux-density results. It reads Br and Btheta, calculates Maxwell stress, evaluates integrated force and torque, and extracts time-space harmonic modes with 2-D FFT.

The included sample is the healthy-position result for the GL80 PMSM.

The project is open source under the MIT License.

Repository Layout

.
|-- src/                         # Processing scripts and reusable modules
|   |-- airgap_force_fft.py       # CLI entry point
|   |-- airgap_io.py              # JSON/CSV readers and sector expansion
|   |-- airgap_fft.py             # Maxwell stress, FFT, torque comparison
|   `-- airgap_plotting.py        # Plotting utilities
|-- tests/                       # Unit tests
|-- data/
|   `-- GL80/healthy_position/   # Public sample input and generated outputs
|-- docs/                        # Discussion notes and analysis reports
|-- config.yaml                  # Default GL80 example configuration
|-- pyproject.toml               # Packaging metadata
`-- requirements.txt             # Runtime dependencies

Quick Start

Install the published package from PyPI:

python -m pip install airgap-force-fft

For development, create an environment and install the repository dependencies:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

Run the default GL80 example:

python .\src\airgap_force_fft.py --config .\config.yaml

The main outputs are written under data/GL80/healthy_position/fft_output by default.

Input Formats

Supported air-gap flux-density inputs:

  • EMSolution/pyemsol gapB JSON
  • Long-form CSV with columns such as time, theta_deg, Br, and Btheta

For EMSolution JSON, geometry and symmetry metadata can be read from the file when available. For CSV input, set the missing metadata explicitly in config.yaml, especially:

  • input.sector.periods
  • input.sector.symmetricity
  • geometry.radius_m
  • geometry.stack_length_m

For full 360-degree CSV data, use input.sector.periods: 1 and input.sector.symmetricity: 0.

Torque Reference Files

Torque comparison supports two reference formats:

  • The earlier transient_results.json style with Time.data and Torque.*.data
  • pyemsol output_transient.json, where torque is read from postData.forceNodal.forceNodalData entries whose propertyNum is stator or rotor, using forceMZ

The comparison plot uses rotor-positive convention: -Ftheta integrated, -stator, and rotor.

Reports

Key analysis reports are in docs/:

Tests

Run the unit tests with:

python -m unittest discover -s tests -v

Packaging

For editable development installation:

pip install -e .

After installation, the CLI can also be invoked as:

airgap-force-fft --config config.yaml

Project links

Data verified by PyPI on Sep 11, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for kaimorih from gravatar.com kaimorih

Credits

Author: Science Solutions International Laboratory, Inc.

GitHub Statistics

Data verified by PyPI on Sep 11, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Tags

air-gap FFT Maxwell-stress motor EMSolution

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

airgap_force_fft-0.1.0.tar.gz (17.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

airgap_force_fft-0.1.0-py3-none-any.whl (17.3 kB view details)

Uploaded Python 3

File details

Details for the file airgap_force_fft-0.1.0.tar.gz.

File metadata

  • Download URL: airgap_force_fft-0.1.0.tar.gz
  • Upload date:
  • Size: 17.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for airgap_force_fft-0.1.0.tar.gz
Algorithm Hash digest
SHA256 e01216e538104bf49423e669c8044b7c2cdec835e748d88277a84813286b0fae
MD5 9b689fbeea1b35e1e73c754b5603cbbc
BLAKE2b-256 a64994db2a2beea4a8136d030430cb9b80c56e4af17556f212a4cf3d5adca4fd

See more details on using hashes here.

Provenance

The following attestation bundles were made for airgap_force_fft-0.1.0.tar.gz:

Publisher: publish.yml on EMSolution-SSIL/airgap_force_fft

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file airgap_force_fft-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for airgap_force_fft-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3c57e9588287d001f6c0595f83dda2415264116d2d2b528eef24f082c60c9f76
MD5 43a6295882e0921990fa7818153af38b
BLAKE2b-256 046ada233a8ef01da9ec310600f6bb72eb1b4a383cd16f778c58fb2e637f9655

See more details on using hashes here.

Provenance

The following attestation bundles were made for airgap_force_fft-0.1.0-py3-none-any.whl:

Publisher: publish.yml on EMSolution-SSIL/airgap_force_fft

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page