Robot-Specific Python

Introduction

The V5RC 21-22 Tipping Point Playground features methods exclusive to the build designed for this Playground, including two motor options, AI Vision Sensor, Optical Sensor, and Game Positioning System (GPS) Sensor.

All standard VEXcode VR methods are available for use in the V5RC 21-22 Tipping Point Playground.

Below is a list of all available Playground-specific methods:

Motion – Move and track the robot’s motors.

• Actions

  • spin – Spins the selected motor or motor group indefinitely.

  • spin_for – Spins a motor or group for a specific distance in degrees or turns.

  • spin_to_position – Spins a motor or motor group to a set position.

  • stop – Stops a specific motor or motor group from spinning.

• Mutators

  • set_position – Sets the encoder value of a motor or motor group.

  • set_velocity – Sets the speed of a motor or motor group as a percentage.

  • set_timeout – Limits how long a motor block waits before giving up if movement is blocked.

• Getters

  • is_done – Returns a Boolean indicating whether the motor is no longer spinning.

  • is_spinning – Returns a Boolean indicating whether the motor is currently spinning.

  • position – Returns the motor’s current rotational position in degrees or turns.

  • velocity – Returns the motor’s current velocity in % or rpm.

Sensing - Utilize the robot’s various sensors.

• Optical

  • is_near_object – Returns whether a detected object is near the Optical Sensor.

  • color – Returns the color detected from the Optical Sensor.

  • brightness – Returns the brightness percentage detected by the sensor.

  • hue – Returns the hue value of the detected color.

  • object_detected – Registers a callback function for when the Optical Sensor detects an object.

  • object_lost – Registers a callback function for when the Optical Sensor loses an object.

• Rotation

  • set_position – Sets the current position of the Rotation Sensor to a specific value.

  • angle – Returns the current angle of the sensor between 0 and 359.99 degrees.

  • position – Returns the total rotational position in degrees or turns.

• GPS

  • x_position – Returns the current x coordinate of a GPS Sensor on the field.

  • y_position – Returns the current y coordinate of a GPS Sensor on the field.

  • heading – Returns the heading that the robot is currently facing based on the GPS Sensor’s readings from 0 to 359 degrees.

The examples on this page use the default Playground start position.

Motion

Actions

spin

spin spins a motor or motor group in the specified direction indefinitely.

Usage:
fork_motor_group.spin(direction)

Parameters	Description
direction	The direction for the motor group to spin: FORWARD REVERSE

def main():
    # Spin the motor group forward then stop
    fork_motor_group.spin(FORWARD)
    wait(0.5, SECONDS)
    fork_motor_group.stop()

# VR threads — Do not delete
vr_thread(main)

spin_for

spin_for spins a motor or motor group for a given amount of degrees or turns.

Usage:
fork_motor_group.spin_for(direction, distance, units, wait)

Parameters	Description
direction	The direction for the motor group to spin: FORWARD REVERSE
distance	The distance for the motor group to spin as an integer.
units	The unit that represents the distance to rotate: DEGREES TURNS
wait	Optional. wait=True (default) — The robot waits until spin_for is complete before executing the next line of code. wait=False — The robot starts the action and moves on to the next line of code right away, without waiting for spin_for to finish.

def main():
    # Spin the motor group forward then stop
    fork_motor_group.spin_for(FORWARD, 1, TURNS)

# VR threads — Do not delete
vr_thread(main)

spin_to_position

spin_to spins a motor or motor group to a given position.

Usage:
fork_motor_group.spin_to_position(angle, units, wait)

Parameters	Description
angle	The specific angle or number of turns that the motor group will spin to.
units	The unit that represents the angle to rotate to: DEGREES TURNS
wait	Optional. wait=True (default) — The robot waits until spin_to_position is complete before executing the next line of code. wait=False — The robot starts the action and moves on to the next line of code right away, without waiting for spin_to_position to finish.

def main():
    # Spin the motor group forward then stop
    fork_motor_group.spin_to_position(55, DEGREES)

# VR threads — Do not delete
vr_thread(main)

stop

stop stops a motor or motor group from spinning.

Usage:
fork_motor_group.stop()

Parameters	Description
	This method has no parameters.

def main():
    # Spin the motor group forward then stop
    fork_motor_group.spin(FORWARD)
    wait(0.5, SECONDS)
    fork_motor_group.stop()

# VR threads — Do not delete
vr_thread(main)

Mutators

set_position

set_position sets a motor’s or motor group’s encoder position to the given position value.

Usage:
fork_motor_group.set_position(position, units)

Parameters	Description
position	The specific integer for the motor group’s encoders to be set to.
units	The unit that represents the angle to rotate to: DEGREES TURNS

def main():
    # Spin the motor group forward then stop
    fork_motor_group.set_position(90, DEGREES)
    fork_motor_group.spin_to_position(0, DEGREES)

# VR threads — Do not delete
vr_thread(main)

set_velocity

set_velocity sets the speed of a motor or motor group.

Usage:
fork_motor_group.set_velocity(velocity, units)

Parameters	Description
velocity	The speed that the motor group will spin at, ranging from 0 to 100.
units	The unit that represents the new velocity: PERCENT

def main():
    # Spin the motor group forward then stop
    fork_motor_group.set_velocity(75, PERCENT)
    fork_motor_group.spin_to_position(180, DEGREES)

# VR threads — Do not delete
vr_thread(main)

set_timeout

set_timeout sets a time limit for a motor’s or motor group’s movement commands. This prevents Motion commands that do not reach their intended position from preventing subsequent commands from running.

Usage:
fork_motor_group.set_timeout(value, units)

Parameters	Description
value	The amount of time the motor group will wait before stopping.
units	The unit to represent the timeout: SECONDS MSEC — milliseconds

def main():
    # Spin the motor group forward then stop
    fork_motor_group.set_timeout(2, SECONDS)
    fork_motor_group.spin_to_position(270, DEGREES)

# VR threads — Do not delete
vr_thread(main)

Getters

is_done

is_done returns a Boolean indicating whether the specified motor or motor group is not spinning.

• True – The specified motor is not spinning.

• False – The specified motor is spinning.

Usage:
fork_motor_group.is_done()

Parameters	Description
	This method has no parameters.

is_spinning

is_spinning returns a Boolean indicating whether the specified motor or motor group is spinning.

• True – The specified motor is spinning.

• False – The specified motor is not spinning.

Usage:
fork_motor_group.is_spinning()

Parameters	Description
	This method has no parameters.

position

position returns the total distance the specified motor or motor group has rotated.

Usage:
fork_motor_group.position(units)

Parameters	Description
units	The units that represent the motor group’s position: DEGREES TURNS

velocity

velocity returns the current rotational speed of the motor or motor group.

Usage:
fork_motor_group.velocity(units)

Parameters	Description
units	The unit that represent the motor group’s position: PERCENT

Sensing

Optical

is_near_object

is_near_object returns a Boolean indicating whether or not the Optical Sensor detects an object close to the sensor.

• True – The object is close to the Optical Sensor.

• False – The object is not close to the Optical Sensor.

Usage:
optical.is_near_object()

Parameters	Description
	This method has no parameters.

color

color returns the color detected by the Optical Sensor:

Color Returned:
NONE – No color detected. RED GREEN BLUE YELLOW ORANGE PURPLE CYAN

Usage:
optical.color()

Parameters	Description
	This method has no parameters.

brightness

brightness returns the brightness value detected by the Optical Sensor as a percent from 0% to 100%.

Usage:
optical.brightness()

Parameters	Description
	This method has no parameters.

hue

hue returns the hue detected by the Optical Sensor.

Hue values range from 0 to 359 degrees, corresponding to positions on the color wheel shown below.

Usage:
optical.hue()

Parameters	Description
	This method has no parameters.

object_detected

object_detected registers a callback function for when the Optical Sensor detects an object.

Usage:
optical.object_detected(callback, arg)

Parameters	Description
callback	A function that will be called when an object is detected.
arg	Optional. A tuple that is used to pass arguments to the callback function.

object_lost

object_lost registers a callback function for when the Optical Sensor loses a previously detected object.

Usage:
optical.object_lost(callback, arg)

Parameters	Description
callback	A function that will be called when a detected object is lost.
arg	Optional. A tuple that is used to pass arguments to the callback function.

Rotation

set_position

set_position sets the current position of the Rotation Sensor to a value in degrees.

Usage:
rotation.set_position(position, units)

Parameters	Description
position	The position to set the Rotation Sensor to.
units	Optional. The unit of measurement: DEGREES (default) TURNS

angle

angle returns the current angle of the sensor as a float.

Usage:
rotation.angle(units)

Parameters	Description
units	Optional. The unit of measurement: DEGREES (default) – 0 to 359.99 TURNS

position

position returns the total rotational position.

Usage:
rotation.position(units)

Parameters	Description
units	Optional. The unit of measurement: DEGREES (default) – 0 to 359 as an integer TURNS – As a float

GPS

x_position

x_position returns the current x coordinate of a GPS (Game Positioning System™) Sensor on the field.

Usage:
gps.x_position(units)

Parameters	Description
units	The unit of the offset value: INCHES MM

y_position

y_position returns the current y coordinate of a GPS (Game Positioning System™) Sensor on the field.

Usage:
gps.y_position(units)

Parameters	Description
units	The unit of the offset value: INCHES MM

heading

heading returns the heading that the robot is currently facing based on the GPS (Game Positioning System™) Sensor’s readings from 0 to 359 degrees.

Usage:
gps.heading()

Parameters	Description
	This method has no parameters.