Skip to content

Commit c9c9807

Browse files
committed
[ai notebooks - new image segmentation tuto]
1 parent d74e070 commit c9c9807

17 files changed

+1698
-0
lines changed
Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
---
2+
title: AI Notebooks - Tutorial - Brain tumor segmentation using U-Net
3+
slug: notebooks/tuto-image-segmentation-unet-brain-tumors
4+
excerpt: How to convert Speech to Text using AI Notebooks
5+
section: AI Notebooks - Tutorials
6+
order: 12
7+
routes:
8+
canonical: 'https://docs.ovh.com/gb/en/publiccloud/ai/notebooks/tuto-image-segmentation-unet-brain-tumors/'
9+
updated: 2023-04-13
10+
---
11+
12+
**Last updated 13th April, 2023.**
13+
14+
## Objective
15+
16+
Over the past few years, the field of **computer vision** has experienced a significant growth. It encompasses a wide range of methods for acquiring, processing, analyzing and understanding digital images.
17+
18+
Among these methods, one is called **image segmentation**.
19+
20+
The purpose of this tutorial is to show you how it is possible to build and train a brain tumor segmentation model with **OVHcloud AI Notebooks**. You will be able to learn the concepts of medical imaging, image segmentation, model evaluation, and much more. We will use a popular convolutional neural network named **U-Net**.
21+
22+
At the end of this tutorial, you will have learnt the principal methods to **segment brain tumors**.
23+
24+
![image](images/mri_orig_pred_segmentation.gif){.thumbnail}
25+
26+
> [!primary]
27+
>
28+
> We will train this model on the *[BraTS2020 dataset](http://braintumorsegmentation.org/)*. We will show you how you can easily download the dataset in the notebook tutorial.
29+
>
30+
31+
## Requirements
32+
33+
- Access to the [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.de/&ovhSubsidiary=de)
34+
- An AI Notebooks project created inside a [Public Cloud project](https://www.ovhcloud.com/de/public-cloud/) in your OVHcloud account
35+
- A user for AI Notebooks
36+
37+
## Instructions
38+
39+
You can launch the notebook from the [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.de/&ovhSubsidiary=de) or via the ovhai [CLI](https://docs.ovh.com/de/publiccloud/ai/cli/getting-started-cli/).
40+
41+
### Launching a Jupyter notebook with "Miniconda" via UI (Control Panel)
42+
43+
To launch your notebook from the [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.de/&ovhSubsidiary=de), refer to the following steps.
44+
45+
#### Code editor
46+
47+
Choose the `Jupyterlab` code editor.
48+
49+
#### Framework
50+
51+
In this tutorial, the `tensorflow` framework is used. If you use another environment, there may be some compatibility problems such as missing libraries.
52+
53+
#### Resources
54+
55+
GPU is recommended because medical imaging is a training intensive task.
56+
57+
> [!primary]
58+
>
59+
> Here, using `1 GPU` is sufficient.
60+
>
61+
62+
### Launching a Jupyter notebook with "Miniconda" via CLI
63+
64+
*If you do not have our CLI yet, follow [this guide](https://docs.ovh.com/de/publiccloud/ai/cli/install-client/) to install it.*
65+
66+
If you want to launch your notebook with the OVHcloud AI CLI, choose the `jupyterlab` editor and the `tensorflow` framework.
67+
68+
To access the different versions of `tensorflow` available, run the following command:
69+
70+
```console
71+
ovhai capabilities framework list -o yaml
72+
```
73+
74+
> [!primary]
75+
>
76+
> If you do not specify a version, your notebook starts with the default version of `tensorflow`.
77+
>
78+
79+
You will also need to choose the number of CPUs/GPUs (`<nb-cpus>` or `<nb-gpus>`) to use in your notebook.
80+
81+
> [!primary]
82+
>
83+
> Here we recommend using `1 GPU`.
84+
>
85+
86+
To launch your notebook, run the following command:
87+
88+
```console
89+
ovhai notebook run tensorflow jupyterlab \
90+
--name <notebook-name> \
91+
--framework-version <tensorflow-version> \
92+
--gpu <nb-gpus>
93+
```
94+
95+
You can then reach your notebook’s URL once the notebook is running.
96+
97+
### Accessing the notebooks
98+
99+
Once our [AI examples repository](https://github.com/ovh/ai-training-examples/) has been cloned in your environment, find your notebook by following this path: `ai-training-examples` > `notebooks` > `computer-vision` > `image-segmentation` > `tensorflow` > `brain-tumor-segmentation-unet` > `notebook_image_segmentation_unet.ipynb`.
100+
101+
A preview of this notebook can be found on GitHub [here](####PUT LINK ONCE AVAILABLE####).
102+
103+
## Go further
104+
There are many other tasks that exist in the computer vision field. Check our other tutorials to learn how to:
105+
106+
- [Use Transfer Learning with ResNet50 for image classification](https://github.com/ovh/ai-training-examples/blob/main/notebooks/computer-vision/image-classification/tensorflow/resnet50/notebook-resnet-transfer-learning-image-classification.ipynb)
107+
108+
- [Train YOLOv7 for American Sign Language recognition](https://github.com/ovh/ai-training-examples/blob/main/notebooks/computer-vision/object-detection/miniconda/yolov7/notebook_object_detection_yolov7_asl.ipynb)
109+
110+
## Feedback
111+
112+
Please send us your questions, feedback and suggestions to improve the service:
113+
114+
- On the OVHcloud [Discord server](https://discord.com/invite/vXVurFfwe9)
Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
---
2+
title: AI Notebooks - Tutorial - Brain tumor segmentation using U-Net
3+
slug: notebooks/tuto-image-segmentation-unet-brain-tumors
4+
excerpt: How to convert Speech to Text using AI Notebooks
5+
section: AI Notebooks - Tutorials
6+
order: 12
7+
updated: 2023-04-13
8+
---
9+
10+
**Last updated 13th April, 2023.**
11+
12+
## Objective
13+
14+
Over the past few years, the field of **computer vision** has experienced a significant growth. It encompasses a wide range of methods for acquiring, processing, analyzing and understanding digital images.
15+
16+
Among these methods, one is called **image segmentation**.
17+
18+
The purpose of this tutorial is to show you how it is possible to build and train a brain tumor segmentation model with **OVHcloud AI Notebooks**. You will be able to learn the concepts of medical imaging, image segmentation, model evaluation, and much more. We will use a popular convolutional neural network named **U-Net**.
19+
20+
At the end of this tutorial, you will have learnt the principal methods to **segment brain tumors**.
21+
22+
![image](images/mri_orig_pred_segmentation.gif){.thumbnail}
23+
24+
> [!primary]
25+
>
26+
> We will train this model on the *[BraTS2020 dataset](http://braintumorsegmentation.org/)*. We will show you how you can easily download the dataset in the notebook tutorial.
27+
>
28+
29+
## Requirements
30+
31+
- Access to the [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.com/asia/&ovhSubsidiary=asia)
32+
- An AI Notebooks project created inside a [Public Cloud project](https://www.ovhcloud.com/asia/public-cloud/) in your OVHcloud account
33+
- A user for AI Notebooks
34+
35+
## Instructions
36+
37+
You can launch the notebook from the [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.com/asia/&ovhSubsidiary=asia) or via the ovhai [CLI](https://docs.ovh.com/asia/en/publiccloud/ai/cli/getting-started-cli/).
38+
39+
### Launching a Jupyter notebook with "Miniconda" via UI (Control Panel)
40+
41+
To launch your notebook from the [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.com/asia/&ovhSubsidiary=asia), refer to the following steps.
42+
43+
#### Code editor
44+
45+
Choose the `Jupyterlab` code editor.
46+
47+
#### Framework
48+
49+
In this tutorial, the `tensorflow` framework is used. If you use another environment, there may be some compatibility problems such as missing libraries.
50+
51+
#### Resources
52+
53+
GPU is recommended because medical imaging is a training intensive task.
54+
55+
> [!primary]
56+
>
57+
> Here, using `1 GPU` is sufficient.
58+
>
59+
60+
### Launching a Jupyter notebook with "Miniconda" via CLI
61+
62+
*If you do not have our CLI yet, follow [this guide](https://docs.ovh.com/asia/en/publiccloud/ai/cli/install-client/) to install it.*
63+
64+
If you want to launch your notebook with the OVHcloud AI CLI, choose the `jupyterlab` editor and the `tensorflow` framework.
65+
66+
To access the different versions of `tensorflow` available, run the following command:
67+
68+
```console
69+
ovhai capabilities framework list -o yaml
70+
```
71+
72+
> [!primary]
73+
>
74+
> If you do not specify a version, your notebook starts with the default version of `tensorflow`.
75+
>
76+
77+
You will also need to choose the number of CPUs/GPUs (`<nb-cpus>` or `<nb-gpus>`) to use in your notebook.
78+
79+
> [!primary]
80+
>
81+
> Here we recommend using `1 GPU`.
82+
>
83+
84+
To launch your notebook, run the following command:
85+
86+
```console
87+
ovhai notebook run tensorflow jupyterlab \
88+
--name <notebook-name> \
89+
--framework-version <tensorflow-version> \
90+
--gpu <nb-gpus>
91+
```
92+
93+
You can then reach your notebook’s URL once the notebook is running.
94+
95+
### Accessing the notebooks
96+
97+
Once our [AI examples repository](https://github.com/ovh/ai-training-examples/) has been cloned in your environment, find your notebook by following this path: `ai-training-examples` > `notebooks` > `computer-vision` > `image-segmentation` > `tensorflow` > `brain-tumor-segmentation-unet` > `notebook_image_segmentation_unet.ipynb`.
98+
99+
A preview of this notebook can be found on GitHub [here](####PUT LINK ONCE AVAILABLE####).
100+
101+
## Go further
102+
There are many other tasks that exist in the computer vision field. Check our other tutorials to learn how to:
103+
104+
- [Use Transfer Learning with ResNet50 for image classification](https://github.com/ovh/ai-training-examples/blob/main/notebooks/computer-vision/image-classification/tensorflow/resnet50/notebook-resnet-transfer-learning-image-classification.ipynb)
105+
106+
- [Train YOLOv7 for American Sign Language recognition](https://github.com/ovh/ai-training-examples/blob/main/notebooks/computer-vision/object-detection/miniconda/yolov7/notebook_object_detection_yolov7_asl.ipynb)
107+
108+
## Feedback
109+
110+
Please send us your questions, feedback and suggestions to improve the service:
111+
112+
- On the OVHcloud [Discord server](https://discord.com/invite/vXVurFfwe9)
Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
---
2+
title: AI Notebooks - Tutorial - Brain tumor segmentation using U-Net
3+
slug: notebooks/tuto-image-segmentation-unet-brain-tumors
4+
excerpt: How to convert Speech to Text using AI Notebooks
5+
section: AI Notebooks - Tutorials
6+
order: 12
7+
updated: 2023-04-13
8+
---
9+
10+
**Last updated 13th April, 2023.**
11+
12+
## Objective
13+
14+
Over the past few years, the field of **computer vision** has experienced a significant growth. It encompasses a wide range of methods for acquiring, processing, analyzing and understanding digital images.
15+
16+
Among these methods, one is called **image segmentation**.
17+
18+
The purpose of this tutorial is to show you how it is possible to build and train a brain tumor segmentation model with **OVHcloud AI Notebooks**. You will be able to learn the concepts of medical imaging, image segmentation, model evaluation, and much more. We will use a popular convolutional neural network named **U-Net**.
19+
20+
At the end of this tutorial, you will have learnt the principal methods to **segment brain tumors**.
21+
22+
![image](images/mri_orig_pred_segmentation.gif){.thumbnail}
23+
24+
> [!primary]
25+
>
26+
> We will train this model on the *[BraTS2020 dataset](http://braintumorsegmentation.org/)*. We will show you how you can easily download the dataset in the notebook tutorial.
27+
>
28+
29+
## Requirements
30+
31+
- Access to the [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.com.au/&ovhSubsidiary=au)
32+
- An AI Notebooks project created inside a [Public Cloud project](https://www.ovhcloud.com/en-au/public-cloud/) in your OVHcloud account
33+
- A user for AI Notebooks
34+
35+
## Instructions
36+
37+
You can launch the notebook from the [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.com.au/&ovhSubsidiary=au) or via the ovhai [CLI](https://docs.ovh.com/au/en/publiccloud/ai/cli/getting-started-cli/).
38+
39+
### Launching a Jupyter notebook with "Miniconda" via UI (Control Panel)
40+
41+
To launch your notebook from the [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.com.au/&ovhSubsidiary=au), refer to the following steps.
42+
43+
#### Code editor
44+
45+
Choose the `Jupyterlab` code editor.
46+
47+
#### Framework
48+
49+
In this tutorial, the `tensorflow` framework is used. If you use another environment, there may be some compatibility problems such as missing libraries.
50+
51+
#### Resources
52+
53+
GPU is recommended because medical imaging is a training intensive task.
54+
55+
> [!primary]
56+
>
57+
> Here, using `1 GPU` is sufficient.
58+
>
59+
60+
### Launching a Jupyter notebook with "Miniconda" via CLI
61+
62+
*If you do not have our CLI yet, follow [this guide](https://docs.ovh.com/au/en/publiccloud/ai/cli/install-client/) to install it.*
63+
64+
If you want to launch your notebook with the OVHcloud AI CLI, choose the `jupyterlab` editor and the `tensorflow` framework.
65+
66+
To access the different versions of `tensorflow` available, run the following command:
67+
68+
```console
69+
ovhai capabilities framework list -o yaml
70+
```
71+
72+
> [!primary]
73+
>
74+
> If you do not specify a version, your notebook starts with the default version of `tensorflow`.
75+
>
76+
77+
You will also need to choose the number of CPUs/GPUs (`<nb-cpus>` or `<nb-gpus>`) to use in your notebook.
78+
79+
> [!primary]
80+
>
81+
> Here we recommend using `1 GPU`.
82+
>
83+
84+
To launch your notebook, run the following command:
85+
86+
```console
87+
ovhai notebook run tensorflow jupyterlab \
88+
--name <notebook-name> \
89+
--framework-version <tensorflow-version> \
90+
--gpu <nb-gpus>
91+
```
92+
93+
You can then reach your notebook’s URL once the notebook is running.
94+
95+
### Accessing the notebooks
96+
97+
Once our [AI examples repository](https://github.com/ovh/ai-training-examples/) has been cloned in your environment, find your notebook by following this path: `ai-training-examples` > `notebooks` > `computer-vision` > `image-segmentation` > `tensorflow` > `brain-tumor-segmentation-unet` > `notebook_image_segmentation_unet.ipynb`.
98+
99+
A preview of this notebook can be found on GitHub [here](####PUT LINK ONCE AVAILABLE####).
100+
101+
## Go further
102+
There are many other tasks that exist in the computer vision field. Check our other tutorials to learn how to:
103+
104+
- [Use Transfer Learning with ResNet50 for image classification](https://github.com/ovh/ai-training-examples/blob/main/notebooks/computer-vision/image-classification/tensorflow/resnet50/notebook-resnet-transfer-learning-image-classification.ipynb)
105+
106+
- [Train YOLOv7 for American Sign Language recognition](https://github.com/ovh/ai-training-examples/blob/main/notebooks/computer-vision/object-detection/miniconda/yolov7/notebook_object_detection_yolov7_asl.ipynb)
107+
108+
## Feedback
109+
110+
Please send us your questions, feedback and suggestions to improve the service:
111+
112+
- On the OVHcloud [Discord server](https://discord.com/invite/vXVurFfwe9)

0 commit comments

Comments
 (0)