biomedisa 2024.5.14__py3-none-any.whl

biomedisa-2024.5.14.dist-info/METADATA

@@ -0,0 +1,306 @@
+Metadata-Version: 2.1
+Name: biomedisa
+Version: 2024.5.14
+Summary: Segmentation of 3D volumetric image data
+Author: Philipp Lösel
+Author-email: philipp.loesel@anu.edu.au
+Project-URL: Homepage, https://biomedisa.info
+Project-URL: Issues, https://github.com/biomedisa/biomedisa/issues
+Project-URL: GitHub, https://github.com/biomedisa/biomedisa
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: European Union Public Licence 1.2 (EUPL 1.2)
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+[![biomedisa](biomedisa_app/static/biomedisa_logo.svg)](https://biomedisa.info)
+-----------
+- [Overview](#overview)
+- [Hardware Requirements](#hardware-requirements)
+- [Installation (command-line based)](#installation-command-line-based)
+- [Installation (browser based)](#installation-browser-based)
+- [Download Data](#download-data)
+- [Smart Interpolation](#smart-interpolation)
+- [Deep Learning](#deep-learning)
+- [Biomedisa Features](#biomedisa-features)
+- [Update Biomedisa](#update-biomedisa)
+- [Releases](#releases)
+- [Authors](#authors)
+- [FAQ](#faq)
+- [Citation](#citation)
+- [License](#license)
+
+# Overview
+Biomedisa (https://biomedisa.info) is a free and easy-to-use open-source application for segmenting large volumetric images, e.g. CT and MRI scans, developed at [The Australian National University CTLab](https://ctlab.anu.edu.au/). Biomedisa's semi-automated segmentation is based on a smart interpolation of sparsely pre-segmented slices, taking into account the complete underlying image data. In addition, Biomedisa enables deep learning for the fully automated segmentation of series of similar samples. It can be used in combination with segmentation tools such as Amira/Avizo, ImageJ/Fiji and 3D Slicer. If you are using Biomedisa or the data for your research please cite: Lösel, P.D. et al. [Introducing Biomedisa as an open-source online platform for biomedical image segmentation.](https://www.nature.com/articles/s41467-020-19303-w) *Nat. Commun.* **11**, 5577 (2020).
+
+# Hardware Requirements
++ One or more NVIDIA GPUs with compute capability 3.0 or higher or an Intel CPU.
+
+# Installation (command-line based)
++ [Ubuntu 22.04 + CUDA + GPU (recommended)](https://github.com/biomedisa/biomedisa/blob/master/README/ubuntu2204_cuda11.8_gpu_cli.md)
++ [Ubuntu 22.04 + OpenCL + CPU (smart interpolation only and very slow)](https://github.com/biomedisa/biomedisa/blob/master/README/ubuntu2204_opencl_cpu_cli.md)
++ [Windows 10 + CUDA + GPU (recommended)](https://github.com/biomedisa/biomedisa/blob/master/README/windows10_cuda_gpu_cli.md)
++ [Windows 10 + OpenCL + GPU (easy to install but lacks features like allaxis, smoothing, uncertainty, optimized GPU memory usage)](https://github.com/biomedisa/biomedisa/blob/master/README/windows10_opencl_gpu_cli.md)
++ [Windows 10 + OpenCL + CPU (very slow)](https://github.com/biomedisa/biomedisa/blob/master/README/windows10_opencl_cpu_cli.md)
+
+# Installation (browser based)
++ [Ubuntu 22.04](https://github.com/biomedisa/biomedisa/blob/master/README/ubuntu2204_cuda11.8.md)
+
+# Download Data
++ Download the data from our [gallery](https://biomedisa.info/gallery/)
+
+# Smart Interpolation
++ [Parameters and Examples](https://github.com/biomedisa/biomedisa/blob/master/README/smart_interpolation.md)
+
+#### Python example
+```python
+# change this line to your biomedisa directory
+path_to_biomedisa = '/home/<user>/git/biomedisa'
+
+import sys
+sys.path.append(path_to_biomedisa)
+from biomedisa_features.biomedisa_helper import load_data, save_data
+from biomedisa_features.biomedisa_interpolation import smart_interpolation
+
+# load data
+img, _ = load_data('Downloads/trigonopterus.tif')
+labels, header = load_data('Downloads/labels.trigonopterus_smart.am')
+
+# run smart interpolation with optional smoothing result
+results = smart_interpolation(img, labels, smooth=100)
+
+# get results
+regular_result = results['regular']
+smooth_result = results['smooth']
+
+# save results
+save_data('Downloads/final.trigonopterus.am', regular_result, header=header)
+save_data('Downloads/final.trigonopterus.smooth.am', smooth_result, header=header)
+```
+
+#### Command-line based
+```
+# change to the features directory
+cd git/biomedisa/biomedisa_features/
+
+# start smart interpolation
+python biomedisa_interpolation.py C:\Users\%USERNAME%\Downloads\tumor.tif C:\Users\%USERNAME%\Downloads\labels.tumor.tif
+```
+
+# Deep Learning
++ [Parameters and Examples](https://github.com/biomedisa/biomedisa/blob/master/README/deep_learning.md)
+
+#### Python example (training)
+```python
+# change this line to your biomedisa directory
+path_to_biomedisa = '/home/<user>/git/biomedisa'
+
+# load libraries
+import sys
+sys.path.append(path_to_biomedisa)
+from biomedisa_features.biomedisa_helper import load_data
+from biomedisa_features.biomedisa_deeplearning import deep_learning
+
+# load image data
+img1, _ = load_data('Head1.am')
+img2, _ = load_data('Head2.am')
+img_data = [img1, img2]
+
+# load label data and header information to be stored in the network file (optional)
+label1, _ = load_data('Head1.labels.am')
+label2, header, ext = load_data('Head2.labels.am',
+        return_extension=True)
+label_data = [label1, label2]
+
+# load validation data (optional)
+img3, _ = load_data('Head3.am')
+img4, _ = load_data('Head4.am')
+label3, _ = load_data('Head3.labels.am')
+label4, _ = load_data('Head4.labels.am')
+val_img_data = [img3, img4]
+val_label_data = [label3, label4]
+
+# deep learning 
+deep_learning(img_data, label_data, train=True, batch_size=12,
+        val_img_data=val_img_data, val_label_data=val_label_data,
+        header=header, extension=ext, path_to_model='honeybees.h5')
+```
+
+#### Command-line based (training)
+```
+# change to the features directory
+cd git/biomedisa/biomedisa_features/
+
+# start training with a batch size of 12
+python biomedisa_deeplearning.py C:\Users\%USERNAME%\Downloads\training_heart C:\Users\%USERNAME%\Downloads\training_heart_labels -t -bs 12
+
+# validation (optional)
+python biomedisa_deeplearning.py C:\Users\%USERNAME%\Downloads\training_heart C:\Users\%USERNAME%\Downloads\training_heart_labels -t -vi C:\Users\%USERNAME%\Downloads\val_img -vl C:\Users\%USERNAME%\Downloads\val_labels
+```
+If running into ResourceExhaustedError due to out of memory (OOM), try to use smaller batch size.
+
+#### Python example (prediction)
+```python
+# change this line to your biomedisa directory
+path_to_biomedisa = '/home/<user>/git/biomedisa'
+
+# load libraries
+import sys
+sys.path.append(path_to_biomedisa)
+from biomedisa_features.biomedisa_helper import load_data, save_data
+from biomedisa_features.biomedisa_deeplearning import deep_learning
+
+# load data
+img, _ = load_data('Head5.am')
+
+# deep learning
+results = deep_learning(img, predict=True,
+        path_to_model='honeybees.h5', batch_size=6)
+
+# save result
+save_data('final.Head5.am', results['regular'], results['header'])
+```
+
+#### Command-line based (prediction)
+```
+# change to the features directory
+cd git/biomedisa/biomedisa_features/
+
+# start prediction with a batch size of 6
+python biomedisa_deeplearning.py C:\Users\%USERNAME%\Downloads\testing_axial_crop_pat13.nii.gz C:\Users\%USERNAME%\Downloads\heart.h5 -p -bs 6
+```
+
+# Biomedisa Features
+
+#### Load and save data (such as Amira Mesh, TIFF, NRRD, NIfTI or DICOM)
+```python
+import sys
+sys.path.append(path_to_biomedisa)  # e.g. '/home/<user>/git/biomedisa'
+from biomedisa_features.biomedisa_helper import load_data, save_data
+
+# load data as numpy array
+# for DICOM, PNG files, or similar formats, 'path_to_data' must reference
+# either a directory or a ZIP file containing the image slices
+data, header = load_data(path_to_data)
+
+# save data (for TIFF, header=None)
+save_data(path_to_data, data, header)
+```
+
+#### Create STL mesh from segmentation (label values are saved as attributes)
+```python
+import os, sys
+sys.path.append(path_to_biomedisa)  # e.g. '/home/<user>/git/biomedisa'
+from biomedisa_features.biomedisa_helper import load_data, save_data
+from biomedisa_features.create_mesh import get_voxel_spacing, save_mesh
+
+# load segmentation
+data, header, extension = load_data(path_to_data, return_extension=True)
+
+# get voxel spacing
+x_res, y_res, z_res = get_voxel_spacing(header, data, extension)
+print(f'Voxel spacing: x_spacing, y_spacing, z_spacing = {x_res}, {y_res}, {z_res}')
+
+# save stl file
+path_to_data = path_to_data.replace(os.path.splitext(path_to_data)[1],'.stl')
+save_mesh(path_to_data, data, x_res, y_res, z_res, poly_reduction=0.9, smoothing_iterations=15)
+```
+
+#### Create mesh directly
+```
+python git/biomedisa/biomedisa_features/create_mesh.py <path_to_data>
+```
+
+#### Options
+`--poly_reduction` or `-pr`: Reduce number of polygons by this factor (default: 0.9)
+
+`--smoothing_iterations` or `-s`: Iteration steps for smoothing (default: 15)
+
+`--x_res` or `-xres`: Voxel spacing/resolution x-axis (default: None)
+
+`--y_res` or `-yres`: Voxel spacing/resolution y-axis (default: None)
+
+`--z_res` or `-zres`: Voxel spacing/resolution z-axis (default: None)
+
+#### Resize data
+```python
+import os, sys
+sys.path.append(path_to_biomedisa)  # e.g. '/home/<user>/git/biomedisa'
+from biomedisa_features.biomedisa_helper import img_resize
+
+# resize image data
+zsh, ysh, xsh = data.shape
+new_zsh, new_ysh, new_xsh = zsh//2, ysh//2, xsh//2
+data = img_resize(data, new_zsh, new_ysh, new_xsh)
+
+# resize label data
+label_data = img_resize(label_data, new_zsh, new_ysh, new_xsh, labels=True)
+```
+
+#### Remove outliers and fill holes
+```python
+from biomedisa_features.biomedisa_helper import clean, fill
+
+# delete outliers smaller than 90% of the segment
+label_data = clean(label_data, 0.9)
+
+# fill holes
+label_data = fill(label_data, 0.9)
+```
+
+#### Accuracy assessment
+```python
+from biomedisa_features.biomedisa_helper import Dice_score, ASSD
+dice = Dice_score(ground_truth, result)
+assd = ASSD(ground_truth, result)
+```
+
+# Update Biomedisa
+If you have used `git clone`, change to the Biomedisa directory and make a pull request.
+```
+cd git/biomedisa
+git pull
+```
+
+If you have installed the browser based version of Biomedisa (including MySQL database), you also need to update the database.
+```
+python manage.py migrate
+```
+
+If you have installed an [Apache Server](https://github.com/biomedisa/biomedisa/blob/master/README/APACHE_SERVER.md), you need to restart the server.
+```
+sudo service apache2 restart
+```
+
+# Releases
+
+For the versions available, see the [list of releases](https://github.com/biomedisa/biomedisa/releases). 
+
+# Authors
+
+* **Philipp D. Lösel**
+
+See also the list of [contributors](https://github.com/biomedisa/biomedisa/blob/master/credits.md) who participated in this project.
+
+# FAQ
+Frequently asked questions can be found at: https://biomedisa.info/faq/.
+
+# Citation
+
+If you use Biomedisa or the data, please cite the following paper:
+
+`Lösel, P.D. et al. Introducing Biomedisa as an open-source online platform for biomedical image segmentation. Nat. Commun. 11, 5577 (2020).` https://doi.org/10.1038/s41467-020-19303-w
+
+If you use Biomedisa's Deep Learning, you may also cite:
+
+`Lösel, P.D. et al. Natural variability in bee brain size and symmetry revealed by micro-CT imaging and deep learning. PLoS Comput. Biol. 19, e1011529 (2023).` https://doi.org/10.1371/journal.pcbi.1011529
+
+If you use Biomedisa's Smart Interpolation, you can also cite the initial description of this method:
+
+`Lösel, P. & Heuveline, V. Enhancing a diffusion algorithm for 4D image segmentation using local information. Proc. SPIE 9784, 97842L (2016).` https://doi.org/10.1117/12.2216202
+
+# License
+
+This project is covered under the **EUROPEAN UNION PUBLIC LICENCE v. 1.2 (EUPL)**.
+

biomedisa-2024.5.14.dist-info/RECORD

@@ -0,0 +1,44 @@
+biomedisa/__init__.py,sha256=BLbuGv-c8I8XMzOOnc07qrcWxq8CUA5NM73S3gkixEI,1690
+biomedisa/__main__.py,sha256=a1--8vhtztWEloHVtbM43FZLCfrFo4BELgdsgtWE8ls,536
+biomedisa/deeplearning.py,sha256=R6CBuy4tTusYi3ULnamFfYenHG0KFtJegGNMSAL9iWI,27102
+biomedisa/interpolation.py,sha256=mz5Ieiee2RftqisqNzKcCU7IV1n0LGON4zyhvBwE94s,17335
+biomedisa/mesh.py,sha256=iz4DG3g6ptO8Vs5wXsd-SZio7ipYREhXwVG2e0Z937Q,15920
+biomedisa/biomedisa_features/DataGenerator.py,sha256=FTktX35_FboSzk4UXG_ZN58xXYJqwjX_7ZJ65bzNuFs,12770
+biomedisa/biomedisa_features/DataGeneratorCrop.py,sha256=cL_1rbXSq79vCNAHnIwvow-J1s-4gWStR1pWTbF_VTY,5454
+biomedisa/biomedisa_features/PredictDataGenerator.py,sha256=MISkB2tlxCw6rd8pfwwz1clVnvyPwg5dB-8yxR6WsBw,4074
+biomedisa/biomedisa_features/PredictDataGeneratorCrop.py,sha256=JBwFcOZMakNMlL5UvP5bNg9FlQl5sbrM9UVSCyFhwBQ,3431
+biomedisa/biomedisa_features/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+biomedisa/biomedisa_features/active_contour.py,sha256=7kq4Wh-MCP5A3R6Lzk-bnS43gXW_yiKtoXRrYP018DU,18192
+biomedisa/biomedisa_features/assd.py,sha256=cXHAhwJqhwOvzgTodlQb21NvYafWTjBJ7_H_icuBNMU,6537
+biomedisa/biomedisa_features/biomedisa_helper.py,sha256=8b8yE7fCoSjR_9iM7Or-Bw2l-_zSK8b-llfgkRVXL-I,30741
+biomedisa/biomedisa_features/create_slices.py,sha256=gQJev1-DXvqDchGbnLC1bsCtb1gAnv4D82IgOnCJVt8,13329
+biomedisa/biomedisa_features/crop_helper.py,sha256=Op8x10IltAR_5YMotuVHzF3hSbxiOkAchhJM5L0qutw,23894
+biomedisa/biomedisa_features/curvop_numba.py,sha256=9jc4OvHQ6JDN-DaFhRQMLpBDU85HhqzX_YUVBf3Q3vA,7049
+biomedisa/biomedisa_features/django_env.py,sha256=S-ajQpw5A2aBlTYgn_FiyIr02QH05rInzhBDulb9lNg,8989
+biomedisa/biomedisa_features/keras_helper.py,sha256=j4SwVJ-4fMPJcZs90NXxHPaWsEqsTZEn6oFok4WuooY,50390
+biomedisa/biomedisa_features/nc_reader.py,sha256=7uwdmz4pLC__xb8hWjZ7Y9jrkNJOyD01kIA1EOP8GV0,7406
+biomedisa/biomedisa_features/pid.py,sha256=HAIq52F-PKwDGRyKE74qsY-bdBTs1s85vcIQTKaMIy8,2528
+biomedisa/biomedisa_features/process_image.py,sha256=9PobvlCzHbIeZlNVNQIGePNA4p4X-g72q3mxLxMfhR4,11159
+biomedisa/biomedisa_features/pycuda_test.py,sha256=LLd5JnlDu1hOZUTFs8IbuE2I2sBSRyZaU3sRdNpdy5Y,3274
+biomedisa/biomedisa_features/remove_outlier.py,sha256=ryG-a7V_kH5Fhg2nOueTWG_bK4cX1tlk1KYmrPDU-7Q,16852
+biomedisa/biomedisa_features/split_volume.py,sha256=yBdoO3ojEphnfs9P-Ap8NPFrmb-WM8CCZSV9deIEASs,12394
+biomedisa/biomedisa_features/amira_to_np/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+biomedisa/biomedisa_features/amira_to_np/amira_data_stream.py,sha256=JrZTyKP01CKDFB5d9BlGtSFwBgoAo0AJeAmn3pADH88,32618
+biomedisa/biomedisa_features/amira_to_np/amira_grammar.py,sha256=z1yajLHmn-GDb-rzZ5iHlKmPZDDbO9fNqP2jXf8z3KE,14324
+biomedisa/biomedisa_features/amira_to_np/amira_header.py,sha256=eWHECsTx3ls8c0RHjy5xO4s-BehRC-96wONj7n9IzrY,11553
+biomedisa/biomedisa_features/amira_to_np/amira_helper.py,sha256=giuZKkX8eI_2MVAy3wwBvcmmmDxSOo8k9eAzu2QA6uo,2218
+biomedisa/biomedisa_features/random_walk/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+biomedisa/biomedisa_features/random_walk/gpu_kernels.py,sha256=r8BsyOU_a5tYMM8d_mS9MPrUCXoTFI7NY8JIQnyfe0U,7190
+biomedisa/biomedisa_features/random_walk/pycuda_large.py,sha256=_dfYP2cFSm0aKU6n_YotsdNLZcvO8OjE5hYbgeAQk98,32917
+biomedisa/biomedisa_features/random_walk/pycuda_large_allx.py,sha256=Cfb_cq184LgfdiSTImQu7Ax8L_EKQgpXfSVapYGXy0E,30677
+biomedisa/biomedisa_features/random_walk/pycuda_small.py,sha256=691oa8JhVwDmS-y7KnNbVUziW14fAtC-lvB3rg2VWA4,15786
+biomedisa/biomedisa_features/random_walk/pycuda_small_allx.py,sha256=8bNHDKDxa-02q1ykWo_YWjzYQkM77raX_DivpWkVoQY,18225
+biomedisa/biomedisa_features/random_walk/pyopencl_large.py,sha256=cOBhvxrdKCkbr6xaKneBTiUMXPk9lSdjwt95TdHC2EY,31015
+biomedisa/biomedisa_features/random_walk/pyopencl_small.py,sha256=2XALYNNv9D8Gb1u2lcjR1O4W9UM0Xxjj0r4nr-NiEkk,17068
+biomedisa/biomedisa_features/random_walk/rw_large.py,sha256=A_3sV5_UzoBwT7e2-JqSnANTiVKson0Gp7H4JenHkP4,19852
+biomedisa/biomedisa_features/random_walk/rw_small.py,sha256=LwleLNNSdISBCtx7Yn2-EEBxCwhdqGFTUaWwKrGV7KM,14951
+biomedisa-2024.5.14.dist-info/LICENSE,sha256=sehayP6UhydNnmstfL4yFR3genMRdpuUh6uZVWJN1H0,14152
+biomedisa-2024.5.14.dist-info/METADATA,sha256=JGduIDT4hQoHyZQcYyX9hZo5xwIKEe0qmlPzf8hwUjU,11678
+biomedisa-2024.5.14.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+biomedisa-2024.5.14.dist-info/top_level.txt,sha256=opsf1Eb4vCguPSxev4HHSeiUKCccT_C_RcUCdAYbHWQ,10
+biomedisa-2024.5.14.dist-info/RECORD,,

biomedisa-2024.5.14.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

biomedisa-2024.5.14.dist-info/top_level.txt

@@ -0,0 +1 @@
+biomedisa