Skip to content

Add a Persons option category to the sumo help output - #18424

Open
NearCai wants to merge 3 commits into
eclipse-sumo:mainfrom
NearCai:pr/persons-category
Open

NearCai wants to merge 3 commits into
eclipse-sumo:mainfrom
NearCai:pr/persons-category

Conversation

@NearCai

@NearCai NearCai commented Oct 25, 2026 •

Copy link
Copy Markdown
Contributor

Fixes #6374.

Person-related simulation options were spread over the generic Output, Processing
and Routing help sections. Following the review discussion, the new Persons
category contains only non-output person options:

max-num-persons, time-to-teleport.ride, pedestrian.* (the pedestrian model
options that were previously in Processing) and all persontrip.* options, plus
ride.stop-tolerance.

The person output options (person-fcd-output, person-summary-output,
personinfo-output, personroute-output) and save-state.transportables remain in
Output. The JuPedSim WKT/Python output options also remain in Output.

Local verification: built sumo and sumo --help shows a Persons Options:
section with the non-output options, while the person output options are still
listed under Output Options:.

Signed-off-by: dkm <2094657017@qq.com>
Copilot AI balanced review requested due to automatic review settings October 25, 2026 09:44

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

@behrisch

Copy link
Copy Markdown
Contributor

I see your point because we are not very consistent here. Sometimes we group by topic (the devices) and sometimes by input/output etc. Still I think it is confusing to change it now. @namdre Opinions?

@namdre

namdre commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

My weak preference is to keep the output-related options in the output category. Putting the others into a new 'Persons' category is fine though. I'd also prefer to move the pedestrian options that are now in 'Processing' to the new category.

Keep the person output options in Output, but move the non-output person
options and the pedestrian model options from Processing to the new
Persons category. This follows the review discussion on the category
layout.

Fixes eclipse-sumo#6374
@NearCai
NearCai force-pushed the pr/persons-category branch from 5e3dce2 to 3d9467c Compare October 29, 2026 07:00
@NearCai

NearCai commented Oct 29, 2026

Copy link
Copy Markdown
Contributor Author

Thanks for the guidance. I updated the PR accordingly:

  • kept person-fcd-output, person-summary-output, personinfo-output, personroute-output and save-state.transportables in Output
  • kept non-output person options (max-num-persons, time-to-teleport.ride, persontrip.*) in the new Persons category
  • moved the pedestrian options that were in Processing (including pedestrian.jupedsim.address) and ride.stop-tolerance to Persons
  • left the JuPedSim WKT/Python output options in Output
  • reverted the unrelated spelling changes

I rebuilt locally and sumo --help shows the expected Persons Options: section. Please let me know if this is the grouping you had in mind.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

add simulation option category 'persons'

4 participants