Skip to content

Commit 7feac12

Browse files
Add citation text and paper link
1 parent 015ae9f commit 7feac12

File tree

4 files changed

+110
-36
lines changed

4 files changed

+110
-36
lines changed

README.md

Lines changed: 67 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,55 +1,90 @@
11
<h1 align="center">OdoViz: A 3D Processing and Visualization Tool</h1>
22

33
<div align="center">
4+
5+
[![Node.js](https://img.shields.io/badge/-Node.js-gray?logo=node.js)](https://nodejs.org/)
6+
[![React](https://img.shields.io/badge/-React-gray?logo=react)](https://reactjs.org/)
7+
[![Three.js](https://img.shields.io/badge/-Three.js-gray?logo=three.js)](https://threejs.org/)
8+
[![Licence](https://img.shields.io/badge/Licence-MIT-292)](LICENSE)
9+
[![Website](https://img.shields.io/badge/Website-odoviz.cs.nuim.ie-blue)](https://odoviz.cs.nuim.ie/)
10+
411
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+
513
</div>
614

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+
731
## Live Demo
832

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.
1034

1135
## Quick Start
1236

13-
### 1. Clone the repo
37+
1. Clone the repo
1438

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+
```
1943

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:
2145

22-
- using docker
23-
- using npm/yarn.
46+
<details>
47+
<summary>Docker</summary>
2448

25-
### 2a. Docker
49+
```sh
50+
# Build container
51+
docker build -t odoviz:latest .
2652

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+
```
3057

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>
3559

36-
### 2b. Without Docker
60+
<details>
61+
<summary>NPM or Yarn</summary>
3762

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
4368

44-
# Install dependencies for server
45-
cd ..
46-
yarn install
69+
# Install dependencies for server
70+
cd ..
71+
yarn install
4772

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.
5287

53-
### 3. Accessing the front-end
88+
## Acknowledgements
5489

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.

client/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "odoviz-react-client",
3-
"version": "1.0.1",
3+
"version": "1.0.2",
44
"license": "MIT",
55
"repository": "https://github.com/robotvisionmu/odoviz/tree/main/client",
66
"author": "Saravanabalagi Ramachandran <saravanabalagi@hotmail.com>",

client/src/extensions/about/about.js

Lines changed: 41 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
import React, { Component } from 'react';
22

33
import { faGithub } from '@fortawesome/free-brands-svg-icons';
4-
import { faHeart, faCode } from '@fortawesome/free-solid-svg-icons';
4+
import { faHeart, faCode, faStickyNote } from '@fortawesome/free-solid-svg-icons';
55
import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';
66
import { Grid, Link, Tooltip } from '@material-ui/core';
77

@@ -25,7 +25,25 @@ class About extends Component {
2525
} else return 'unknown';
2626
};
2727

28+
copyCitation = () => {
29+
const text = `@INPROCEEDINGS{9564712,
30+
author={Ramachandran, Saravanabalagi and McDonald, John},
31+
booktitle={2021 IEEE International Intelligent Transportation Systems Conference (ITSC)},
32+
title={OdoViz: A 3D Odometry Visualization and Processing Tool},
33+
year={2021},
34+
pages={1391-1398},
35+
doi={10.1109/ITSC48978.2021.9564712}}`;
36+
const textBox = document.createElement('textarea');
37+
textBox.innerHTML = text;
38+
document.body.appendChild(textBox);
39+
textBox.select();
40+
const result = document.execCommand('copy');
41+
document.body.removeChild(textBox);
42+
return result;
43+
};
44+
2845
render() {
46+
const paperLink = 'https://ieeexplore.ieee.org/document/9564712';
2947
return (
3048
<div className="about">
3149
<Grid container direction={'column'}>
@@ -36,7 +54,10 @@ class About extends Component {
3654
<Grid item xs>
3755
<Grid container spacing={1} direction="column" className="aboutWrapper">
3856
<Grid item>
39-
<p>This is an open-source and free to use software.</p>
57+
<p style={{ lineHeight: 1.7 }}>
58+
This is an open-source and free to use software. If you use this software and/or its code, please cite
59+
this paper using link given below.
60+
</p>
4061
</Grid>
4162

4263
<Grid item>
@@ -102,6 +123,24 @@ class About extends Component {
102123
</Grid>
103124
</Grid>
104125

126+
<Grid item>
127+
<Grid container direction="row">
128+
<Grid item xs>
129+
Publication
130+
</Grid>
131+
<Grid item>
132+
<Link href={paperLink} target="_blank" rel="noopener noreferrer" color="inherit">
133+
<FontAwesomeIcon icon={faStickyNote} color={'#90caf9'} />
134+
<span> ITSC 2021</span>
135+
</Link>
136+
<span> | </span>
137+
<Link href="#" color="inherit" onClick={this.copyCitation} underline="none">
138+
<span class="link">Copy Citation</span>
139+
</Link>
140+
</Grid>
141+
</Grid>
142+
</Grid>
143+
105144
<Grid item>
106145
<p>
107146
This software depends on the following {Object.keys(dependencies).length}

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "odoviz",
3-
"version": "1.0.1",
3+
"version": "1.0.2",
44
"description": "A reactive web-based odometry 3D visualization and processing tool",
55
"repository": "git@github.com:robotvisionmu/odoviz.git",
66
"author": "Saravanabalagi Ramachandran <saravanabalagi@hotmail.com>",

0 commit comments

Comments
 (0)