You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -17,11 +17,11 @@ A Runtime-Based Computational Performance Predictor for Deep Neural Network Trai
17
17
-[Research paper](#paper)
18
18
-[Contributing](#contributing)
19
19
20
-
Habitat is a tool that predicts a deep neural network's training iteration execution time on a given GPU. It currently supports PyTorch. To learn more about how Habitat works, please see our [research paper](https://arxiv.org/abs/2102.00527).
20
+
DeepView.Predict is a tool that predicts a deep neural network's training iteration execution time on a given GPU. It currently supports PyTorch. To learn more about how DeepView.Predict works, please see our [research paper](https://arxiv.org/abs/2102.00527).
21
21
22
22
<h2id="installation">Installation</h2>
23
23
24
-
To run Habitat, you need:
24
+
To run DeepView.Predict, you need:
25
25
-[Python 3.6+](https://www.python.org/)
26
26
-[Pytorch 1.1.0+](https://pytorch.org/)
27
27
- A system equiped with an Nvidia GPU with properly configured CUDA
@@ -37,12 +37,17 @@ Currently, we have predictors for the following Nvidia GPUs:
37
37
| 2080Ti | Turing | 11 GB | GDDR6 | 68 |
38
38
| T4 | Turing | 16 GB | GDDR6 | 40 |
39
39
| 3090 | Ampere | 24 GB | GDDR6X | 82 |
40
+
| A100 | Ampere | 40 GB | HBM2 | 108 |
41
+
| A40 | Ampere | 48 GB | GDDR6 | 84 |
42
+
| A4000 | Ampere | 16 GB | GDDR6 | 48 |
43
+
| 4000 | Turing | 8 GB | GDDR6 | 36 |
44
+
40
45
41
46
<h2id="building-locally">Building locally</h2>
42
47
43
48
### 1. Install CUPTI
44
49
45
-
CUPTI is a profiling interface required by Habitat. Select your version of CUDA [here](https://developer.nvidia.com/cuda-toolkit-archive) and follow the instructions to add NVIDIA's repository. Then, install CUPTI with:
50
+
CUPTI is a profiling interface required by DeepView.Predict. Select your version of CUDA [here](https://developer.nvidia.com/cuda-toolkit-archive) and follow the instructions to add NVIDIA's repository. Then, install CUPTI with:
46
51
```bash
47
52
sudo apt-get install cuda-cupti-xx-x
48
53
```
@@ -54,7 +59,7 @@ Alternatively, if you do not have root access on your machine, you can use `cond
54
59
```
55
60
After installing CUPTI, add `$CONDA_HOME/extras/CUPTI/lib64/` to `LD_LIBRARY_PATH` to ensure the library is linked.
56
61
57
-
### 2. Install Habitat
62
+
### 2. Install DeepView.Predict
58
63
59
64
You can install via pip if you have the following versions of CUDA and Python
60
65
@@ -77,12 +82,12 @@ For example, if you are using CUDA 10.2 and Python 3.7):
If you do not find matching version of CUDA and Python above, you need to build Habitat from source with the following instructions
85
+
If you do not find matching version of CUDA and Python above, you need to build DeepView.Predict from source with the following instructions
81
86
82
87
### Installing from source
83
88
84
89
1. Install CMake 3.17+.
85
-
- Note that CMake 3.24.0 and 3.24.1 has a bug that breaks Habitat as it is not able to find the CUPTI directory and you should not use those versions
90
+
- Note that CMake 3.24.0 and 3.24.1 has a bug that breaks DeepView.Predict as it is not able to find the CUPTI directory and you should not use those versions
4. Get the pre-trained models used by DeepView.Predict
111
116
112
117
```bash
113
118
git submodule init && git submodule update
114
119
git lfs pull
115
120
```
116
121
117
-
5. Finally build habitat with the following command
122
+
5. Finally build DeepView.Predict with the following command
118
123
119
124
```bash
120
125
./analyzer/install-dev.sh
121
126
```
122
127
123
128
<h2 id="building-with-docker">Building with Docker</h2>
124
129
125
-
Habitat has been tested to work on the latest version of [NVIDIA NGC PyTorch containers](https://catalog.ngc.nvidia.com/orgs/nvidia/containers/pytorch).
130
+
DeepView.Predict has been tested to work on the latest version of [NVIDIA NGC PyTorch containers](https://catalog.ngc.nvidia.com/orgs/nvidia/containers/pytorch).
126
131
127
-
1. To build Habitat with Docker, first run the NGC container where
132
+
1. To build DeepView.Predict with Docker, first run the NGC container where
128
133
```bash
129
134
docker run --gpus all -it --rm nvcr.io/nvidia/pytorch:XX.XX-py3
130
135
```
131
-
2. Inside the container, clone the repository then build and install the Habitat Python package:
136
+
2. Inside the container, clone the repository then build and install DeepView.Predict Python package:
**Note:**Habitat needs access to your GPU's performance counters, which requires special permissions if you are running with a recent driver (418.43 or later). If you encounter a `CUPTI_ERROR_INSUFFICIENT_PRIVILEGES` error when running Habitat, please follow the instructions [here](https://developer.nvidia.com/ERR_NVGPUCTRPERM) and in [issue #5](https://github.com/geoffxy/habitat/issues/5).
142
+
**Note:**DeepView.Predict needs access to your GPU's performance counters, which requires special permissions if you are running with a recent driver (418.43 or later). If you encounter a `CUPTI_ERROR_INSUFFICIENT_PRIVILEGES` error when running DeepView.Predict, please follow the instructions [here](https://developer.nvidia.com/ERR_NVGPUCTRPERM) and in [issue #5](https://github.com/geoffxy/habitat/issues/5).
138
143
139
144
<h2 id="usage-example">Usage example</h2>
140
145
141
-
You can verify your Habitat installation by running the simple usage example:
146
+
You can verify your DeepView.Predict installation by running the simple usage example:
142
147
```python
143
148
# example.py
144
149
import habitat
@@ -166,7 +171,7 @@ print("Predicted time on V100:", pred.run_time_ms)
166
171
python3 example.py
167
172
```
168
173
169
-
See [experiments/run_experiment.py](https://github.com/CentML/habitat/tree/main/experiments) for other examples of Habitat usage.
174
+
See [experiments/run_experiment.py](https://github.com/CentML/DeepView.Predict/tree/main/experiments) for other examples of Habitat usage.
170
175
171
176
<h2 id="release-history">Release History</h2>
172
177
@@ -195,11 +200,11 @@ more information.
195
200
196
201
<h2 id="paper">Research Paper</h2>
197
202
198
-
Habitat began as a research project in the [EcoSystem Group](https://www.cs.toronto.edu/ecosystem) at the [University of Toronto](https://cs.toronto.edu). The accompanying research paper appeared in the proceedings of [USENIX
203
+
DeepView.Profile began as a research project in the [EcoSystem Group](https://www.cs.toronto.edu/ecosystem) at the [University of Toronto](https://cs.toronto.edu). The accompanying research paper appeared in the proceedings of [USENIX
199
204
ATC'21](https://www.usenix.org/conference/atc21/presentation/yu). If you are
200
205
interested, you can read a preprint of the paper [here](https://arxiv.org/abs/2102.00527).
201
206
202
-
If you use Habitatin your research, please consider citing our paper:
207
+
If you use DeepView.Profilein your research, please consider citing our paper:
0 commit comments