Skip to content

[do not merge] Params Class Tutorial #665

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 12 commits into
base: master
Choose a base branch
from

Conversation

albenbagabaldo
Copy link
Member

Pull request information

Description

This tutorial walks you through the use of different parameters within the classes. Understanding how these classes work is fundamental in designing your own scenarios in Flow.

The classes featured in this tutorial are InitialConfig,SumoCarFollowingParams, SumoParams and EnvParams. Each of these classes is detailed on their corresponding sections in this tutorial.

This tutorial uses the classical Sugiyama experiment involving a loop (ring road) with a single lane and a fixed number of vehicles on it, similar to Tutorial 01. This one though focuses on the use of the parameters in the classes.

This tutorial is divided into four (4) sections and is organized as follows:

  1. InitialConfig
  2. SumoCarFollowingParams
  3. SumoParams
  4. EnvParams

## Pull request information

- *Status*: In development
- *Kind of changes*: Additional tutorial
- *Related PR or issue*: resolves issue #206

## Description

This tutorial walks you through the use of different parameters within the classes. Understanding how these classes work is fundamental in designing your own scenarios in Flow. 

The classes featured in this tutorial are `InitialConfig`,`SumoCarFollowingParams`, `SumoParams` and `EnvParams`. Each of these classes is detailed on their corresponding sections in this tutorial.

This tutorial uses the classical Sugiyama experiment involving a loop (ring road) with a single lane and a fixed number of vehicles on it, similar to Tutorial 01. This one though focuses on the use of the parameters in the classes.

### This tutorial is divided into four (4) sections and is organized as follows:

1. `InitialConfig`
2. `SumoCarFollowingParams`
3. `SumoParams`
4. `EnvParams`
@coveralls
Copy link

coveralls commented Jul 23, 2019

Pull Request Test Coverage Report for Build 4347

  • 0 of 0 changed or added relevant lines in 0 files are covered.
  • 1 unchanged line in 1 file lost coverage.
  • Overall coverage decreased (-0.01%) to 91.954%

Files with Coverage Reduction New Missed Lines %
flow/envs/loop/loop_accel.py 1 98.08%
Totals Coverage Status
Change from base Build 4341: -0.01%
Covered Lines: 9177
Relevant Lines: 9980

💛 - Coveralls

@nathanlct
Copy link
Collaborator

I tried to work on section 1. But with InitialConfig, even simple things like spacing="random" or spacing="uniform" with perturbation=5 crash.. Also 3 parameters of the class are marked #TODO remove, and for parameters such as x0 or bunching, I don't really know if they should be given in edge length (specify_edges) or edge positions (specify_edge_starts)..

Copy link
Member

@AboudyKreidieh AboudyKreidieh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Alright, a few comments:

  • The sections are inconsistent right now. Let's have each section be of the form: description - list of parameters - example usage
  • Some parameters are missing, e.g. VehicleParams, SumoLaneChangeParams, etc... Can you add them?
  • Can you be specific about the TODO? What's wrong, and can we fix it?

Once these are resolved I'll make a next pass.

This is the version of the tutorial where I tried to address the comments given. Please review/make necessary changes/revert back to me for further editing. Thank you!
The version of the tutorial where the first set of comments are addressed. Please review/ feel free to edit/revert back to me if major changes shall be made. Thank you!
Please review/feel free to edit/revert back to me if major changes are needed. Thank you!
@AboudyKreidieh
Copy link
Member

@albenbagabaldo I added some widgets to the InitialConfig aspect of the tutorial that look like this:

Selection_063

Before we continue with the rest of the tutorial can you set up the cell with the widgets to start a simulation (when a button is pressed) with the initial_config parameters specified by the widgets?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants