1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141
|
/*
* Copyright 2021 Open Source Robotics Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
#ifndef SDF_NAVSAT_HH_
#define SDF_NAVSAT_HH_
#include <ignition/utils/ImplPtr.hh>
#include <sdf/Error.hh>
#include <sdf/Element.hh>
#include <sdf/Noise.hh>
#include <sdf/sdf_config.h>
#include <ignition/math/Angle.hh>
namespace sdf
{
// Inline bracket to help doxygen filtering.
inline namespace SDF_VERSION_NAMESPACE {
//
/// \brief NavSat contains information about a NavSat sensor.
/// This sensor can be attached to a link. The NavSat sensor can be defined
/// SDF XML by the "navsat" type.
///
/// # Example SDF XML using navsat type:
///
/// ~~~{.xml}
/// <sensor name="navsat_sensor" type="navsat">
/// <pose>1 2 3 0 0 0</pose>
/// <topic>/navsat</topic>
/// <navsat>
/// <position_sensing>
/// <horizontal>
/// <noise type="gaussian">
/// <mean>0.98</mean>
/// <stddev>0.76</stddev>
/// </noise>
/// </horizontal>
/// <vertical>
/// <noise type="gaussian">
/// <mean>0.98</mean>
/// <stddev>0.76</stddev>
/// </noise>
/// </vertical>
/// </position_sensing>
/// <velocity_sensing>
/// <horizontal>
/// <noise type="gaussian">
/// <mean>0.98</mean>
/// <stddev>0.76</stddev>
/// </noise>
/// </horizontal>
/// <vertical>
/// <noise type="gaussian">
/// <mean>0.98</mean>
/// <stddev>0.76</stddev>
/// </noise>
/// </vertical>
/// </velocity_sensing>
/// </navsat>
/// </sensor>
/// ~~~
class SDFORMAT_VISIBLE NavSat
{
/// \brief Default constructor
public: NavSat();
/// \brief Load the navsat based on an element pointer. This is *not*
/// the usual entry point. Typical usage of the SDF DOM is through the Root
/// object.
/// \param[in] _sdf The SDF Element pointer
/// \return Errors, which is a vector of Error objects. Each Error includes
/// an error code and message. An empty vector indicates no error.
public: Errors Load(ElementPtr _sdf);
/// \brief Get a pointer to the SDF element that was used during
/// load.
/// \return SDF element pointer. The value will be nullptr if Load has
/// not been called.
public: sdf::ElementPtr Element() const;
/// \brief Set the noise values for the horizontal position sensor
/// \param[in] _noise Noise values to set to
public: void SetHorizontalPositionNoise(const Noise &_noise);
/// \brief Get noise value for horizontal position sensor
/// \return Noise values
public: const Noise &HorizontalPositionNoise() const;
/// \brief Set the noise values for the vertical position sensor
/// \param[in] _noise Noise values to set to
public: void SetVerticalPositionNoise(const Noise &_noise);
/// \brief Get noise value for vertical position sensor
/// \return Noise values
public: const Noise &VerticalPositionNoise() const;
/// \brief Set the noise values for the horizontal velocity sensor
/// \param[in] _noise Noise values to set to
public: void SetHorizontalVelocityNoise(const Noise &_noise);
/// \brief Get noise value for horizontal velocity sensor
/// \return Noise values
public: const Noise &HorizontalVelocityNoise() const;
/// \brief Set the noise values for the vertical velocity sensor
/// \param[in] _noise Noise values to set to
public: void SetVerticalVelocityNoise(const Noise &_noise);
/// \brief Get noise value for vertical velocity sensor
/// \return Noise values
public: const Noise &VerticalVelocityNoise() const;
/// \brief Return true if both NavSat objects contain the same values.
/// \param[_in] _navsat NavSat value to compare.
/// \return True if 'this' == _navsat.
public: bool operator==(const NavSat &_navsat) const;
/// \brief Return true this NavSat object does not contain the same
/// values as the passed in parameter.
/// \param[_in] _navsat NavSat value to compare.
/// \return True if 'this' != _navsat.
public: bool operator!=(const NavSat &_navsat) const;
/// \brief Private data pointer.
IGN_UTILS_IMPL_PTR(dataPtr)
};
}
}
#endif
|