generated from MPSLab-ASU/Paper_Page_Template
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
e595077
commit 2f22d5d
Showing
1 changed file
with
3 additions
and
114 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,117 +1,6 @@ | ||
# Paper Page Template | ||
This repo creates a template for an academic paper page. It has been set up so that no HTML coding is required for a paper page. All configuration is done through markdown and yaml files. | ||
|
||
demo: https://mpslab-asu.github.io/Paper_Page_Template/ | ||
# IncidentNet: Traffic Incident Detection, Localization and Severity Estimation with Sparse Sensing | ||
|
||
## Requirements: | ||
You need to use docker and docker-compose to run this project. If you don't have them installed, follow the instructions [here](https://docs.docker.com/compose/install/). | ||
## Abstract | ||
|
||
## Usage: | ||
The files that need to be edited for any paper are: | ||
* [_config.yml](./_config.yml) | ||
* [_data/figures.yml](./_data/figures.yml) | ||
* [_data/authors.yml](./_data/authors.yml) | ||
* [paper_components/abstract.md](./paper_components/abstract.md) | ||
* [paper_components/bibtex_ref.md](./paper_components/bibtex_ref.md) | ||
* [paper_components/description.md](./paper_components/description.md) | ||
|
||
Everything else should generate automatically. | ||
|
||
--- | ||
|
||
## Modifing the template for your paper: | ||
* Any fields that you do not want to use must be commented out in the yaml files. This is done by adding a '#' at the beginning of the line. (Ex: ln 12 in [_config.yml](./_config.yml) which comments out the supplementary_pdf) | ||
|
||
|
||
## YAML Files: | ||
### `_config.yml`: | ||
The [_config.yaml](./_config.yml) file contains all the information about the paper. The only fields that need to be edited are: | ||
|
||
**Paper Information** -> | ||
* **paper_name** : The title of the paper | ||
* **organization** : The organization that the paper is associated with | ||
* **sub_organization** : The department that the paper is associated with | ||
* **preprint** : (Boolean) If the paper is a preprint or not (True/False) | ||
|
||
**Paper Resources** -> | ||
* **paper_pdf** : The path to the pdf of the paper | ||
* **supplementary_pdf** : The path to the supplementary pdf of the paper | ||
* **code** : The path to the code for the paper (preferable GitHub) | ||
* **arXiv** : The path to the arXiv page for the paper | ||
* **IEEE** : The path to the IEEE page for the paper | ||
* **favicon** : The path to the favicon for the paper page | ||
* All favicons must be .ico files. You can convert any image to a .ico file [here](https://cloudconvert.com/png-to-ico) | ||
* Make sure the is in the [assets/images](./assets/images) folder for GitHub pages compatibility | ||
|
||
|
||
### `figures.yml`: | ||
The [_data/figures.yml](./_data/figures.yml) file contains all the information about the figures for the paper. The only fields that need to be edited are: | ||
|
||
* **filename** : The filename of the figure | ||
* The image needs to be in the [assets/images](./assets/images) folder for GitHub pages compatibility. | ||
* jpeg/jpg files must be name .JPG (all caps) for GitHub pages compatibility | ||
* **caption** : The caption for the figure | ||
|
||
|
||
### `authors.yml`: | ||
The [_data/authors.yml](./_data/authors.yml) file contains all the information about the authors for the paper. The format for the file is: | ||
|
||
```yaml | ||
- name: Shail Dave | ||
position: PhD | ||
github: shail-dave | ||
email: [email protected] | ||
linkedin: daveshail | ||
organization: Arizona State University | ||
sub_organization: School of Computing and Augmented Intelligence | ||
google_scholar: https://scholar.google.com/citations?hl=en&user=SVft2R0AAAAJ&view_op=list_works | ||
website: https://sites.google.com/view/shail/ | ||
primary: true | ||
``` | ||
Each of these fields is optional. Any fields that are not used should be removed per author. | ||
#### Additional Notes about author sections: | ||
* The information here shows up on the cards screen when the author named is clicked on. | ||
* The only fields represented on the main page are **name** and **primary**. | ||
* **primary** is meant to indicate major contributors, it shows as "*" on the main page and a badge on the author cards | ||
--- | ||
## Markdown Files: | ||
### `abstract.md` : | ||
You [abstract.md](./paper_components/abstract.md) file should have the abstract for the paper. This is the only file that requires markdown. | ||
|
||
### `bibtex_ref.md` : | ||
The [bibtex_ref.md](./paper_components/bibtex_ref.md) file should have the bibtex reference for the paper. This is the only file that requires markdown. | ||
|
||
### `description.md` : | ||
The [description.md](./paper_components/description.md) file should have the description for the paper or any additional information you want to include. | ||
* This is the only file that requires markdown. | ||
* **Latex Math** is supported in this file. | ||
|
||
|
||
--- | ||
## Hosting the Website: | ||
The web hosting is handled by GitHub Pages. The process is rather straight forward. | ||
|
||
### **Step 1:** Create a Repository or Branch. | ||
* If you the paper **does not have code or a repository**, create a new repository. | ||
* You can use the template option when creating the repo | ||
![](./docs/repo_template.png) | ||
* Edit as per instructions above | ||
<br> | ||
* If you the paper **has a repository**, create a new branch in the repository. Preferable titled "pages" | ||
* Clone the repo and that branch and remove all existing code. | ||
* Copy all files from this repo into the new branch and edit as per instructions above | ||
|
||
### **Step 2:** Start git hosting. | ||
1. Go to the settings page of the repo: | ||
![](./docs/settings.png) | ||
2. Scroll down to the GitHub Pages section and select the branch you want to host from. | ||
![](./docs/settings_list.png) | ||
3. Select the host from branch option and save. | ||
![](./docs/pages.png) | ||
|
||
|
||
## You're Done !!! | ||
Prior art in traffic incident detection relies on high sensor coverage and is primarily based on decision-tree and random forest models that have limited representation capacity and, as a result, cannot detect incidents with high accuracy. This paper presents IncidentNet - a novel approach for classifying, localizing, and estimating the severity of traffic incidents using deep learning models trained on data captured from sparsely placed sensors in urban environments. Our model works on microscopic traffic data that can be collected using cameras installed at traffic intersections. Due to the unavailability of datasets that provide microscopic traffic details and traffic incident details simultaneously, we also present a methodology to generate a synthetic microscopic traffic dataset that matches given macroscopic traffic data. IncidentNet achieves a traffic incident detection rate of 98%, with false alarm rates of less than 7% in 197 seconds on average in urban environments with cameras on less than 20% of the traffic intersections. |