Skip to main content

shoulder

PyPI Latest Release Code style: black

This package uses a collection of machine learning models to detect anatomic landmarks on 3d models of shoulder bones and also generates patient specific coordinate systems. An stl of the shoulder bone of interest is all that is needed to get started. Currently only implemented for the humerus, with expansion to the scapula in the future. Landmarks that shoulder can currently identify on the humerus are:

  • canal
  • transepicondylar axis
  • bicipital groove
  • anatomic neck

Installation

pip install shoulder

Example

Start by using the example bone stl's located in "tests/test_bones"

# pass stl into Humerus
hum = shoulder.Humerus("tests/test_bones/humerus_left.stl")

# apply coordinate sysytem
hum.apply_csys_canal_transepiconylar()

# calculate landmarks
hum.canal.axis()
hum.trans_epiconylar.axis()
hum.anatomic_neck.points()
hum.bicipital_groove.axis()

# calculate metrics
hum.radius_curvature()
hum.neckshaft()
hum.retroversion()

# construct plot from above humeral bone with landmarks and coordinate system
plot = shoulder.Plot(hum)
plot.figure.show()

The output of the plot will appear as shown below with landmarks included and transformed from the original CT coordinate system to a coordainte system defined by the canal and transepicondylar axis.

Plot of Example code above

Contributing

Clone the repo, open the cloned folder containing the poetry.lock file, then install the development dependencies using poetry.

poetry install --with dev

Metadata

Release files for shoulder 1.5.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 shoulder 1.5.0
File Size Uploaded
shoulder-1.5.0.tar.gz 38.8 MB Details

Built distribution (wheel)

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

Total release size: 77.7 MB

Release files / shoulder-1.5.0.tar.gz

Download URL shoulder-1.5.0.tar.gz
Size 38.8 MB
Tags Source
SHA-256 checksum
How to use checksums
297cdd54c7a2302823341e5fdc43357b6ca3ce7866729b5042de10abe5a3be38
BLAKE2b-256 checksum
How to use checksums
2c80fe80cbe84c49eaa0e5e248e3eacedbc07188e63e48448d0b3a60d9d78cd8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.0.1 CPython/3.12.7 Linux/6.11.0-21-generic

Release files / shoulder-1.5.0-py3-none-any.whl

Download URL shoulder-1.5.0-py3-none-any.whl
Size 38.9 MB
Tags Python 3
SHA-256 checksum
How to use checksums
8c744fdbee410c8dfd2cc34a6232dce6af4935fdf811b021b8b6e17db38a876c
BLAKE2b-256 checksum
How to use checksums
b86d8de336186c19416b8ca5f70af4ebc8d236bd5ff834a9fdccfb7ac92eafa4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.0.1 CPython/3.12.7 Linux/6.11.0-21-generic

Release history Release notifications | RSS feed

This release

1.5.0 This release

2 release files

1.4.0

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.8

2 release files

1.2.7

2 release files

1.2.6

2 release files

1.2.5

2 release files

1.2.4

2 release files

1.2.3

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2

2 release files

1.1.0

3 release files

1.0.8

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

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