FollowMe feature#
- event messageolympe.messages.follow_me.boomerang_anim_config(use_default=None, speed=None, distance=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.boomerang_anim_config
Boomerang animation configuration changed. This should only be taken in account if arg animation in
state()
is equal to boomerang. This message has been deprecated. Please use the animation feature.- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.boomerang_configure_param
, u8)) –speed (float) – The speed of the anim in m/s
distance (float) – Distance that will be made by the product to reach its return point in m
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.boomerang_anim_config
Deprecated message
Warning
This message is deprecated and should no longer be used
Triggered by a [start boomerang animation](
helicoid_anim_config()
).
- event messageolympe.messages.follow_me.candle_anim_config(use_default=None, speed=None, vertical_distance=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.candle_anim_config
Candle animation configuration changed. This should only be taken in account if arg animation in
state()
is equal to candle. This message has been deprecated. Please use the animation feature.- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.candle_configure_param
, u8)) –speed (float) – The speed of the anim in m/s
vertical_distance (float) – Distance that will be made by the product to reach the top of the vertical zoom-out in m
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.candle_anim_config
Deprecated message
Warning
This message is deprecated and should no longer be used
Triggered by a [start candle animation](
swing_anim_config()
).
- command messageolympe.messages.follow_me.configure_geographic(use_default, distance, elevation, azimuth, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.configure_geographic
Configure the geographic FollowMe. This should only be taken in account if arg behavior in
state()
is equal to Follow.- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.geo_rel_configure_param
, u8)) –distance (float) – The distance leader-follower in meter Not used when arg start is at 0
elevation (float) – The elevation leader-follower in rad (not used when arg start is at 0)
azimuth (float) – The azimuth north-leader-follower in rad (not used when arg start is at 0)
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.configure_geographic
Result: Event [Geographic config](
geographic_config()
) is sent and drone will move to respect the configuration.Expectations:
geographic_config(use_default=self.use_default, _policy='wait')
- command messageolympe.messages.follow_me.configure_leash(use_default, distance, elevation, azimuth, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.configure_leash
Configure the leash mode of FollowMe. This should only be taken in account if arg behavior in
state()
is equal to Follow- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.geo_rel_configure_param
, u8)) –distance (float) – The distance leader-follower in meter
elevation (float) – The elevation leader-follower in rad
azimuth (float) – The azimuth north-leader-follower in rad
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.configure_leash
Result: Event [Leash config](
leash_config()
) is sent and drone will move to respect the configuration.
- command messageolympe.messages.follow_me.configure_relative(use_default, distance, elevation, azimuth, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.configure_relative
Configure the relative FollowMe. This should only be taken in account if arg behavior in
state()
is equal to Follow- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.geo_rel_configure_param
, u8)) –distance (float) – The distance leader-follower in meter
elevation (float) – The elevation leader-follower in rad
azimuth (float) – The azimuth north-leader-follower in rad
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.configure_relative
Result: Event [Relative config](
relative_config()
) is sent and drone will move to respect the configuration.
- event messageolympe.messages.follow_me.dolly_slide_anim_config(use_default=None, speed=None, angle=None, horizontal_distance=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.dolly_slide_anim_config
DollySlide animation configuration changed. This should only be taken in account if arg animation in
state()
is equal to dolly_slide. This message has been deprecated. Please use the animation feature.- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.dolly_slide_configure_param
, u8)) –speed (float) – The speed of the anim in m/s
angle (float) – Angle Product-User-Target in rad
horizontal_distance (float) – Distance that will be made by the product to reach its target in m
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.dolly_slide_anim_config
Deprecated message
Warning
This message is deprecated and should no longer be used
Triggered by a [start dolly slide animation](
boomerang_anim_config()
).
- event messageolympe.messages.follow_me.geographic_config(use_default=None, distance=None, elevation=None, azimuth=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.geographic_config
Geographic configuration changed. This event is only valid when arg behavior in
state()
is equal to Follow.- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.geo_rel_configure_param
, u8)) –distance (float) – The distance leader-follower in meter If distance is default, this value is the current drone distance
elevation (float) – The elevation leader-follower in rad If elevation is default, this value is the current leader to drone elevation
azimuth (float) – The azimuth north-leader-follower in rad If azimuth is default, this value is the current leader to drone azimuth
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.geographic_config
Triggered By [start geographic](
start()
) or [configure geographic](configure_geographic()
).
- event messageolympe.messages.follow_me.helicoid_anim_config(use_default=None, speed=None, revolution_nb=None, vertical_distance=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.helicoid_anim_config
Helicoid animation configuration. This should only be taken in account if arg animation in
state()
is equal to helicoid. This message has been deprecated. Please use the animation feature.- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.helicoid_configure_param
, u8)) –speed (float) – The speed of the anim in m/s
revolution_nb (float) – The number of revolution (in turn) Negative value is infinite
vertical_distance (float) – Distance that will be made by the product to reach the top of the helicoid in m
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.helicoid_anim_config
Deprecated message
Warning
This message is deprecated and should no longer be used
Triggered by a [start helicoid animation](
relative_config()
).
- event messageolympe.messages.follow_me.leash_config(use_default=None, distance=None, elevation=None, azimuth=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.leash_config
Leash mode configuration changed. This event is only valid when arg behavior in
state()
is equal to Follow.- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.geo_rel_configure_param
, u8)) –distance (float) – The distance leader-follower in meter If distance is default, this value is the current drone distance
elevation (float) – The elevation leader-follower in rad If elevation is default, this value is the current leader to drone elevation
azimuth (float) – The azimuth course-leader-follower in rad If azimuth is default, this value is the current leader to drone azimuth
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.leash_config
Triggered By [start leash](
start()
) or [configure leash](configure_leash()
).
- event messageolympe.messages.follow_me.mode_info(mode=None, missing_requirements=None, improvements=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.mode_info
FollowMe mode info
- Parameters
mode (
olympe.enums.follow_me.mode
) –missing_requirements (BitfieldOf(
olympe.enums.follow_me.input
, u16)) – List of missing requirements to enter this mode on start. Bit is 0 if the input is missing, 1 if the input is ok. For example, if the first bit is equal to 0, it means that the mode is not available because the drone is not calibrated. If at least one input is missing, drone won’t able to follow the target. It won’t use any fallback eitherimprovements (BitfieldOf(
olympe.enums.follow_me.input
, u16)) – List of inputs that can improve the mode. Bit is 0 if the input is missing, i.e.: the mode can be improved if this input would be fulfilled, 1 if the input is ok. For example, if the first bit is equal to 0, it means that the mode would be improved if the drone would be calibrated. If at least one input is missing, a downgraded mode will be used. See behavior_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Supported by:
- Anafi/AnafiFPV
with an up to date firmware
- AnafiThermal
with an up to date firmware
Triggered When the list of missing requirements or improvments changes
- event messageolympe.messages.follow_me.relative_config(use_default=None, distance=None, elevation=None, azimuth=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.relative_config
Relative configuration changed. This event is only valid when arg behavior in
state()
is equal to Follow.- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.geo_rel_configure_param
, u8)) –distance (float) – The distance leader-follower in meter If distance is default, this value is the current drone distance
elevation (float) – The elevation leader-follower in rad If elevation is default, this value is the current leader to drone elevation
azimuth (float) – The azimuth course-leader-follower in rad If azimuth is default, this value is the current leader to drone azimuth
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.relative_config
Triggered By [start relative](
start()
) or [configure relative](configure_relative()
).
- command messageolympe.messages.follow_me.set_target_is_controller(target_is_controller, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.set_target_is_controller
Tells that the target to follow is the controller and drone can use controller gps sent by [controller_info gps](
gps()
) and barometer data sent by [controller_info barometer](barometer()
) as valid to locate the target.- Parameters
target_is_controller (u8) – Boolean. 1 if the target is the controller, 0 otherwise
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Supported by:
- Anafi/AnafiFPV
with an up to date firmware
- AnafiThermal
with an up to date firmware
Result: The drone sends
target_is_controller()
and may sendstart_dolly_slide_anim()
with updated missing_requirementsExpectations:
target_is_controller(state=self.target_is_controller, _policy='wait')
- command messageolympe.messages.follow_me.start(mode, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.start
Start a FollowMe with all its params set to the default params. Sending this command will stop other running followMe.
- Parameters
mode (
olympe.enums.follow_me.mode
) –_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Supported by:
- Anafi/AnafiFPV
with an up to date firmware
- AnafiThermal
with an up to date firmware
Result: Event
state()
is triggered. Also triggers the event that informs about the current configuration (if there is one) like event [Geographic configuration](geographic_config()
) or [Relative configuration](relative_config()
)Expectations: (
state(mode=self.mode, behavior='look_at', _policy='wait')
|state(mode=self.mode, behavior='follow', _policy='wait')
)
- command messageolympe.messages.follow_me.start_boomerang_anim(use_default, speed, distance, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.start_boomerang_anim
Start a boomerang animation. The boomerang animation enables a zoom- out/zoom-in trajectory while preserving the framing chosen by the user. This message has been deprecated. Please use the animation feature.
- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.boomerang_configure_param
, u8)) –speed (float) – The desired speed of the anim in m/s Not used when speed_is_default is 1 Not used when start is 0
distance (float) – Distance that should be made by the product to reach its return point in m Not used when distance_is_default is 1 Not used when start is 0
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.start_boomerang_anim
Deprecated message
Warning
This message is deprecated and should no longer be used
Result: Animation is started and event
state()
is triggered.Expectations:
state(_policy='wait')
- command messageolympe.messages.follow_me.start_candle_anim(use_default, speed, vertical_distance, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.start_candle_anim
Start a candle animation. The candle animation enables a zoom-in directly on the target followed by a vertical zoom-out. This message has been deprecated. Please use the animation feature.
- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.candle_configure_param
, u8)) –speed (float) – The desired speed of the anim in m/s Not used when speed_is_default is 1 Not used when start is 0
vertical_distance (float) – Distance that should be made by the product to reach the top of the vertical zoom-out in m Not used when verticalDistance_is_default is 1 Not used when start is 0
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.start_candle_anim
Deprecated message
Warning
This message is deprecated and should no longer be used
Result: Animation is started and event
state()
is triggered.Expectations:
state(_policy='wait')
- command messageolympe.messages.follow_me.start_dolly_slide_anim(use_default, speed, angle, horizontal_distance, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.start_dolly_slide_anim
Start a dolly slide animation. Allows the drone to catch up to the target before flying past it, creating a zoom-in/zoom_out effect without a curved path. This message has been deprecated. Please use the animation feature.
- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.dolly_slide_configure_param
, u8)) –speed (float) – The desired speed of the anim in m/s Not used when speed_is_default is 1 Not used when start is 0
angle (float) – Desired angle Product-User-Target in rad Not used when angle_is_default is 1 Not used when start is 0
horizontal_distance (float) – Distance that should be made by the product to reach its target in m Not used when horizontalDistance_is_default is 1 Not used when start is 0
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.start_dolly_slide_anim
Deprecated message
Warning
This message is deprecated and should no longer be used
Result: Animation is started and event
state()
is triggered.Expectations:
state(_policy='wait')
- command messageolympe.messages.follow_me.start_helicoid_anim(use_default, speed, revolution_number, vertical_distance, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.start_helicoid_anim
Start a helicoid animation. The helicoid animation allows the drone to revolve around the target while going up, with a fixed radius. This message has been deprecated. Please use the animation feature.
- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.helicoid_configure_param
, u8)) –speed (float) – The desired speed of the anim in m/s Not used when speed_is_default is 1
revolution_number (float) – The number of revolution (in turn) Negative value is infinite Example: 1.5 makes an entire turn plus half of a turn Not used when revolutionNb_is_default is 1
vertical_distance (float) – Distance that should be made by the product to reach the top of the helicoid in m Not used when verticalDistance_is_default is 1
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.start_helicoid_anim
Deprecated message
Warning
This message is deprecated and should no longer be used
Result: Animation is started and event
state()
is triggered.Expectations:
state(_policy='wait')
- command messageolympe.messages.follow_me.start_swing_anim(use_default, speed, vertical_distance, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.start_swing_anim
Start a swing animation. The swing animation enables a vertical point of view while the drone passes over the target. This message has been deprecated. Please use the animation feature.
- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.swing_configure_param
, u8)) –speed (float) – The desired speed of the anim in m/s Not used when speed_is_default is 1 Not used when start is 0
vertical_distance (float) – Distance that should be made by the product to reach the top of the swing in m Not used when verticalDistance_is_default is 1 Not used when start is 0
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.start_swing_anim
Deprecated message
Warning
This message is deprecated and should no longer be used
Result: Animation is started and event
state()
is triggered.Expectations:
state(_policy='wait')
- event messageolympe.messages.follow_me.state(mode=None, behavior=None, animation=None, animation_available=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.state
State of the FollowMe
- Parameters
mode (
olympe.enums.follow_me.mode
) – Mode asked by userbehavior (
olympe.enums.follow_me.behavior
) – Behavior of the drone according to the asked modeanimation (
olympe.enums.follow_me.animation
) – Current animation. This parameter has been deprecated. Please use the animation feature.animation_available (BitfieldOf(
olympe.enums.follow_me.animation
, u16)) – List of available animations This parameter has been deprecated. Please use the animation feature._policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Supported by:
- Anafi/AnafiFPV
with an up to date firmware
- AnafiThermal
with an up to date firmware
Triggered by any changes on the followme, like
start()
,stop()
, [start helicoid anim](relative_config()
)…
- command messageolympe.messages.follow_me.stop(_timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.stop
Stop current followMe.
- Parameters
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Supported by:
- Anafi/AnafiFPV
with an up to date firmware
- AnafiThermal
with an up to date firmware
Result: Event
state()
is triggered with mode equals to none.Expectations:
state(mode='none', _policy='wait')
- command messageolympe.messages.follow_me.stop_animation(_timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.stop_animation
Stop current followMe animation. This message has been deprecated. Please use the animation feature.
- Parameters
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.stop_animation
Deprecated message
Warning
This message is deprecated and should no longer be used
Result: FollowMe animation will stop. Event
state()
is triggered.Expectations:
state(_policy='wait')
- event messageolympe.messages.follow_me.swing_anim_config(use_default=None, speed=None, vertical_distance=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.swing_anim_config
Swing animation configuration changed. This should only be taken in account if arg animation in
state()
is equal to swing. This message has been deprecated. Please use the animation feature.- Parameters
use_default (BitfieldOf(
olympe.enums.follow_me.swing_configure_param
, u8)) –speed (float) – The speed of the anim in m/s
vertical_distance (float) – Distance that will be made by the product to reach the top of the swing in m
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Unsupported message
Todo
Remove unsupported message follow_me.swing_anim_config
Deprecated message
Warning
This message is deprecated and should no longer be used
Triggered by a [start swing animation](
stop_animation()
).
- command messageolympe.messages.follow_me.target_framing_position(horizontal, vertical, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.target_framing_position
Set the desired target framing in the video.
- Parameters
horizontal (i8) – Horizontal position in the video (in %, from left to right)
vertical (i8) – Vertical position in the video (in %, from bottom to top)
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Supported by:
- Anafi/AnafiFPV
with an up to date firmware
- AnafiThermal
with an up to date firmware
Result: Event [target framing position](
target_framing_position_changed()
) is triggered.Expectations:
target_framing_position_changed(horizontal=self.horizontal, vertical=self.vertical, _policy='wait')
- event messageolympe.messages.follow_me.target_framing_position_changed(horizontal=None, vertical=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.target_framing_position_changed
Desired target framing
- Parameters
horizontal (i8) – Horizontal position in the video (in %, from left to right)
vertical (i8) – Vertical position in the video (in %, from bottom to top)
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Supported by:
- Anafi/AnafiFPV
with an up to date firmware
- AnafiThermal
with an up to date firmware
Triggered by [set target framing](
candle_anim_config()
).
- command messageolympe.messages.follow_me.target_image_detection(target_azimuth, target_elevation, change_of_scale, confidence_index, is_new_selection, timestamp, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#
follow_me.target_image_detection
Send vision detection results.
- Parameters
target_azimuth (float) – Horizontal north-drone-target angle in radian
target_elevation (float) – Vertical angle horizon-drone-target in radian
change_of_scale (float) – Normalized relative radial speed in 1/second
confidence_index (u8) – Confidence index of the detection (from 0 to 255, the highest is the best)
is_new_selection (u8) – Boolean. 1 if the selection is new, 0 otherwise
timestamp (u64) – Acquisition time of processed picture in millisecond
_timeout (int) – command message timeout (defaults to 10)
_no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Supported by:
- Anafi/AnafiFPV
with an up to date firmware
- AnafiThermal
with an up to date firmware
Result: If drone is in FollowMe, is will look at the target according to the chosen [framing position](
target_framing_position_changed()
).Expectations:
target_image_detection_state(_policy='wait')
- event messageolympe.messages.follow_me.target_image_detection_state(state=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.target_image_detection_state
State of the image detection
- Parameters
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Supported by:
- Anafi/AnafiFPV
with an up to date firmware
- AnafiThermal
with an up to date firmware
Triggered By a possible wrong [target image detection](
target_image_detection()
).
- event messageolympe.messages.follow_me.target_is_controller(state=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.target_is_controller
Tells whether the drone is using the controller gps position and barometer to locate the target
- Parameters
state (u8) – Boolean. 1 if the target is the controller, 0 otherwise
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Supported by:
- Anafi/AnafiFPV
with an up to date firmware
- AnafiThermal
with an up to date firmware
Triggered During connection and by
set_target_is_controller()
- event messageolympe.messages.follow_me.target_trajectory(latitude=None, longitude=None, altitude=None, north_speed=None, east_speed=None, down_speed=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#
follow_me.target_trajectory
Target estimated trajectory
- Parameters
latitude (double) – Target latitude (in degrees)
longitude (double) – Target longitude (in degrees)
altitude (float) – Target altitude (in meters, relative to sea level)
north_speed (float) – Target north speed (in m/s)
east_speed (float) – Target east speed (in m/s)
down_speed (float) – Target down speed (in m/s)
_policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)
_float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information
Supported by:
- Anafi/AnafiFPV
with an up to date firmware
- AnafiThermal
with an up to date firmware
Triggered Regularly when a FollowMe is started.
- enumolympe.enums.follow_me.animation#
FollowMe animation type
- none
No animation (0)
- helicoid
Turn around the target (1)
- swing
Pass by the zenith and change of side (2)
- boomerang
Fly far from the target and fly back (3)
- candle
Move to the target and go high when it is near (4)
- dolly_slide
Fly in line (5)
- enumolympe.enums.follow_me.behavior#
FollowMe behavior
- idle
Drone is not moving according to the target This means that at least one required input is missing (0)
- follow
Follow the target (1)
- look_at
Look at the target without moving (2)
- enumolympe.enums.follow_me.boomerang_configure_param#
Boomerang animation configure parameters.
- speed
Speed parameter (0)
- distance
Distance (1)
- enumolympe.enums.follow_me.candle_configure_param#
Candle animation configure parameters.
Enum aliases:
- speed
Speed parameter (0)
- vertical_distance
Follow the target keeping the same vector (1)
- enumolympe.enums.follow_me.dolly_slide_configure_param#
Dolly slide animation configure parameters.
- speed
Speed parameter (0)
- angle
Angle (1)
- horizontal_distance
Horizontal distance (2)
- enumolympe.enums.follow_me.geo_rel_configure_param#
Geographic and Relative follow me configuration parameters
- distance
Distance configuration (0)
- elevation
Elevation configuration (1)
- azimuth
Azimuth configuration (2)
- enumolympe.enums.follow_me.helicoid_configure_param#
Helicoid animation configuration parameters.
- speed
Speed parameter (0)
- revolution_nb
Number of turn (1)
- vertical_distance
Vertical distance (2)
- enumolympe.enums.follow_me.image_detection_status#
State of the image detection
- none
No image detection (0)
- ok
Image detection is considered ok by the drone (1)
- lost
Image detection is considered lost or in contradiction with gps value. This state will remain until a new selection of the target is done (2)
- enumolympe.enums.follow_me.input#
Input values used by the FollowMe
- drone_calibrated
Drone is calibrated (0)
- drone_gps_good_accuracy
Drone gps has fixed and has a good accuracy (1)
- target_gps_good_accuracy
Target gps data is known and has a good accuracy (2)
- target_barometer_ok
Target barometer data is available (3)
- drone_far_enough
Drone is far enough from the target (4)
- drone_high_enough
Drone is high enough from the ground (5)
- image_detection
Target detection is done by image detection among other things (6)
- target_good_speed
Target is at a good speed (7)
- drone_close_enough
Drone is close enough to the target (8)
- enumolympe.enums.follow_me.list_flags#
Arsdk built-in “list_flags” enum that is used to in “LIST_ITEM” event messages
- First
Arsdk built-in “list_flags” enum that is used to in “LIST_ITEM” event messages (0)
- Last
Arsdk built-in “list_flags” enum that is used to in “LIST_ITEM” event messages (1)
- Empty
Arsdk built-in “list_flags” enum that is used to in “LIST_ITEM” event messages (2)
- Remove
Arsdk built-in “list_flags” enum that is used to in “LIST_ITEM” event messages (3)
- enumolympe.enums.follow_me.mode#
FollowMe mode
- none
No follow me (0)
- look_at
Look at the target without moving automatically (1)
- geographic
Follow the target keeping the same vector (2)
- relative
Follow the target keeping the same orientation to its direction (3)
- leash
Follow the target as it was held by a leash (4)
- enumolympe.enums.follow_me.swing_configure_param#
Swing configure parameters.
Enum aliases:
- speed
Speed parameter (0)
- vertical_distance
Vertical distance (1)