https://github.com/sisl/ngsim.jl
A Julia package for handling the Next Generation Simulation (NGSIM) traffic dataset
https://github.com/sisl/ngsim.jl
Last synced: 9 months ago
JSON representation
A Julia package for handling the Next Generation Simulation (NGSIM) traffic dataset
- Host: GitHub
- URL: https://github.com/sisl/ngsim.jl
- Owner: sisl
- License: other
- Created: 2016-05-03T21:01:27.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2019-11-07T13:01:29.000Z (over 6 years ago)
- Last Synced: 2024-10-31T07:42:56.578Z (over 1 year ago)
- Language: Jupyter Notebook
- Size: 2.52 MB
- Stars: 36
- Watchers: 4
- Forks: 28
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# NGSIM.jl
A Julia package for working with the Next Generation Simulation dataset (NGSIM).
Was tested on the [Highway 101](http://www.fhwa.dot.gov/publications/research/operations/07030/) and [I-80](http://www.fhwa.dot.gov/publications/research/operations/06137/) datasets.
[](https://travis-ci.org/sisl/NGSIM.jl)
[](https://coveralls.io/github/sisl/NGSIM.jl?branch=master)
This package is fully compatible with [AutomotiveDrivingModels.jl](https://github.com/sisl/AutomotiveDrivingModels.jl), providing the `Roadway` and `Trajdata` types from the NGSIM data. Roadway geometry was extracted from the NGSIM CAD files. The vehicle trajectories were filtered to provide better global positions and orientation.
The NGSIM trajectory data is available in [our first release, with instructions here](https://github.com/tawheeler/NGSIM.jl/releases).
## Git It
You just clone it! Note that you also have to clone my [Vec](https://github.com/tawheeler/Vec.jl) package.
```julia
using Pkg
Pkg.add(PackageSpec(url="https://github.com/sisl/Vec.jl"))
Pkg.add(PackageSpec(url="https://github.com/sisl/Records.jl"))
Pkg.add(PackageSpec(url="https://github.com/sisl/AutomotiveDrivingModels.jl"))
Pkg.add(PackageSpec(url="https://github.com/sisl/AutoViz.jl"))
Pkg.add(PackageSpec(url="https://github.com/sisl/NGSIM.jl"))
```
The data must also be downloaded as described above or below.
# Quickstart
To download the datasets, register for an [account](https://www.its-rde.net/index.php/about/register), navigate to the datasets [page](https://www.its-rde.net/index.php/rdedataenvironment/10023), select the links for the I-80 and US-101 datasets, and download. Alternatively, download the data associated with the first release as mentioned above.
To extract trajectory data (Trajdata) from the raw NGSIM data, place the raw data files in the NGSIM.jl/data directory, and run
```julia
using NGSIM
convert_raw_ngsim_to_trajdatas()
```
The resulting files can then be loaded into a Julia program as Trajdata, a type defined in [AutomotiveDrivingModels.jl](https://github.com/sisl/AutomotiveDrivingModels.jl). See jnotebooks/Demo.ipynb for example usage.