Skip to content

Commit 9ed66ba

Browse files
authored
Update tutorials after testing with holoscan v2.9.0 (#522)
* Updated words on downloading data code on checking staged/extracted input Signed-off-by: M Q <mingmelvinq@nvidia.com> * Correct typo Signed-off-by: M Q <mingmelvinq@nvidia.com> * correct typo Signed-off-by: M Q <mingmelvinq@nvidia.com> * Updated the README Signed-off-by: M Q <mingmelvinq@nvidia.com> * Rerun all notebook tutorials Signed-off-by: M Q <mingmelvinq@nvidia.com> --------- Signed-off-by: M Q <mingmelvinq@nvidia.com>
1 parent a80f231 commit 9ed66ba

8 files changed

+3517
-2372
lines changed

README.md

+9-7
Original file line numberDiff line numberDiff line change
@@ -32,11 +32,12 @@ To install [the current release](https://pypi.org/project/monai-deploy-app-sdk/)
3232
pip install monai-deploy-app-sdk # '--pre' to install a pre-release version.
3333
```
3434

35-
Please also note the following system requirements:
36-
- Ubuntu 22.04 on X86-64 is required, as this is the only X86 platform that the underlying Holoscan SDK has been tested to support as of now.
37-
- [CUDA 12](https://developer.nvidia.com/cuda-12-0-0-download-archive) is required along with a supported NVIDIA GPU with at least 8GB of video RAM. If AI inference is not used in the example application and a GPU is not installed, at least [CUDA 12 runtime](https://pypi.org/project/nvidia-cuda-runtime-cu12/) is required, as this is one of the requirements of Holoscan SDK, in addition, the `LIB_LIBRARY_PATH` must be set to include the installed shared library, e.g. in a Python 3.8 env, ```export LD_LIBRARY_PATH=`pwd`/.venv/lib/python3.8/site-packages/nvidia/cuda_runtime/lib:$LD_LIBRARY_PATH```
38-
35+
### Prerequisites
3936

37+
- This SDK depends on [NVIDIA Holoscan SDK](https://pypi.org/project/holoscan/) for its core implementation as well as its CLI, hence inherits its prerequisites, e.g. Ubuntu 22.04 with glibc 2.35 on X86-64 and NVIDIA dGPU drivers version 535 or above.
38+
- [CUDA 12.2](https://developer.nvidia.com/cuda-12-2-0-download-archive) or above is required along with a supported NVIDIA GPU with at least 8GB of video RAM.
39+
- If inference is not used in an example application and a GPU is not installed, at least [CUDA 12 runtime](https://pypi.org/project/nvidia-cuda-runtime-cu12/) is required, as this is one of the requirements of Holoscan SDK. In addition, the `LIB_LIBRARY_PATH` must be set to include the installed shared library, e.g. in a Python 3.10 env, ```export LD_LIBRARY_PATH=`pwd`/.venv/lib/python3.10/site-packages/nvidia/cuda_runtime/lib:$LD_LIBRARY_PATH```
40+
- Python: 3.9 to 3.12
4041

4142
## Getting Started
4243

@@ -53,15 +54,16 @@ cd monai-deploy-app-sdk
5354
pip install matplotlib Pillow scikit-image
5455

5556
# Execute the app locally
56-
python examples/apps/simple_imaging_app/app.py -i examples/apps/simple_imaging_app/brain_mr_input.jpg -o output
57+
python examples/apps/simple_imaging_app/app.py -i examples/apps/simple_imaging_app/input/brain_mr_input.jpg -o output
5758

5859
# Package app (creating MAP Docker image), using `-l DEBUG` option to see progress.
59-
monai-deploy package examples/apps/simple_imaging_app -c simple_imaging_app/app.yaml -t simple_app:latest --platform x64-workstation -l DEBUG
60+
# Also please note that postfix will be added to user supplied tag for identifying CPU architecture and GPU type etc.
61+
monai-deploy package examples/apps/simple_imaging_app -c examples/apps/simple_imaging_app/app.yaml -t simple_app:latest --platform x64-workstation -l DEBUG
6062

6163
# Run the app with docker image and an input file locally
6264
## Copy a test input file to 'input' folder
6365
mkdir -p input && rm -rf input/*
64-
cp examples/apps/simple_imaging_app/brain_mr_input.jpg input/
66+
cp examples/apps/simple_imaging_app/input/brain_mr_input.jpg input/
6567
## Launch the app
6668
monai-deploy run simple_app-x64-workstation-dgpu-linux-amd64:latest -i input -o output
6769
```

notebooks/tutorials/01_simple_app.ipynb

+390-411
Large diffs are not rendered by default.

notebooks/tutorials/02_mednist_app-prebuilt.ipynb

+321-323
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)