Skip to content
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

feat(autoware_pointcloud_preprocessor): update the readme file and schema file #10193

Open
wants to merge 8 commits into
base: main
Choose a base branch
from

Conversation

vish0012
Copy link
Contributor

Description

Implement the ROS Node configuration layout described in https://github.com/orgs/autowarefoundation/discussions/3371 for the autoware_pointcloud_preprocessor package.

  • update json schema
  • update readme file

Related links

Parent Issue:

  • Link

How was this PR tested?

  • colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release --packages-up-to autoware_pointcloud_preprocessor
  • ros2 launch launch/autoware_pointcloud_preprocessor.launch.xml

Notes for reviewers

None.

Interface changes

None.

Effects on system behavior

None.

…hema file

Signed-off-by: vish0012 <vishalchhn42@gmail.com>
@github-actions github-actions bot added type:documentation Creating or refining documentation. (auto-assigned) component:sensing Data acquisition from sensors, drivers, preprocessing. (auto-assigned) labels Feb 25, 2025
Copy link

github-actions bot commented Feb 25, 2025

Thank you for contributing to the Autoware project!

🚧 If your pull request is in progress, switch it to draft mode.

Please ensure:

@vividf vividf added the run:deploy-docs Mark for deploy-docs action generation. (used-by-ci) label Feb 25, 2025
@ambroise-arm
Copy link
Contributor

@vish0012 vish0012 requested a review from mojomex as a code owner March 4, 2025 02:07
@github-actions github-actions bot added the component:perception Advanced sensor data processing and environment understanding. (auto-assigned) label Mar 4, 2025
Copy link
Contributor

@mojomex mojomex left a comment

Choose a reason for hiding this comment

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

Thank you for the PR! A few of the schemas seem to have the wrong structure at the bottom (ROS 2 is expecting a namespace like /** as the schema root). I added a few other minor comments too.

You can always check the rendered documentation here: https://autowarefoundation.github.io/autoware.universe/pr-10193/sensing/autoware_pointcloud_preprocessor/

"description": "enable dust diagnostic",
"default": "false"
"description": "Enable dust diagnostic",
"default": false
Copy link
Contributor

Choose a reason for hiding this comment

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

Some IDEs or plugins interpret false, 0, null, "" as an empty value and auto-fill these fields as in param files. (The VS Code YAML plugin is one such offender)

Thus, please keep quotes around values like the ones mentioned above.

"exclusiveMinimum": 0.0
"description": "Voxel size along the x-axis [m].",
"default": 1.0,
"minimum": 0.0
Copy link
Contributor

Choose a reason for hiding this comment

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

0.0 should stay eclusiveMinimum, right? A voxel size of 0 is not valid as far as I'm aware.

Comment on lines +48 to 53
"ros__parameters": {
"$ref": "#/definitions/passthrough_filter_uint16_node"
}
},
"required": ["/**"],
"required": ["ros__parameters"],
"additionalProperties": false
Copy link
Contributor

Choose a reason for hiding this comment

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

This should stay the same as before, otherwise it will not be read correctly by ROS or the markdown generator.

Comment on lines +33 to +37
"ros__parameters": {
"$ref": "#/definitions/pickup_based_voxel_grid_downsample_filter_node"
}
},
"required": ["/**"],
"required": ["ros__parameters"],
Copy link
Contributor

Choose a reason for hiding this comment

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

This should stay the same as before, otherwise it will not be read correctly by ROS or the markdown generator.

Comment on lines +46 to +62
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/approximate_downsample_filter_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/blockage_diag_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/concatenate_pointclouds.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/crop_box_filter_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/distortion_corrector_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/dual_return_outlier_filter_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/lanelet2_map_Filter_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/passthrough_filter_uint16_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/pickup_based_voxel_grid_downsample_filter_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/pointcloud_accumulator_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/radius_search_2d_outlier_filter_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/random_downsample_filter_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/ring_outlier_filter_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/time_synchronizer_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/vector_map_inside_area_filter_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/voxel_grid_downsample_filter_node.schema.json") }}
{{ json_to_markdown("sensing/autoware_pointcloud_preprocessor/schema/voxel_grid_outlier_filter_node.schema.json") }}
Copy link
Contributor

Choose a reason for hiding this comment

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

As the linked pages (lines 19-27) already contain parameter tables, the parameters section can be removed entirely.

@vish0012 vish0012 requested a review from mojomex March 5, 2025 02:21
Updated schema as directed. 

Changed 0 -> "0" and false -> "false"
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component:perception Advanced sensor data processing and environment understanding. (auto-assigned) component:sensing Data acquisition from sensors, drivers, preprocessing. (auto-assigned) run:deploy-docs Mark for deploy-docs action generation. (used-by-ci) type:documentation Creating or refining documentation. (auto-assigned)
Projects
Status: To Triage
Development

Successfully merging this pull request may close these issues.

4 participants