Spaces:
Paused
Paused
File size: 3,106 Bytes
47cfa83 9cd8f4a f24654e 9cd8f4a 47cfa83 9cd8f4a 47cfa83 9cd8f4a f24654e 9cd8f4a 47cfa83 15a285a |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 |
# Savta Depth - Monocular Depth Estimation OSDS Project
Savta Depth is a collaborative *O*pen *S*ource *D*ata *S*cience project for monocular depth estimation.
Here you will find the code for the project, but also the data, models, pipelines and experiments. This means that the project is easily reproducible on any machine, but also that you can contribute to it as a data scientist.
Have a great idea for how to improve the model? Want to add data and metrics to make it more explainable/fair? We'd love to get your help.
## Contributing Guide
Here we'll list things we want to work on in the project as well as ways to start contributing.
If you'd like to take part, please follow the guide.
### Setting up your environment to contribute
* To get started, fork the repository on DAGsHub
* Next, clone the repository you just forked by typing the following command in your terminal:
```bash
$ git clone https://dagshub.com/<your-dagshub-username>/SavtaDepth.git
```
* To get your environment up and running docker is the best way to go. We use an instance of [MLWorkspace](https://github.com/ml-tooling/ml-workspace).
* You can Just run the following commands to get it started.
```bash
$ chmod +x run_dev_env.sh
$ ./run_dev_env.sh
```
* Open localhost:8080 to see the workspace you have created. You will be asked for a token – enter `dagshub_savta`
* In the top right you have a menu called `Open Tool`. Click that button and choose terminal (alternatively open VSCode and open terminal there) and type in the following commands to install a virtualenv and dependencies:
```bash
$ make env
$ conda activate savta_depth
$ make requirements
```
**Note**: If you don't have a GPU you will need to install pytorch separately and then run make requirements. You can install pytorch for computers without a gpu with the following command:
```bash
$ conda install pytorch torchvision cpuonly -c pytorch
```
* Pull the dvc files to your workspace by typing:
```bash
$ dvc checkout #use this to get the data, models etc
```
**Note**: You might need to install and setup the tools to pull from a remote. Read more in [this guide](https://dagshub.com/docs/getting-started/set-up-remote-storage-for-data-and-models/) on how to setup Google Storage or AWS S3 access.
* After you are finished your modification, make sure to do the following:
* Freeze your virtualenv by typing in the terminal:
```bash
pip freeze > requirements.txt
```
* Push your code to DAGsHub, and your dvc managed files to your dvc remote. In order to setup a dvc remote please refer to [this guide](https://dagshub.com/docs/getting-started/set-up-remote-storage-for-data-and-models/).
* Create a Pull Request on DAGsHub!
* 🐶
### TODO:
- [ ] Web UI
- [ ] Testing various datasets as basis for training
- [ ] Testing various models for the data
- [ ] Adding qualitative tests for model performance (visually comparing 3d image outputs)
|