|
1 | 1 | <h1 align="center">OdoViz: A 3D Processing and Visualization Tool</h1> |
2 | 2 |
|
3 | 3 | <div align="center"> |
| 4 | + |
| 5 | +[](https://nodejs.org/) |
| 6 | +[](https://reactjs.org/) |
| 7 | +[](https://threejs.org/) |
| 8 | +[](LICENSE) |
| 9 | +[](https://odoviz.cs.nuim.ie/) |
| 10 | + |
4 | 11 | OdoViz is a reactive web-based tool for 3D visualization and processing of autonomous vehicle datasets designed to support common tasks in visual place recognition research. |
| 12 | + |
5 | 13 | </div> |
6 | 14 |
|
| 15 | +<br /> |
| 16 | + |
| 17 | +OdoViz has been published in 2021 IEEE International Intelligent Transportation Systems Conference ([ITSC 2021](https://2021.ieee-itsc.org/)) and is available on IEEE Xplore® [here](https://ieeexplore.ieee.org/document/9564712). If you use this software and/or its code, please cite using |
| 18 | + |
| 19 | +``` |
| 20 | +@INPROCEEDINGS{9564712, |
| 21 | + author={Ramachandran, Saravanabalagi and McDonald, John}, |
| 22 | + booktitle={2021 IEEE International Intelligent Transportation Systems Conference (ITSC)}, |
| 23 | + title={OdoViz: A 3D Odometry Visualization and Processing Tool}, |
| 24 | + year={2021}, |
| 25 | + pages={1391-1398}, |
| 26 | + doi={10.1109/ITSC48978.2021.9564712}} |
| 27 | +``` |
| 28 | + |
| 29 | +The video presentation and tutorials have been made available on YouTube [here](https://www.youtube.com/playlist?list=PLKIavzsN4tuGi1SKDSPss0M8v4zswVEn9) to assist the user in getting to know the system better. OdoViz is open-sourced under the [MIT licence](LICENSE) for the benefit of the wider research community. |
| 30 | + |
7 | 31 | ## Live Demo |
8 | 32 |
|
9 | | -You can access the hosted demo [here](https://odoviz.cs.nuim.ie). |
| 33 | +You can access the hosted instance from the [official website](https://odoviz.cs.nuim.ie), which has been made available for demonstration purposes. You can host your own instance using the instructions given below. |
10 | 34 |
|
11 | 35 | ## Quick Start |
12 | 36 |
|
13 | | -### 1. Clone the repo |
| 37 | +1. Clone the repo |
14 | 38 |
|
15 | | -```sh |
16 | | -git clone https://github.com/robotvisionmu/odoviz.git |
17 | | -cd odoviz |
18 | | -``` |
| 39 | + ```sh |
| 40 | + git clone https://github.com/robotvisionmu/odoviz.git |
| 41 | + cd odoviz |
| 42 | + ``` |
19 | 43 |
|
20 | | -You can then setup and start the server in one of the following methods: |
| 44 | +1. Setup and start the server in one of the following methods: |
21 | 45 |
|
22 | | -- using docker |
23 | | -- using npm/yarn. |
| 46 | + <details> |
| 47 | + <summary>Docker</summary> |
24 | 48 |
|
25 | | -### 2a. Docker |
| 49 | + ```sh |
| 50 | + # Build container |
| 51 | + docker build -t odoviz:latest . |
26 | 52 |
|
27 | | -```sh |
28 | | -# Build container |
29 | | -docker build -t odoviz:latest . |
| 53 | + # Set ODOVIZ_DATA_DIR and execute container |
| 54 | + export ODOVIZ_PORT=3001 ODOVIZ_DATA_DIR=<datasets_dir> |
| 55 | + docker run --rm -d -v $ODOVIZ_DATA_DIR:/data -p $ODOVIZ_PORT:3001 odoviz:latest |
| 56 | + ``` |
30 | 57 |
|
31 | | -# Set DATA_DIR and execute container |
32 | | -export PORT=3001 DATA_DIR=<datasets_dir> |
33 | | -docker run --rm -d -v $DATA_DIR:/data -p $PORT:3001 odoviz:latest |
34 | | -``` |
| 58 | + </details> |
35 | 59 |
|
36 | | -### 2b. Without Docker |
| 60 | + <details> |
| 61 | + <summary>NPM or Yarn</summary> |
37 | 62 |
|
38 | | -```sh |
39 | | -# Install dependencies and build client app |
40 | | -cd client |
41 | | -yarn install |
42 | | -NODE_ENV=production yarn run build |
| 63 | + ```sh |
| 64 | + # Install dependencies and build client app |
| 65 | + cd client |
| 66 | + yarn install |
| 67 | + NODE_ENV=production yarn run build |
43 | 68 |
|
44 | | -# Install dependencies for server |
45 | | -cd .. |
46 | | -yarn install |
| 69 | + # Install dependencies for server |
| 70 | + cd .. |
| 71 | + yarn install |
47 | 72 |
|
48 | | -# Set DATA_DIR and start server |
49 | | -export PORT=3001 DATA_DIR=<datasets_dir> |
50 | | -yarn start |
51 | | -``` |
| 73 | + # Set ODOVIZ_DATA_DIR and start server |
| 74 | + export ODOVIZ_PORT=3001 ODOVIZ_DATA_DIR=<datasets_dir> |
| 75 | + yarn start |
| 76 | + ``` |
| 77 | + |
| 78 | + </details> |
| 79 | + |
| 80 | + Note that the `datasets_dir` is the parent directory containing various datasets. |
| 81 | + |
| 82 | +1. Access the front-end |
| 83 | + |
| 84 | + Once the server is started (using Docker or yarn), you can open http://localhost:3001 and use it. For more details about the client, please refer to the [client README.md](client/README.md) |
| 85 | + |
| 86 | +For general questions and queries, open a new thread in [discussions](https://github.com/robotvisionmu/odoviz/discussions). If the software does not work as intended, please check the existing [issues](https://github.com/robotvisionmu/odoviz/issues) before raising a new issue. [Pull requests](https://github.com/robotvisionmu/odoviz/pulls) are welcome. |
52 | 87 |
|
53 | | -### 3. Accessing the front-end |
| 88 | +## Acknowledgements |
54 | 89 |
|
55 | | -Once the server is started (using Docker or yarn), you can open http://localhost:3001 and use it. Video tutorials have been made available on [YouTube](https://www.youtube.com/playlist?list=PLKIavzsN4tuGi1SKDSPss0M8v4zswVEn9) to assist the user in getting to know the system better. For more details about the client, please refer to the [client README.md](client/README.md) |
| 90 | +This work was supported by [Science Foundation Ireland](https://www.sfi.ie/) grant 13/RC/2094 to [Lero - the Irish Software Research Centre](https://lero.ie/) and grant 16/RI/3399 and [Maynooth University](https://www.maynoothuniversity.ie/). The website and the live instance is hosted by Department of Computer Science, Maynooth University. |
0 commit comments