A community effort to develop an open standard library for Medical Physics in Python. We build high quality, transparent software together via peer review and open source distribution. Open code is better science.
What is PyMedPhys?
PyMedPhys is an open-source Medical Physics python library built by an open community that values and prioritises code sharing, review, improvement, and learning from each other. It is inspired by the collaborative work of our physics peers in astronomy and the Astropy Project. PyMedPhys is available on PyPI and GitHub.
PyMedPhys first paper in the Journal of Open Source Software contains more background information, including a statement of need. You can access the paper here. When referencing PyMedPhys, please cite this paper as follows:
Biggs, S., Jennings, M., Swerdloff, S., Chlap, P., Lane, D., Rembish, J., McAloney, J., King, P., Ayala, R., Guan, F., Lambri, N., Crewson, C., Sobolewski, M. (2022). PyMedPhys: A community effort to develop an open, Python-based standard library for medical physics applications. Journal of Open Source Software, 7(78), 4555, https://doi.org/10.21105/joss.04555
Beta level of development
PyMedPhys is currently within the beta stage of its life-cycle. It will stay in this stage until the version number leaves 0.x.x and enters 1.x.x. While PyMedPhys is in beta stage, no API is guaranteed to be stable from one release to the next. In fact, it is very likely that the entire API will change multiple times before a 1.0.0 release. In practice, this means that upgrading pymedphys to a new version will possibly break any code that was using the old version of pymedphys. We try to be abreast of this by providing details of any breaking changes from one release to the next within the Release Notes.
Community
PyMedPhys has a Discourse community to both help you find your feet using PyMedPhys and to facilitate collaboration and general discussion. Please reach out over there and we’d love to get to know you!
Documentation
PyMedPhys can be installed with:
pip install pymedphys[user]
Further user installation instructions can be found in the Quick Start Guide.
The PyMedPhys documentation contains two overarching guides:
The Users Guide: where you can find instructions to get started with the library and the CLI, in-depth how-to guides (examples for users) on PyMedPhys’ various tools, some background information on individual PyMedPhys projects as well as the Technical Reference.
The Contributors Guide: for those who wish to make new contributions to the PyMedPhys library, CLI or app. Here you’ll find detailed workstation setup guides to enable contributions, important repository information, and some tips & tricks to overcome common issues.
Development
The PyMedPhys project is managed using Poetry.
After cloning the repository, install the PyMedPhys dependencies and set up pre-commit by running:
poetry install -E all
poetry run pre-commit install
Run automated tests with:
poetry run pymedphys dev tests
Our Team
PyMedPhys is what it is today due to its maintainers and contributors, both past and present. Here is our team.
Maintainers
- Stuart Swerdloff
ELEKTA Pty Ltd: New Zealand
- Matthew Jennings
Royal Adelaide Hospital, Australia
- Phillip Chlap
Radformation Inc., USA
University of New South Wales, Australia
Active contributors
- Derek Lane
ELEKTA AB, Houston TX
- Marcelo Jordao
ELEKTA AB, Hong Kong SAR
- Marcus Fisk
Cancer Care Riverina, Australia
Past contributors
Metadata
Release files for pymedphys 0.41.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pymedphys-0.41.0.tar.gz | 7.0 MB | Without provenance | Details for pymedphys-0.41.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pymedphys-0.41.0-py3-none-any.whl | Python 3 | none | any | Details for pymedphys-0.41.0-py3-none-any.whl |
Total release size: 14.5 MB
Release files / pymedphys-0.41.0.tar.gz
| Download URL | pymedphys-0.41.0.tar.gz |
|---|---|
| Size | 7.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0d17a0ae42a2c8a16b9970ba652176866f5655cc3c785d57d416cfeb8961ed63
|
|
BLAKE2b-256 checksum How to use checksums |
bcf059af199c9f966dd69f59cff77a802c0457f57aed39ebf93f6a99664f0448
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.3 CPython/3.11.4 Windows/10
|
Release files / pymedphys-0.41.0-py3-none-any.whl
| Download URL | pymedphys-0.41.0-py3-none-any.whl |
|---|---|
| Size | 7.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9fd7ff9f60c8875ff207e2bf59e78bec4739008ed17a2c5f31ffeaf51e945463
|
|
BLAKE2b-256 checksum How to use checksums |
ce378681eec106cebc8cae3964fa647637ed3a29f427d03e7aa2db61a8248518
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.3 CPython/3.11.4 Windows/10
|
Security for pymedphys 0.41.0
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.