Skip to main content

PPOPS

Performance Prediction for Optical Particle Spectrometer

codecov CI

Documentation: https://rtd-ppops.readthedocs.io/

Overview

This repository simulates the performance of a simple Optical Particle Spectrometer (OPS) using a physics-based model. The default optical system is based on Gao et al., Aerosol Sci. Technol., 2016, which is also what the POPS instrument sold by Handix Scientific is based on. The PPOPS model is semi-validated in that PPOPS modeled signal was within 50% of the actual signal of a POPS unit from Handix Scientific (see validation section of PPOPS website for more information).

The PPOPS model calculates the amount and direction of scattered light by aerosols according to Mie theory. The scattered light is integrated over the solid-angle acceptance of the collection mirror to calculate a truncated scattering cross section (the effective scattering cross section). This truncated scattering cross section is then used to calculate the instrument signal and noise current.

To summarize, the PPOPS workflow includes,

  1. Use miepython to calculate the scattering amplitudes (S₁, S₂) according to Mie theory.
    1. Compute Mie coefficients (a_n, b_n) for electric and magnetic scattering modes.
    2. Generate angular functions (π_n, τ_n) that describe angle-dependent intensity.
  2. Integrating over the OPS collection mirror’s polar and azimuthal acceptance to compute the truncated scattering cross section.
  3. Convert the truncated scattering cross section to signal and noise current based on detector specifications.
  4. Optionally, convert signal current to digitizer bins for direct comparison with POPS data.

Assumptions

This package makes several assumptions:

  1. Particles are perfectly spherical.
  2. Scattering is elastic.
  3. All scattered light incident on the collection mirror is detected.
  4. The only noise sources are signal noise, dark noise, and preamp noise (i.e., we neglect stray scattering).
  5. The detector is shot noise limited.

Installation

PPOPS is available via PyPI

pip install ppops

Usage

See PPOPS website for more information.

import ppops

ops = ppops.OpticalParticleSpectrometer()

ops.estimate_signal_noise(diameters = [0.1, 0.5, 1.0], ior = 1.5+0.001j)

References

Gao, R.S., Telg, H., McLaughlin, R.J., Ciciora, S.J., Watts, L.A., Richardson, M.S., Schwarz, J.P., Perring, A.E., Thornberry, T.D., Rollins, A.W., Markovic, M.Z., Bates, T.S., Johnson, J.E., Fahey, D.W., 2016. A light-weight, high-sensitivity particle spectrometer for PM2.5 aerosol measurements. Aerosol Science and Technology 50, 88–99. https://doi.org/10.1080/02786826.2015.1131809

miepython: 10.5281/zenodo.7949263

Author Notes

This repository is intended as a transparent, well-documented implementation of Mie scattering and optical geometry for POPS performance prediction and analysis.

License

PPOPS is released under the MIT license.

Metadata

Release files for ppops 0.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ppops 0.0.0
File Size Uploaded
ppops-0.0.0.tar.gz 18.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ppops 0.0.0
File Interpreter ABI Platform
ppops-0.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 32.8 kB

Release files / ppops-0.0.0.tar.gz

Download URL ppops-0.0.0.tar.gz
Size 18.9 kB
Tags Source
SHA-256 checksum
How to use checksums
b59d3a4f910f49b69f6f89036a6f7b33dff628694a9b74e411a71ffe07c1c134
BLAKE2b-256 checksum
How to use checksums
91e4d2c9bfd282749a0bf06ba39235f4f4e2395e4054741913a56775229b6ced
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 4, 2026.

Transparency log

Release files / ppops-0.0.0-py3-none-any.whl

Download URL ppops-0.0.0-py3-none-any.whl
Size 13.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
52f336d542e34a60bc2f9f6b62f5e1741485a021e6e7f192c08cfb0845a2efce
BLAKE2b-256 checksum
How to use checksums
c1b137dae718eef8a8ed4066fa2fa64c314eed0c9d6550b411d6b94d384f288e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 4, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.0.0 This release

2 release 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