# pm-remez: Parks-McClellan Remez FIR design algorithm
[![Crates.io][crates-badge]][crates-url]
[](https://github.com/maia-sdr/pm-remez/actions/workflows/rust.yml)
[![Rust Docs][docs-badge]][docs-url]
[](https://github.com/maia-sdr/pm-remez/actions/workflows/maturin.yml)
[](https://pm-remez.readthedocs.io/en/latest/?badge=latest)
[](https://opensource.org/licenses/Apache-2.0)
[](https://opensource.org/licenses/MIT)
[crates-badge]: https://buildstats.info/crate/pm-remez
[crates-url]: https://crates.io/crates/pm-remez
[docs-badge]: https://docs.rs/pm-remez/badge.svg
[docs-url]: https://docs.rs/pm-remez
pm-remez is a modern Rust implementation of the Parks-McClellan Remez exchange
algorithm. It can be used as a Rust library and as a Python package via its
Python bindings.
pm-remez supports the design of FIR filters with even symmetry and odd symmetry,
and with an even number of taps and an odd number of taps, by reducing all these
cases to the even symmetry odd number of taps case. The desired frequency
response in each band, as well as the weights, can be defined as arbitrary
functions. The library can use double-precision IEEE 754 floating-point numbers
for calculations, as well as other higher precision floating-point
implementations, such as
[num-bigfloat](https://docs.rs/num-bigfloat/latest/num_bigfloat/). This can be
used to solve numerically challenging problems that are difficult to solve using
double-precision arithmetic.
The implementation draws ideas from
[a paper by S.I. Filip](https://dl.acm.org/doi/10.1145/2904902)
to make the algorithm robust against numerical errors. These ideas include the
use of Chebyshev proxy root finding to find the extrema of the weighted error
function in the Remez exchange step.
## Documentation
The documentation for the Rust crate is hosted in
[docs.rs/pm-remez](https://docs.rs/pm-remez).
The documentation for the Python package is hosted in
[pm-remez.readthedocs.io](https://pm-remez.readthedocs.io/).
The Python package documentation contains a series of examples that show how to
use pm-remez to design commonly used types of FIR filters. These illustrate the
capabilities of pm-remez and also serve as a filter design guide. The
documentation of the Rust crate contains a few examples of the Rust API. The
Python examples can also be written in Rust (and in fact this is done
[as part of integration testing](tests/filter_designs.rs)).
## Building
The pm-remez crate uses [ndarray-linalg](https://docs.rs/ndarray-linalg/) to
solve eigenvalue problems. This in turn depends on LAPACK. The pm-remez crate
has several feature flags that are used to select the LAPACK backend. Exactly
one of these features needs to be enabled to build pm-remez. The feature flags
are `openblas-static`, `openblas-system`, `netlib-static`, `netlib-system`,
`intel-mkl-static` and `intel-mkl-system`. The `-static` versions of each flag
build the LAPACK backend and link statically against it. The `-system` versions
link against a system-installed library (linking can be dynamic or static
depending on which type of library is installed). For example,
```
cargo build --release --features openblas-system
```
will build against a system-installed OpenBLAS library.
The Python package is built using [maturin](https://docs.rs/ndarray-linalg/).
It can be built with
```
maturin build --release
```
or
```
python -mbuild
```
## License
Licensed under either of
* Apache License, Version 2.0
([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license
([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.
## Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
Raw data
{
"_id": null,
"home_page": "https://maia-sdr.org/",
"name": "pm-remez",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": "Daniel Estevez <daniel@destevez.net>",
"keywords": "FIR, remez, DSP",
"author": "Daniel Estevez <daniel@destevez.net>",
"author_email": "Daniel Estevez <daniel@destevez.net>",
"download_url": "https://files.pythonhosted.org/packages/15/a3/f06b42c58e54902ec0daaea651375e96dd73344a7078e9ca9f67db75572d/pm_remez-0.1.0.tar.gz",
"platform": null,
"description": "# pm-remez: Parks-McClellan Remez FIR design algorithm\n\n[![Crates.io][crates-badge]][crates-url]\n[](https://github.com/maia-sdr/pm-remez/actions/workflows/rust.yml)\n[![Rust Docs][docs-badge]][docs-url]\n[](https://github.com/maia-sdr/pm-remez/actions/workflows/maturin.yml)\n[](https://pm-remez.readthedocs.io/en/latest/?badge=latest)\n[](https://opensource.org/licenses/Apache-2.0)\n[](https://opensource.org/licenses/MIT)\n\n[crates-badge]: https://buildstats.info/crate/pm-remez\n[crates-url]: https://crates.io/crates/pm-remez\n[docs-badge]: https://docs.rs/pm-remez/badge.svg\n[docs-url]: https://docs.rs/pm-remez\n\npm-remez is a modern Rust implementation of the Parks-McClellan Remez exchange\nalgorithm. It can be used as a Rust library and as a Python package via its\nPython bindings.\n\npm-remez supports the design of FIR filters with even symmetry and odd symmetry,\nand with an even number of taps and an odd number of taps, by reducing all these\ncases to the even symmetry odd number of taps case. The desired frequency\nresponse in each band, as well as the weights, can be defined as arbitrary\nfunctions. The library can use double-precision IEEE 754 floating-point numbers\nfor calculations, as well as other higher precision floating-point\nimplementations, such as\n[num-bigfloat](https://docs.rs/num-bigfloat/latest/num_bigfloat/). This can be\nused to solve numerically challenging problems that are difficult to solve using\ndouble-precision arithmetic.\n\nThe implementation draws ideas from\n[a paper by S.I. Filip](https://dl.acm.org/doi/10.1145/2904902)\nto make the algorithm robust against numerical errors. These ideas include the\nuse of Chebyshev proxy root finding to find the extrema of the weighted error\nfunction in the Remez exchange step.\n\n## Documentation\n\nThe documentation for the Rust crate is hosted in\n[docs.rs/pm-remez](https://docs.rs/pm-remez).\n\nThe documentation for the Python package is hosted in\n[pm-remez.readthedocs.io](https://pm-remez.readthedocs.io/).\n\nThe Python package documentation contains a series of examples that show how to\nuse pm-remez to design commonly used types of FIR filters. These illustrate the\ncapabilities of pm-remez and also serve as a filter design guide. The\ndocumentation of the Rust crate contains a few examples of the Rust API. The\nPython examples can also be written in Rust (and in fact this is done\n[as part of integration testing](tests/filter_designs.rs)).\n\n## Building\n\nThe pm-remez crate uses [ndarray-linalg](https://docs.rs/ndarray-linalg/) to\nsolve eigenvalue problems. This in turn depends on LAPACK. The pm-remez crate\nhas several feature flags that are used to select the LAPACK backend. Exactly\none of these features needs to be enabled to build pm-remez. The feature flags\nare `openblas-static`, `openblas-system`, `netlib-static`, `netlib-system`,\n`intel-mkl-static` and `intel-mkl-system`. The `-static` versions of each flag\nbuild the LAPACK backend and link statically against it. The `-system` versions\nlink against a system-installed library (linking can be dynamic or static\ndepending on which type of library is installed). For example,\n```\ncargo build --release --features openblas-system\n```\nwill build against a system-installed OpenBLAS library.\n\nThe Python package is built using [maturin](https://docs.rs/ndarray-linalg/).\nIt can be built with\n```\nmaturin build --release\n```\nor\n```\npython -mbuild\n```\n\n## License\n\nLicensed under either of\n\n * Apache License, Version 2.0\n ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)\n * MIT license\n ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)\n\nat your option.\n\n## Contribution\n\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in the work by you, as defined in the Apache-2.0 license, shall be\ndual licensed as above, without any additional terms or conditions.\n\n",
"bugtrack_url": null,
"license": "MIT OR Apache-2.0",
"summary": "Parks-McClellan Remez FIR design algorithm",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://maia-sdr.org/",
"Source Code": "https://github.com/maia-sdr/pm-remez/"
},
"split_keywords": [
"fir",
" remez",
" dsp"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3e384442358d616a1e5a69c0b308075dcf793d8d3089b4db5adadf5eb8011f56",
"md5": "3c03ce7a2bf948fa33599b5ea742c7d5",
"sha256": "3f6beacc4df3c60653ccc3b99d3fd8528c8b68bee236745b5a9ac971efd85abe"
},
"downloads": -1,
"filename": "pm_remez-0.1.0-cp38-abi3-macosx_10_12_x86_64.whl",
"has_sig": false,
"md5_digest": "3c03ce7a2bf948fa33599b5ea742c7d5",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": null,
"size": 831691,
"upload_time": "2024-04-09T16:17:53",
"upload_time_iso_8601": "2024-04-09T16:17:53.732570Z",
"url": "https://files.pythonhosted.org/packages/3e/38/4442358d616a1e5a69c0b308075dcf793d8d3089b4db5adadf5eb8011f56/pm_remez-0.1.0-cp38-abi3-macosx_10_12_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1363768d71a478ec485585f1a6bd24a8866f191837d2a2112e4c9984dc7c4e4f",
"md5": "300e3e7fac94a3b10f7a0f6db05ee18a",
"sha256": "7e07959607107ece28eca8065acdbf2c9f13e4ace542272094bfc86f4c42aec6"
},
"downloads": -1,
"filename": "pm_remez-0.1.0-cp38-abi3-macosx_11_0_arm64.whl",
"has_sig": false,
"md5_digest": "300e3e7fac94a3b10f7a0f6db05ee18a",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": null,
"size": 841928,
"upload_time": "2024-04-09T16:17:51",
"upload_time_iso_8601": "2024-04-09T16:17:51.940733Z",
"url": "https://files.pythonhosted.org/packages/13/63/768d71a478ec485585f1a6bd24a8866f191837d2a2112e4c9984dc7c4e4f/pm_remez-0.1.0-cp38-abi3-macosx_11_0_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "45bfd34fad6c406feef508dea63874d0095e8c13176bfd7634282d5ba79fb3c7",
"md5": "12565edee48188150d1f6faa05bee66d",
"sha256": "20d4f3c2ef13a4e9d7c185295283d3ff7c9aa03a49f42cf0d592dc53b0ba545b"
},
"downloads": -1,
"filename": "pm_remez-0.1.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "12565edee48188150d1f6faa05bee66d",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": null,
"size": 2637849,
"upload_time": "2024-04-09T16:17:50",
"upload_time_iso_8601": "2024-04-09T16:17:50.281857Z",
"url": "https://files.pythonhosted.org/packages/45/bf/d34fad6c406feef508dea63874d0095e8c13176bfd7634282d5ba79fb3c7/pm_remez-0.1.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ba00727b1cf33236908b5c5bec5d33dfb684585b07c997a35e30eda291b07ef2",
"md5": "e271f51bc177182c34e10c6525d55cad",
"sha256": "e85e6cb979ee1d52003a915fa4fd61954761fe68c8f24ee2543aed6b87af57f1"
},
"downloads": -1,
"filename": "pm_remez-0.1.0-cp38-abi3-win_amd64.whl",
"has_sig": false,
"md5_digest": "e271f51bc177182c34e10c6525d55cad",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": null,
"size": 16610532,
"upload_time": "2024-04-09T16:17:57",
"upload_time_iso_8601": "2024-04-09T16:17:57.407636Z",
"url": "https://files.pythonhosted.org/packages/ba/00/727b1cf33236908b5c5bec5d33dfb684585b07c997a35e30eda291b07ef2/pm_remez-0.1.0-cp38-abi3-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "15a3f06b42c58e54902ec0daaea651375e96dd73344a7078e9ca9f67db75572d",
"md5": "642802e103e533d2b78f74319d596b40",
"sha256": "10e6fa44b0d85782739ef501514ad8530d787c4587d22f2cd303195b90675946"
},
"downloads": -1,
"filename": "pm_remez-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "642802e103e533d2b78f74319d596b40",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 58528,
"upload_time": "2024-04-09T16:17:55",
"upload_time_iso_8601": "2024-04-09T16:17:55.429153Z",
"url": "https://files.pythonhosted.org/packages/15/a3/f06b42c58e54902ec0daaea651375e96dd73344a7078e9ca9f67db75572d/pm_remez-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-09 16:17:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "maia-sdr",
"github_project": "pm-remez",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pm-remez"
}
JSON
