Metadata-Version: 2.1
Name: fredtools
Version: 0.7.4
Summary: FRED tools is a collection of python functions for image manipulation and analysis. See more on https://github.com/jasqs/FREDtools.
Home-page: https://www.fredtools.ifj.edu.pl/
Author: FRED Collaboration
Author-email: jan.gajewski@ifj.edu.pl
Project-URL: Repository, https://github.com/jasqs/FREDtools
Project-URL: FRED MC, http://www.fred-mc.org/
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10,<4.0
Description-Content-Type: text/markdown
Requires-Dist: dicompyler-core (>=0.5.6)
Requires-Dist: fitz (>=0.0.1.dev2)
Requires-Dist: fredtools (>=0.7.3)
Requires-Dist: ipython (>=8.18.1)
Requires-Dist: ipywidgets (>=8.1.1)
Requires-Dist: itk (>=5.3.0)
Requires-Dist: itk-core (>=5.3.0)
Requires-Dist: itk-filtering (>=5.3.0)
Requires-Dist: itk-io (>=5.3.0)
Requires-Dist: itk-numerics (>=5.3.0)
Requires-Dist: itk-registration (>=5.3.0)
Requires-Dist: itk-segmentation (>=5.3.0)
Requires-Dist: landaupy (>=0.1)
Requires-Dist: lmfit (>=1.2.2)
Requires-Dist: matplotlib (>=3.8.2)
Requires-Dist: numpy (>=1.24.2)
Requires-Dist: pandas (>=2.1.4)
Requires-Dist: psutil (>=5.9.4)
Requires-Dist: pyamtrack (>=0.14.0)
Requires-Dist: pydicom (>=2.4.3)
Requires-Dist: PyYAML (>=6.0.1)
Requires-Dist: PyYAML (>=5.4.1)
Requires-Dist: scipy (>=1.11.4)
Requires-Dist: Shapely (>=2.0.2)
Requires-Dist: SimpleITK (>=2.3.1)
Requires-Dist: uproot (>=5.1.2)

FRED tools repository
================================

FRED tools is a collection of python functions for image manipulation and analysis. The basic methods have been developed for analysis of the images produced by the Monte Carlo FRED (www.fred-mc.org) in MetaImage format (*.mha, *.mhd), but they can be applied for images in other formats, e.g. dicom.

Basic Concept
----------------------------
The image in the FRED tools is understood to mean scalar or vector image of any dimension from 2D to 5D. All the images read or processed by the functions are [SimpleITK](www.simpleitk.readthedocs.io) images, and any SinmpleITK routines can be applied. Check [SimpleITK filters](www.simpleitk.readthedocs.io/en/master/filters.html) for available methods of filtering, registration, etc. Because the smallest image dimension supported by SimpleITK is 2D, line profiles, i.e. 1D images are saved as SimpleITK images with the size with only one of the dimension different than one.

Most of the functions have a bool argument ``displayInfo`` (default ``displayInfo=False``) which can be used for displaying summary of the function results.

Documentation and tutorial
----------------------------
The documentation of the functions implemented in FRED tools is available at [fredtools.ifj.edu.pl](https://www.fredtools.ifj.edu.pl) or on the [GitHub repository](https://github.com/jasqs/FREDtools).

A simple [tutorial](https://github.com/jasqs/FREDtools/blob/main/examples/FREDtools%20Tutorial.ipynb) has been prepared to help with starting using FRED tools.


Installation
----------------------------
The stable version of FRED tools is available via pip.

For new installation:

  $ pip install fredtools

To update existing installation:

$ pip install --upgrade fredtools

The development version is available on GitHub.

   $ git clone jasqs/FREDtools


Development
----------------------------
Everyone is invited to support the development of the FRED tools and to add functionalities needed for a specific application.
All the new functions or classes should be documented according to numpydoc style. Check [numpydoc website](www.numpydoc.readthedocs.io) for the style guide and examples.

