Skip to content

Commit 84a06a8

Browse files
authored
Merge pull request #27 from CentML/review-readme
changed readme
2 parents 66a9745 + c126ecf commit 84a06a8

File tree

1 file changed

+25
-20
lines changed

1 file changed

+25
-20
lines changed

README.md

Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Habitat
1+
# DeepView.Predict
22

33
[![License](https://img.shields.io/badge/license-Apache--2.0-green?style=flat)](https://github.com/CentML/habitat/blob/main/LICENSE)
44
[![Maintainability](https://api.codeclimate.com/v1/badges/fbb68badd0c0599f1843/maintainability)](https://codeclimate.com/github/CentML/DeepView.Predict/maintainability)
@@ -17,11 +17,11 @@ A Runtime-Based Computational Performance Predictor for Deep Neural Network Trai
1717
- [Research paper](#paper)
1818
- [Contributing](#contributing)
1919

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).
2121

2222
<h2 id="installation">Installation</h2>
2323

24-
To run Habitat, you need:
24+
To run DeepView.Predict, you need:
2525
- [Python 3.6+](https://www.python.org/)
2626
- [Pytorch 1.1.0+](https://pytorch.org/)
2727
- A system equiped with an Nvidia GPU with properly configured CUDA
@@ -37,12 +37,17 @@ Currently, we have predictors for the following Nvidia GPUs:
3737
| 2080Ti | Turing | 11 GB | GDDR6 | 68 |
3838
| T4 | Turing | 16 GB | GDDR6 | 40 |
3939
| 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+
4045

4146
<h2 id="building-locally">Building locally</h2>
4247

4348
### 1. Install CUPTI
4449

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:
4651
```bash
4752
sudo apt-get install cuda-cupti-xx-x
4853
```
@@ -54,7 +59,7 @@ Alternatively, if you do not have root access on your machine, you can use `cond
5459
```
5560
After installing CUPTI, add `$CONDA_HOME/extras/CUPTI/lib64/` to `LD_LIBRARY_PATH` to ensure the library is linked.
5661

57-
### 2. Install Habitat
62+
### 2. Install DeepView.Predict
5863

5964
You can install via pip if you have the following versions of CUDA and Python
6065

@@ -77,12 +82,12 @@ For example, if you are using CUDA 10.2 and Python 3.7):
7782
pip install http://centml-releases.s3-website.us-east-2.amazonaws.com/habitat/wheels/habitat_predict-1.0.0-20221123+cu102-py37-none-any.whl
7883
```
7984

80-
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
8186

8287
### Installing from source
8388

8489
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
8691
- [https://gitlab.kitware.com/cmake/cmake/-/merge_requests/7608/diffs](https://gitlab.kitware.com/cmake/cmake/-/merge_requests/7608/diffs)
8792
- Run the following commands to download and install a precompiled version of CMake 3.24.2
8893

@@ -101,44 +106,44 @@ If you do not find matching version of CUDA and Python above, you need to build
101106
```
102107

103108
2. Install [Git Large File Storage](https://git-lfs.github.com/)
104-
3. Clone the Habitat package
109+
3. Clone the DeepView.Predict package
105110

106111
```bash
107-
git clone https://github.com/centml/habitat
112+
git clone https://github.com/CentML/DeepView.Predict
108113
```
109114

110-
4. Get the pre-trained models used by Habitat
115+
4. Get the pre-trained models used by DeepView.Predict
111116

112117
```bash
113118
git submodule init && git submodule update
114119
git lfs pull
115120
```
116121

117-
5. Finally build habitat with the following command
122+
5. Finally build DeepView.Predict with the following command
118123

119124
```bash
120125
./analyzer/install-dev.sh
121126
```
122127

123128
<h2 id="building-with-docker">Building with Docker</h2>
124129

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).
126131

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
128133
```bash
129134
docker run --gpus all -it --rm nvcr.io/nvidia/pytorch:XX.XX-py3
130135
```
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:
132137
```bash
133-
git clone --recursive https://github.com/centml/habitat
138+
git clone --recursive https://github.com/CentML/DeepView.Predict
134139
./habitat/analyzer/install-dev.sh
135140
```
136141

137-
**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).
138143
139144
<h2 id="usage-example">Usage example</h2>
140145
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:
142147
```python
143148
# example.py
144149
import habitat
@@ -166,7 +171,7 @@ print("Predicted time on V100:", pred.run_time_ms)
166171
python3 example.py
167172
```
168173
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.
170175
171176
<h2 id="release-history">Release History</h2>
172177
@@ -195,11 +200,11 @@ more information.
195200
196201
<h2 id="paper">Research Paper</h2>
197202
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
199204
ATC'21](https://www.usenix.org/conference/atc21/presentation/yu). If you are
200205
interested, you can read a preprint of the paper [here](https://arxiv.org/abs/2102.00527).
201206

202-
If you use Habitat in your research, please consider citing our paper:
207+
If you use DeepView.Profile in your research, please consider citing our paper:
203208

204209
```bibtex
205210
@inproceedings{habitat-yu21,

0 commit comments

Comments
 (0)