Skip to main content

Medical Physics library

Project description

logo

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.

build pypi python license

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:

  1. 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.

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

rai sjs rah

Active contributors

uth

Past contributors

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

pymedphys-0.40.0.tar.gz (5.8 MB view details)

Uploaded Source

Built Distribution

pymedphys-0.40.0-py3-none-any.whl (6.3 MB view details)

Uploaded Python 3

File details

Details for the file pymedphys-0.40.0.tar.gz.

File metadata

  • Download URL: pymedphys-0.40.0.tar.gz
  • Upload date:
  • Size: 5.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.11.4 Windows/10

File hashes

Hashes for pymedphys-0.40.0.tar.gz
Algorithm Hash digest
SHA256 bc12976600f96e68888a1727edb954a9f57d4229757b5eb35c27132eec137eff
MD5 badc239bf8d19c2daecf03267e62f457
BLAKE2b-256 eaed4de3a02a51371e6a415819d8fc1fb09a77e74932472cb22c5926f0285aa7

See more details on using hashes here.

File details

Details for the file pymedphys-0.40.0-py3-none-any.whl.

File metadata

  • Download URL: pymedphys-0.40.0-py3-none-any.whl
  • Upload date:
  • Size: 6.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.11.4 Windows/10

File hashes

Hashes for pymedphys-0.40.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ed5e0ae970065002c60c737f49b2bcaf84d5756307da74bcc9794324135377d8
MD5 e3e6a6b245852427f9d148762f99b505
BLAKE2b-256 d3733ec52815571a9e568dda8ac735571df84c99c6af6dede3a5b70134812371

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page