Skip to content

Commit

Permalink
Merge pull request #56 from niaid/readme_update_public
Browse files Browse the repository at this point in the history
Update readme for public installation and contact information
  • Loading branch information
blowekamp authored Oct 7, 2024
2 parents cbb2229 + 3dadcb8 commit 478972e
Showing 1 changed file with 19 additions and 25 deletions.
44 changes: 19 additions & 25 deletions README.rst
Original file line number Diff line number Diff line change
@@ -1,53 +1,47 @@
Radiomics Analysis Portal sitkCore
++++++++++++++++++++++++++++++++++

This sitkCore for the Radiomics Analysis Portal (RAP) contains common utilities for developing algorithms for analysis
of data from Tuberculosis Portals (TBPortals). The tools are written in Python and provided as an installable Python
package. The application programming interface (API) is documented in Sphinx: https://niaid.github.io/rap_sitkCore
The sitkCore package used by the Radiomics Analysis Portal (`RAP`_) contains common utilities for developing image
analysis algorithms that use data provided by the Tuberculosis Portals Program (`TBPortals`_). The tools are written in
Python and provided as an installable Python package. The application programming interface (API) is documented in
Sphinx:
https://niaid.github.io/rap_sitkCore

.. image:: https://github.com/niaid/rap_sitkCore/actions/workflows/main.yml/badge.svg?branch=master
:target: https://github.com/niaid/rap_sitkCore/actions/workflows/main.yml
:alt: Master Build Status
:alt: Main Build Status

Installation
------------

The Python module is distributed as a `wheel`_ binary package.
Dependencies are conventionally specified in `pyproject.toml`, and dependent packages are installed automatically by
`pip`_. The package can be directly installed from the Github with the following command::

Dependencies are conventionally specified in `setup.py` and `requirements.txt`.
python -m pip install git+https://github.com/niaid/[email protected]

NIAID Artifactory
^^^^^^^^^^^^^^^^^

The `rap_sitkcore` package can be installed from the internal NIAID Python Package Index (PyPI) hosted on
artifactory with `pip`_. When this package is a dependency for other projects it can be automatically download from the
artifactory. The internal repository can be automatically used by setting an environment variable::

PIP_EXTRA_INDEX_URL=https://{USERNAME}:{PASSWORD}@artifactory.niaid.nih.gov/artifactory/api/pypi/bcbb-pypi/simple

Then running::

python -m pip install rap_sitkcore

Then the `rap_sitkcore` package can be installed if specified in another projects requirements.txt.

For pydicom to support more encodings additional pylibjpeg packages can be install. These dependencies are specified as
extra requirements in the setup.py. Specifying the package a "rap_sitkcore[pylibjpeg]" will install the extra packages.

Github Releases
^^^^^^^^^^^^^^^

Wheels from the master branch can be manually download wheel from `Github Actions`_ in the "python-package" artifact.
The Python module is also distributed as a `wheel`_ binary package. Wheels from the master branch can be manually
downloaded from `Github Actions`_ in the "python-package" artifact.

Download the latest tagged release from the `Github Releases`_ page.

The wheel lists the package dependencies which are required for successful installation. This include internal NIAID
packages. If the internal "artifactory" repository is not configured then these additional dependencies will need to be
manually downloaded and installed before install `tbpcxr`. The downloaded wheels can be installed::

python -m pip install rap_sitkcore-0.1-py3-none-any.whl
Contact
-------

Please use the `GitHub Issues`_ for support.

Additionally, we can be emailed at: [email protected] Please include "rap_sitCore" in the subject line.

.. _RAP: https://rap.tbportals.niaid.nih.gov/
.. _TBPortals: https://tbportals.niaid.nih.gov/
.. _SimpleITK toolkit: https://simpleitk.org
.. _pip: https://pip.pypa.io/en/stable/quickstart/
.. _Github Actions: https://github.com/niaid/rap_sitkCore/actions?query=branch%3Amaster
.. _GitHub Issues: https://github.com/niaid/rap_sitkCore
Expand Down

0 comments on commit 478972e

Please sign in to comment.