Skip to main content

Medical Physics python modules.

Project description

pymedphys

A range of python modules encompased under the pymedphys package, designed to be built upon for Medical Physics applications.

Alpha stage development

These libraries are currently under alpha level development. Expect code that depends on these libraries to often break with the changes that occur within this repository.

This will be true throughout the alpha stage development of these libraries. This notice will be adjusted once this should no longer be the case.

License agreement

Copyright (C) 2018 CCA Health Care

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version (the "AGPL-3.0+").

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License and the additional terms for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.

ADDITIONAL TERMS are also included as allowed by Section 7 of the GNU Affrero General Public License. These aditional terms are Sections 1, 5, 6, 7, 8, and 9 from the Apache License, Version 2.0 (the "Apache-2.0") where all references to the definition "License" are instead defined to mean the AGPL-3.0+.

You should have received a copy of the Apache-2.0 along with this program. If not, see http://www.apache.org/licenses/LICENSE-2.0.

Cyclic dependencies and the justification of file structure

If package A depends on package B, and package B depends on package C, it is important that package C does not then depend on package A. This is called a cyclic dependency. It causes issues in dependency logic and can be avoided by purposefully designing how the packages depend on one another.

Ideally library packages are split up module by module based upon single tasks that each library achieves. By having a very large number of small single purpose modules the dependency tree can become very complicated. Complicated dependency trees do not scale. As a result the inter dependencies between library packages is tightly regulated. The modules themselves need to be designed and programmed with these restrictions in mind.

The physical design of the module dependencies is inspired by John Lakos at Bloomberg, writer of Large-Scale C++ Software Design. He describes this methodology in a talk he gave which is available on YouTube:

https://youtu.be/QjFpKJ8Xx78?t=41m7s

Level 1

Level 1 packages are the foundation library packages.

These packages SHALL NOT depend on any internal package. They MAY however depend on external packages (Level 0).

Given that these Level 1 packages are foundation packages their external packages SHOULD only ever be those that are in wide use and are highly supported within the python community. Examples of reasonable external packages to be used are numpy, scipy, and pandas.

Level 2

Level 2 packages.

The internal packages that Level 2 packages depend on SHALL only be Level 1 packages or external packages as long as those external packages don't intern depend on one defined within this group.

Level 3

Level 3 packages.

The internal packages that these depend on SHALL only be Level 1 or Level 2. They MAY also depend external packages as long as those external packages don't intern depend on one defined within this group.

Project details


Release history Release notifications | RSS feed

This version

0.1.3

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.1.3.tar.gz (3.2 kB view details)

Uploaded Source

Built Distribution

pymedphys-0.1.3-py3-none-any.whl (3.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pymedphys-0.1.3.tar.gz
  • Upload date:
  • Size: 3.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pymedphys-0.1.3.tar.gz
Algorithm Hash digest
SHA256 88284defd74f876dcab0cbea7d3e5032d06e5eae1fefccb43e07e3cad39ff2bd
MD5 bfc0eaf44a65464201a4419417bcd24f
BLAKE2b-256 2289cddc85219fd7d05c7d721f9228ff4a29cf2ada111d25a481b3544bbf7507

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymedphys-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 d6c0e140fca93844d62fb2768cb80078cde4e0fe4955f5af4e15ad435136de74
MD5 c51fa9e23a33b2b8a48c1cc7f39d4a83
BLAKE2b-256 e63938d0861de906ad927678dde242854a4c95fdc179ff69e2a6450123c34742

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