biomedisa 2024.5.20__py3-none-any.whl → 2024.5.21__py3-none-any.whl

biomedisa/__init__.py

@@ -1,7 +1,7 @@
 import os
 import subprocess
 
-# from source base directory
+# base directory
 BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
 
 # pip installation

biomedisa/features/split_volume.py

@@ -28,7 +28,7 @@
 
 import os
 from biomedisa.features.biomedisa_helper import load_data, save_data
-from biomedisa.features.interpolation import smart_interpolation
+from biomedisa.interpolation import smart_interpolation
 from tifffile import imread, imwrite, TiffFile
 import numpy as np
 import argparse

{biomedisa-2024.5.20.dist-info → biomedisa-2024.5.21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: biomedisa
-Version: 2024.5.20
+Version: 2024.5.21
 Summary: Segmentation of 3D volumetric image data
 Author: Philipp Lösel
 Author-email: philipp.loesel@anu.edu.au
@@ -21,36 +21,41 @@ License-File: LICENSE
 - [Installation (command-line based)](#installation-command-line-based)
 - [Installation (browser based)](#installation-browser-based)
 - [Download Data](#download-data)
+- [Revisions](#revisions)
 - [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
+## 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
+## Hardware Requirements
 + One or more NVIDIA GPUs with compute capability 3.0 or higher or an Intel CPU.
 
-# Installation (command-line based)
+## 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)
+## Installation (browser based)
 + [Ubuntu 22.04](https://github.com/biomedisa/biomedisa/blob/master/README/ubuntu2204_cuda11.8.md)
 
-# Download Data
+## Download Data
 + Download the data from our [gallery](https://biomedisa.info/gallery/)
 
-# Smart Interpolation
+## Revisions
+2024.05.21
++ Pip is the preferred installation method
++ Commands, module names and imports have been changed to conform to the Pip standard
++ For versions <=2023.09.1 please check [README](https://github.com/biomedisa/biomedisa/blob/master/README/deprecated/README_2023.09.1.md)
+
+## Smart Interpolation
 + [Parameters and Examples](https://github.com/biomedisa/biomedisa/blob/master/README/smart_interpolation.md)
 
 #### Python example
@@ -77,9 +82,12 @@ save_data('Downloads/final.trigonopterus.smooth.am', smooth_result, header=heade
 #### Command-line based
 ```
 python -m biomedisa.interpolation C:\Users\%USERNAME%\Downloads\tumor.tif C:\Users\%USERNAME%\Downloads\labels.tumor.tif
+
+# if pre-segmentation is not exclusively in the XY plane
+python -m biomedisa.interpolation C:\Users\%USERNAME%\Downloads\tumor.tif C:\Users\%USERNAME%\Downloads\labels.tumor.tif --allaxis
 ```
 
-# Deep Learning
+## Deep Learning
 + [Parameters and Examples](https://github.com/biomedisa/biomedisa/blob/master/README/deep_learning.md)
 
 #### Python example (training)
@@ -115,10 +123,10 @@ deep_learning(img_data, label_data, train=True, batch_size=12,
 #### Command-line based (training)
 ```
 # start training with a batch size of 12
-python -m biomedisa.deeplearning C:\Users\%USERNAME%\Downloads\training_heart C:\Users\%USERNAME%\Downloads\training_heart_labels -t -bs 12
+python -m biomedisa.deeplearning C:\Users\%USERNAME%\Downloads\training_heart C:\Users\%USERNAME%\Downloads\training_heart_labels -t -bs=12
 
 # validation (optional)
-python -m biomedisa.deeplearning 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
+python -m biomedisa.deeplearning 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.
 
@@ -143,7 +151,7 @@ save_data('final.Head5.am', results['regular'], results['header'])
 python -m biomedisa.deeplearning C:\Users\%USERNAME%\Downloads\testing_axial_crop_pat13.nii.gz C:\Users\%USERNAME%\Downloads\heart.h5 -p
 ```
 
-# Biomedisa Features
+## Biomedisa Features
 
 #### Load and save data (such as Amira Mesh, TIFF, NRRD, NIfTI or DICOM)
 ```python
@@ -222,41 +230,16 @@ dice = Dice_score(ground_truth, result)
 assd = ASSD(ground_truth, result)
 ```
 
-# Update Biomedisa
-If you installed Biomedisa via Pip
-```
-pip install --upgrade biomedisa
-```
-If you used `git clone`, change to the Biomedisa directory and make a pull request
-```
-cd git/biomedisa
-git pull
-```
-
-If you installed the browser based version of Biomedisa (including MySQL database), you also need to update the database
-```
-python manage.py migrate
-```
-
-If you 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
+## 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
+## FAQ
 Frequently asked questions can be found at: https://biomedisa.info/faq/.
 
-# Citation
+## Citation
 
 If you use Biomedisa or the data, please cite the following paper:
 
@@ -270,7 +253,7 @@ If you use Biomedisa's Smart Interpolation, you can also cite the initial descri
 
 `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
+## License
 
 This project is covered under the **EUROPEAN UNION PUBLIC LICENCE v. 1.2 (EUPL)**.
 

{biomedisa-2024.5.20.dist-info → biomedisa-2024.5.21.dist-info}/RECORD

@@ -1,4 +1,4 @@
-biomedisa/__init__.py,sha256=RxXuOh-e-W9k7pvmKDyYZz3bbze7AkB7RgRpUCzLbcE,1538
+biomedisa/__init__.py,sha256=hw4mzEjGFXm-vxus2DBfKFW0nKoG0ibL5SH6ShfchrY,1526
 biomedisa/__main__.py,sha256=a1--8vhtztWEloHVtbM43FZLCfrFo4BELgdsgtWE8ls,536
 biomedisa/deeplearning.py,sha256=dVwLkijm0ibtn6zUUV3t2WK6Fzvks4VlgzKNLqzDpAQ,27064
 biomedisa/interpolation.py,sha256=R8UbBWt7vOuiQCPSeNIpEY0_yfQUg1oBfhAjXi91Hl4,17253
@@ -21,7 +21,7 @@ biomedisa/features/pid.py,sha256=Jmn1VIp0fBlgBrqZ-yUIQVVb5-NAxNBdibXALVr2PPI,254
 biomedisa/features/process_image.py,sha256=VtS3fGDvglqJiiJLPK1toe76J58j914NJ8XQKg3CRwo,11091
 biomedisa/features/pycuda_test.py,sha256=UGAGIz_dgcCJkzjyCqnMlflp-WJPzpCtFQmE9C5DwIo,3275
 biomedisa/features/remove_outlier.py,sha256=XhbFPkazMmEUZiP0FERdCkrXaLhwO095x4wcn-B3SdU,16756
-biomedisa/features/split_volume.py,sha256=l106WXlDSDut-PlP9_O7WmJCp6euoViPjYG7awoA9Y8,8926
+biomedisa/features/split_volume.py,sha256=UgMpHhZPvH90xFo-mJ0Oc0tBXbrf8FQF0kzVySAlO8g,8917
 biomedisa/features/amira_to_np/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 biomedisa/features/amira_to_np/amira_data_stream.py,sha256=JrZTyKP01CKDFB5d9BlGtSFwBgoAo0AJeAmn3pADH88,32618
 biomedisa/features/amira_to_np/amira_grammar.py,sha256=z1yajLHmn-GDb-rzZ5iHlKmPZDDbO9fNqP2jXf8z3KE,14324
@@ -37,8 +37,8 @@ biomedisa/features/random_walk/pyopencl_large.py,sha256=q79AxG3p3qFjxfiAZfUK9I5B
 biomedisa/features/random_walk/pyopencl_small.py,sha256=opNlS-qzOa9qWafBNJdvf6r1aRAFf7_JXf6ISDnkdXE,17068
 biomedisa/features/random_walk/rw_large.py,sha256=ZnITvk00Y11ZZlGuBRaJO1EwU0wYBdEwdpj9vvXCqF4,19805
 biomedisa/features/random_walk/rw_small.py,sha256=RPzZe24YrEwYelJukDjvqaoD_SyhgdriEi7uV3kZGXI,14881
-biomedisa-2024.5.20.dist-info/LICENSE,sha256=sehayP6UhydNnmstfL4yFR3genMRdpuUh6uZVWJN1H0,14152
-biomedisa-2024.5.20.dist-info/METADATA,sha256=uM3KiOS5fzl6WFv8cNRgsCT-l4DnGzgZoBiDqPg_qXM,10677
-biomedisa-2024.5.20.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-biomedisa-2024.5.20.dist-info/top_level.txt,sha256=opsf1Eb4vCguPSxev4HHSeiUKCccT_C_RcUCdAYbHWQ,10
-biomedisa-2024.5.20.dist-info/RECORD,,
+biomedisa-2024.5.21.dist-info/LICENSE,sha256=sehayP6UhydNnmstfL4yFR3genMRdpuUh6uZVWJN1H0,14152
+biomedisa-2024.5.21.dist-info/METADATA,sha256=GJ9BXl6MH84zMYZrpShMBkSDZx50dYIKWDE97EWj1-w,10465
+biomedisa-2024.5.21.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+biomedisa-2024.5.21.dist-info/top_level.txt,sha256=opsf1Eb4vCguPSxev4HHSeiUKCccT_C_RcUCdAYbHWQ,10
+biomedisa-2024.5.21.dist-info/RECORD,,