Skip to main content

UKRIN Kidney Analysis Toolbox

Project description

UKRIN Kidney Analysis Toolbox (ukat)

Build and Test codecov PyPI version Downloads License: GPL v3 DOI

ukat is a vendor agnostic framework for the analysis of quantitative renal MRI data.

The UKRIN-MAPS project aims to standardise the acquisition and analysis of renal MRI data to enable multi-site, multi-vendor studies. Although many MRI vendors produce quantitative maps on the scanner, their methods are closed source and as such, potentially cause variability in multi-vendor studies. ukat provides an open-source and robust analysis platform that can be used to process data from multiple vendors.

The focus of this package is analysis of data from the standardised UKRIN protocol, however the methods are intentionally left generic to enable analysis of data collected using different protocols or on different areas of the body.

More information can be found in this ISMRM abstract.

Installing ukat

There are a few different ways you can install ukat based on what you want to do with it

"I just want to process my data with this package"

  1. Make sure you're running Python >=3.8
  2. Install ukat with pip install ukat

"I want to modify this code to do something a bit different but don't want my modifications to go back into ukat"

  1. Clone this repository with git clone https://github.com/UKRIN-MAPS/ukat.git
  2. Change to the ukat root directory (the one containing a file named setup.py).
  3. Run the following command in your terminal: pip install -e .

Now if you make any changes to the ukat code, they'll permeate into any analysis you perform where you've imported ukat.

"I want to contribute to ukat and write code that ends up back on this repository for others to use"

Great!

Fork the repository to your GitHub account. Then, clone the repository to your local machine. After doing this, you should see:

$ git remote -v
origin   https://github.com/<YOUR-GITHUB-USERNAME>/ukat.git (fetch)
origin   https://github.com/<YOUR-GITHUB-USERNAME>/ukat.git (push)

Now, configure git to sync your fork with the original ukat repository:

$ git remote add upstream https://github.com/UKRIN-MAPS/ukat.git

Now the upstream repository should be set:

$ git remote -v
origin     https://github.com/<YOUR-GITHUB-USERNAME>/ukat.git (fetch)
origin     https://github.com/<YOUR-GITHUB-USERNAME>/ukat.git (push)
upstream   https://github.com/UKRIN-MAPS/ukat.git (fetch)
upstream   https://github.com/UKRIN-MAPS/ukat.git (push)

Now you can suggest changes (e.g. suggest new code) to be added to the repository via pull requests. Don't forget to keep your fork in sync with the upstream repository (i.e. the ukat repository in the UKRIN-MAPS organisation).

If you are new to git/GitHub you may find the following cheat sheets handy (web, pdf).

You'll probably also want to follow the instructions in the section above so you can use ukat for your normal analysis.

If you run into any problems or find any issues with the installation process please raise an issue.

Contributing guidelines

Please read our contributing guidelines (work-in-progress).

Project details


Download files

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

Source Distribution

ukat-0.7.3.tar.gz (88.8 kB view details)

Uploaded Source

Built Distribution

ukat-0.7.3-py3-none-any.whl (108.5 kB view details)

Uploaded Python 3

File details

Details for the file ukat-0.7.3.tar.gz.

File metadata

  • Download URL: ukat-0.7.3.tar.gz
  • Upload date:
  • Size: 88.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for ukat-0.7.3.tar.gz
Algorithm Hash digest
SHA256 42ba772326b8929dd445d51e8aed45717d488f3a65ec907bead7ed8abec8fc91
MD5 b1dcefae18883568d4ea59f765ad78cc
BLAKE2b-256 acc2296b5f23b2dcf218930e14d9806026777be751e28d0afc29c0efd3994ce5

See more details on using hashes here.

File details

Details for the file ukat-0.7.3-py3-none-any.whl.

File metadata

  • Download URL: ukat-0.7.3-py3-none-any.whl
  • Upload date:
  • Size: 108.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for ukat-0.7.3-py3-none-any.whl
Algorithm Hash digest
SHA256 f66e0cf5b314cf4b2947a1533acb5792b3a5f4d34a4699d58763c022fc339b47
MD5 d7c0c15cfdfbee75637f2109b13040c6
BLAKE2b-256 c05553c0d666daae3d23168e1cda1cd3194d742e66a5610529d1bd345af09611

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