Skip to content

Commit fc3a994

Browse files
committed
doc: Replace parameter tables to JSON Schema ones in README
Signed-off-by: Motsu-san <masahiro.sakamoto@tier4.jp>
1 parent e9c74e2 commit fc3a994

File tree

1 file changed

+7
-39
lines changed

1 file changed

+7
-39
lines changed

localization/ekf_localizer/README.md

+7-39
Original file line numberDiff line numberDiff line change
@@ -78,65 +78,33 @@ The parameters are set in `launch/ekf_localizer.launch` .
7878

7979
### For Node
8080

81-
| Name | Type | Description | Default value |
82-
| :------------------------- | :----- | :---------------------------------------------------------------------------------------- | :------------ |
83-
| show_debug_info | bool | Flag to display debug info | false |
84-
| predict_frequency | double | Frequency for filtering and publishing [Hz] | 50.0 |
85-
| tf_rate | double | Frequency for tf broadcasting [Hz] | 10.0 |
86-
| publish_tf | bool | Whether to publish tf | true |
87-
| extend_state_step | int | Max delay step which can be dealt with in EKF. Large number increases computational cost. | 50 |
88-
| enable_yaw_bias_estimation | bool | Flag to enable yaw bias estimation | true |
81+
{{ json_to_markdown("localization/ekf_localizer/schema/subschema/node.subschema.json") }}
8982

9083
### For pose measurement
9184

92-
| Name | Type | Description | Default value |
93-
| :---------------------------- | :----- | :------------------------------------------------------------ | :------------ |
94-
| pose_additional_delay | double | Additional delay time for pose measurement [s] | 0.0 |
95-
| pose_measure_uncertainty_time | double | Measured time uncertainty used for covariance calculation [s] | 0.01 |
96-
| pose_smoothing_steps | int | A value for smoothing steps | 5 |
97-
| pose_gate_dist | double | Limit of Mahalanobis distance used for outliers detection | 10000.0 |
85+
{{ json_to_markdown("localization/ekf_localizer/schema/subschema/pose_measurement.subschema.json") }}
9886

9987
### For twist measurement
10088

101-
| Name | Type | Description | Default value |
102-
| :--------------------- | :----- | :-------------------------------------------------------- | :------------ |
103-
| twist_additional_delay | double | Additional delay time for twist [s] | 0.0 |
104-
| twist_smoothing_steps | int | A value for smoothing steps | 2 |
105-
| twist_gate_dist | double | Limit of Mahalanobis distance used for outliers detection | 10000.0 |
89+
{{ json_to_markdown("localization/ekf_localizer/schema/subschema/twist_measurement.subschema.json") }}
10690

10791
### For process noise
10892

109-
| Name | Type | Description | Default value |
110-
| :--------------------- | :----- | :--------------------------------------------------------------------------------------------------------------- | :------------ |
111-
| proc_stddev_vx_c | double | Standard deviation of process noise in time differentiation expression of linear velocity x, noise for d_vx = 0 | 2.0 |
112-
| proc_stddev_wz_c | double | Standard deviation of process noise in time differentiation expression of angular velocity z, noise for d_wz = 0 | 0.2 |
113-
| proc_stddev_yaw_c | double | Standard deviation of process noise in time differentiation expression of yaw, noise for d_yaw = omega | 0.005 |
114-
| proc_stddev_yaw_bias_c | double | Standard deviation of process noise in time differentiation expression of yaw_bias, noise for d_yaw_bias = 0 | 0.001 |
93+
{{ json_to_markdown("localization/ekf_localizer/schema/subschema/process_noise.subschema.json") }}
11594

11695
note: process noise for positions x & y are calculated automatically from nonlinear dynamics.
11796

11897
### Simple 1D Filter Parameters
11998

120-
| Name | Type | Description | Default value |
121-
| :-------------------- | :----- | :---------------------------------------------- | :------------ |
122-
| z_filter_proc_dev | double | Simple1DFilter - Z filter process deviation | 1.0 |
123-
| roll_filter_proc_dev | double | Simple1DFilter - Roll filter process deviation | 0.01 |
124-
| pitch_filter_proc_dev | double | Simple1DFilter - Pitch filter process deviation | 0.01 |
99+
{{ json_to_markdown("localization/ekf_localizer/schema/subschema/simple_1d_filter_parameters.subschema.json") }}
125100

126101
### For diagnostics
127102

128-
| Name | Type | Description | Default value |
129-
| :------------------------------------ | :----- | :----------------------------------------------------------------------------------------------------------------------------------------- | :------------ |
130-
| pose_no_update_count_threshold_warn | size_t | The threshold at which a WARN state is triggered due to the Pose Topic update not happening continuously for a certain number of times. | 50 |
131-
| pose_no_update_count_threshold_error | size_t | The threshold at which an ERROR state is triggered due to the Pose Topic update not happening continuously for a certain number of times. | 250 |
132-
| twist_no_update_count_threshold_warn | size_t | The threshold at which a WARN state is triggered due to the Twist Topic update not happening continuously for a certain number of times. | 50 |
133-
| twist_no_update_count_threshold_error | size_t | The threshold at which an ERROR state is triggered due to the Twist Topic update not happening continuously for a certain number of times. | 250 |
103+
{{ json_to_markdown("localization/ekf_localizer/schema/subschema/diagnostics.subschema.json") }}
134104

135105
### Misc
136106

137-
| Name | Type | Description | Default value |
138-
| :-------------------------------- | :----- | :------------------------------------------------------------------------------------------------- | :------------- |
139-
| threshold_observable_velocity_mps | double | Minimum value for velocity that will be used for EKF. Mainly used for dead zone in velocity sensor | 0.0 (disabled) |
107+
{{ json_to_markdown("localization/ekf_localizer/schema/subschema/misc.subschema.json") }}
140108

141109
## How to tune EKF parameters
142110

0 commit comments

Comments
 (0)