abstreet/docs/TODO_logistic.md

TODO - Project logistics

• enable more clippy lints

• enforce consistent style (derive order, struct initialization order)

• cross-platform builds

• document map model

  • diagram of data sources and stages
  • explanation of intermediate formats
  • autogenerate diagrams of the data schemas
  • list invariants

• update with mission statement (democratized urb p, that quote, refashion existing space cheaply)

• trailer

  • show common parts of routes in A/B, point of divergence
  • "Two parallel universes sit at your fingertips, and with the flick of a key, you can glide between the two. Buses jumping past traffic in one world, snarly traffic jam in the other. An A/B test revealing what currently is, and what could be, compared meticulously and deterministically. A/B Street -- which world do you prefer?"

Stability

• test results per git commit

  • https://github.com/spotify/git-test
  • way to view later
  • also could be benchmarks; just arbitrary data over time
  • also screenshots

• things fixed-pt should solve

  • determinism tests failing
  • polyline intersection() finding a line hit, but then failing on get_slice_ending_at

• improve test code and explore problems

  • big timestep, does follow error blow up?
  • alternative to scenario is a sequence of commands for tests
    • spawning code is becoming a BIG mess
  • more tests: bikes, cars, peds starting/ending at borders

• layered invariants

  • first: all the maps fully convert and display in some form; all tests pass or are disabled
  • eventually: every intersection has at least a turn, minimum lengths enforced, etc

Current major geometry problems

• sketchy geometry code that's probably wrong

  • dist along of pt in line. can we just use the t value directly?

• bad shifted polylines on 45th st in 23rd map