Python específico para robots#
Introducción#
El Hero Bot, Huey, incluye dos opciones de motor, el sensor de visión IQ AI, el sensor óptico y el LED táctil.
Todos los métodos estándar de VEXcode VR están disponibles para su uso en el IQ 25-26 Mix & Match Playground.
A continuación se muestra una lista de todos los métodos específicos de Robot disponibles:
Transmisión: mueva y gire el robot.
Acciones
drive— Mueve el robot hacia adelante o hacia atrás para siempre.drive_for— Mueve el robot hacia adelante o hacia atrás una distancia específica.turn— Gira el robot a la izquierda o a la derecha para siempre.turn_for— Gira el robot a la izquierda o a la derecha un número específico de grados.turn_to_heading— Gira el robot para enfrentar un rumbo específico de -359 a 359 grados.turn_to_rotation— Gira el robot a una rotación específica.stop— Detiene el movimiento del robot.
Mutadores
set_heading— Cambia el encabezado actual del robot a un nuevo encabezado.set_rotation— Cambia la rotación actual del robot a una nueva rotación.set_timeout— Establece cuánto tiempo intentará el robot terminar un movimiento.set_drive_velocity— Le dice al robot qué tan rápido debe conducir.set_turn_velocity— Le dice al robot qué tan rápido debe girar.
Getters
heading— Devuelve el rumbo actual del robot de 0 a 359,99 grados.rotation— Devuelve la rotación actual del robot.is_done— Devuelve si el robot ha terminado de moverse, como un valor booleano.is_moving— Devuelve si el robot se está moviendo, como un valor booleano.velocity: devuelve la velocidad a la que conduce el robot.
Movimiento: mueva y siga los motores del robot.
Acciones
spin— Hace girar un motor hacia adelante o hacia atrás para siempre.spin_for— Hace girar un motor para una distancia específica.spin_to_position— Hace girar un motor a una posición específica.stop— Detiene el giro de un motor.
Mutadores
set_position— Cambia la posición actual del motor a un nuevo valor.set_velocity— Le dice a un motor qué tan rápido debe girar.set_timeout— Establece cuánto tiempo intentará un motor terminar un movimiento.
Getters
is_done— Devuelve si el motor ha terminado de moverse, como un valor booleano.is_spinning— Devuelve si el motor está girando, como un valor booleano.position— Devuelve la posición actual del motor.velocity: devuelve la velocidad a la que gira el motor.
AI Vision: captura y analiza objetos utilizando el sensor de visión AI de IQ.
Getters
take_snapshot- Devuelve una tupla de objetos detectados para una firma específica.
Propiedades
width- Ancho del objeto detectado en píxeles.height- Altura del objeto detectado en píxeles.centerX- Posición X del centro del objeto en píxeles.centerY- Posición Y del centro del objeto en píxeles.originX- Posición X de la esquina superior izquierda del objeto en píxeles.originY- Posición Y de la esquina superior izquierda del objeto en píxeles.id- Clasificación o ID de etiqueta del objeto.
Consola: imprima los valores en la consola y el monitor.
Imprimir
brain.screen.print— Muestra texto, números o valores de variables en la Consola.brain.screen.next_row— Mueve el cursor de la consola al inicio de la siguiente fila.brain.screen.clear_screen: borra todas las filas de la consola.
Monitor
monitor_variable— Agrega una o más variables predefinidas a la pestaña Monitor.monitor_sensor— Agrega uno o más valores de sensor a la pestaña Monitor.
Detección: utilice los diversos sensores del robot.
LED táctil
set_color- Establece el LED táctil en un color seleccionado.
Óptico
is_near_object– Devuelve si el sensor óptico detecta un objeto dentro del alcance.color– Devuelve el color detectado por el sensor óptico.brightness– Devuelve la cantidad de luz reflejada por el objeto.hue– Devuelve el tono detectado por el sensor óptico.object_detected– Registra una función que se llamará cuando el sensor óptico detecte un objeto.object_lost– Registra una función que se llamará cuando el sensor óptico pierda un objeto.
Los ejemplos de esta página utilizan la posición de inicio predeterminada de Playground.
Tren de transmisión#
La transmisión controla cómo funciona y gira el robot de realidad virtual. El tren motriz puede moverse hacia adelante o hacia atrás, girar a la izquierda o a la derecha, girar hacia los encabezados y seguir su rotación.
Acciones#
unidad#
drive mueve el robot hacia adelante o hacia atrás para siempre. El robot continuará moviéndose hasta que se le dé otra acción, como girar o detenerse.
Usage:
drivetrain.drive(direction)
Parámetros |
Descripción |
|---|---|
|
La dirección en la que se mueve el robot: |
def main():
# Drive forward then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()
# VR threads — Do not delete
vr_thread(main)
drive_for#
drive_for mueve el robot hacia adelante o hacia atrás una distancia específica. El proyecto esperará hasta que el robot termine de moverse antes de que se ejecute la siguiente línea de código.
Usage:
drivetrain.drive_for(direction, distance, units, wait)
Parámetros |
Descripción |
|---|---|
|
La dirección en la que se mueve el robot: |
|
La distancia que recorre el robot. Esto puede ser un |
|
Opcional. La unidad de distancia: |
|
Opcional. |
def main():
# Drive forward and backward
drivetrain.drive_for(FORWARD, 200, MM)
drivetrain.drive_for(REVERSE, 200, MM)
# VR threads — Do not delete
vr_thread(main)
giro#
turn hace que el robot gire a la izquierda o a la derecha indefinidamente. El robot seguirá girando hasta que se le dé otra acción, como conducir o detenerse.
Usage:
drivetrain.turn(direction)
Parámetros |
Descripción |
|---|---|
|
La dirección en la que gira el robot: |
def main():
# Turn right and left, then stop
drivetrain.turn(RIGHT)
wait(2, SECONDS)
drivetrain.turn(LEFT)
wait(2, SECONDS)
drivetrain.stop()
# VR threads — Do not delete
vr_thread(main)
turn_for#
turn_for gira el robot a la izquierda o a la derecha un número específico de grados. El giro es relativo a la posición actual del robot. El proyecto esperará hasta que el robot termine de girar antes de que se ejecute la siguiente línea de código.
Usage:
drivetrain.turn_for(direction, angle, units, wait)
Parámetros |
Descripción |
|---|---|
|
La dirección en la que gira el robot: |
|
El número de grados que gira el robot. Esto puede ser un |
|
Opcional. La unidad de rotación: |
|
Opcional. |
def main():
# Turn the robot right and left
drivetrain.turn_for(RIGHT, 90, DEGREES)
wait(1, SECONDS)
drivetrain.turn_for(LEFT, 90, DEGREES)
# VR threads — Do not delete
vr_thread(main)
turn_to_heading#
Un rumbo es la dirección hacia la que se enfrenta el robot, medida en grados. turn_to_heading gira el robot para que se enfrente a un rumbo específico de -359 a 359 grados. El robot girará en la dirección más corta para alcanzar el rumbo objetivo.
El rumbo inicial del robot es de 0 grados.
El proyecto esperará hasta que el robot termine de girar antes de que se ejecute la siguiente línea de código.
Usage:
drivetrain.turn_to_heading(angle, units, wait)
Parámetros |
Descripción |
|---|---|
|
La dirección a la que debe mirar el robot, en grados. Esto puede ser un |
|
Opcional. La unidad de rotación: |
|
Opcional. |
def main():
# Turn to face the cardinal directions
drivetrain.turn_to_heading(90, DEGREES)
wait(1, SECONDS)
drivetrain.turn_to_heading(180, DEGREES)
wait(1, SECONDS)
drivetrain.turn_to_heading(270, DEGREES)
wait(1, SECONDS)
drivetrain.turn_to_heading(0, DEGREES)
# VR threads — Do not delete
vr_thread(main)
turn_to_rotation#
turn_to_rotation hace girar el robot a una rotación específica.
La rotación es cuánto ha girado el robot, medida en grados. Al comienzo de un proyecto, el valor de rotación se establece en 0 grados. La rotación también se puede configurar utilizando el método set_rotation.
Los valores de rotación son absolutos. Esto significa que la dirección del giro depende de la rotación actual del robot. Girar a la derecha aumenta la rotación y girar a la izquierda disminuye la rotación.
Por ejemplo, si el robot comienza a 0 grados y gira a una rotación de 720 grados, girará a la derecha dos veces. Si luego giras a una rotación de 360 grados, girará a la izquierda una vez, porque 360 es menos de 720.
El proyecto esperará hasta que el robot termine de girar antes de que se ejecute la siguiente línea de código.
Usage:
drivetrain.turn_to_rotation(angle, units, wait)
Parámetros |
Descripción |
|---|---|
|
El valor de rotación, en grados, al que girará el robot. Esto puede ser un |
|
Opcional. La unidad de rotación: |
|
Opcional. |
def main():
# Turn left, then spin in a circle
# clockwise and face right
drivetrain.turn_to_rotation(-90, DEGREES)
wait(1, SECONDS)
drivetrain.turn_to_rotation(450, DEGREES)
# VR threads — Do not delete
vr_thread(main)
parada#
stop detiene el movimiento del robot.
Usage:
drivetrain.stop()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
def main():
# Drive forward then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()
# VR threads — Do not delete
vr_thread(main)
Mutadores#
set_heading#
Un rumbo es la dirección hacia la que mira el robot, medida en grados. set_heading cambia el rumbo actual del robot a un nuevo valor de rumbo.
Por ejemplo, si el robot ha girado hacia la derecha, establecer el rumbo en 0 grados hace que esa posición orientada hacia la derecha sea la nueva de 0 grados. Luego, el robot puede pasar a otras posiciones en función de ese nuevo encabezado.
Usage:
drivetrain.set_heading(heading, units)
Parámetros |
Descripción |
|---|---|
|
El valor de rumbo, en grados, a establecer para el robot. Esto puede ser un |
|
Opcional. La unidad de encabezado: |
def main():
# Face the new 0 degrees
drivetrain.set_heading(90, DEGREES)
drivetrain.turn_to_heading(0, DEGREES)
# VR threads — Do not delete
vr_thread(main)
set_rotation#
La rotación es cuánto ha girado el robot, medida en grados. Al comienzo de un proyecto, el valor de rotación se establece en 0 grados. set_rotation cambia la rotación actual del robot a un nuevo valor.
Por ejemplo, si el robot ha realizado dos giros completos a la derecha, su valor de rotación será de 720 grados. Ajustar la rotación a 0 grados restablecerá esa rotación de 720 a 0 grados. Luego, el robot puede pasar a las rotaciones en función de ese nuevo valor.
Usage:
drivetrain.set_rotation(rotation, units)
Parámetros |
Descripción |
|---|---|
|
El valor de rotación, en grados, a establecer para el robot. Esto puede ser un |
|
Opcional. La unidad de rotación: |
def main():
# Spin counterclockwise two times
drivetrain.set_rotation(720, DEGREES)
drivetrain.turn_to_rotation(0, DEGREES)
# VR threads — Do not delete
vr_thread(main)
set_timeout#
set_timeout establece cuánto tiempo intentará el robot terminar un movimiento. Si el robot no puede terminar en ese tiempo, dejará de intentarlo y pasará a la siguiente línea de código. Esto evita que el robot se atasque en un movimiento.
Usage:
drivetrain.set_timeout(value, units)
Parámetros |
Descripción |
|---|---|
|
La cantidad de tiempo que el robot puede intentar terminar un movimiento. Esto puede ser un |
|
La unidad de tiempo: |
def main():
# Turn right after driving forward
drivetrain.set_timeout(1, SECONDS)
drivetrain.drive_for(FORWARD, 25, INCHES)
drivetrain.turn_for(RIGHT, 90)
# VR threads — Do not delete
vr_thread(main)
set_drive_velocity#
set_drive_velocity le dice al robot qué tan rápido conducir. Un porcentaje más alto hace que el robot conduzca más rápido y un porcentaje más bajo hace que el robot conduzca más lento.
Cada proyecto comienza con el robot conduciendo al 50% de la velocidad por defecto.
Nota: Una velocidad más alta hace que el robot conduzca más rápido, pero puede ser menos preciso. Una velocidad más baja hace que el robot conduzca más lento, pero puede ser más preciso.
Usage:
drivetrain.set_drive_velocity(velocity, units)
Parámetros |
Descripción |
|---|---|
|
La velocidad para conducir va del 0% al 100%. Esto puede ser un |
|
Opcional. La unidad de velocidad: |
def main():
# Drive forward at different velocities
# Default velocity
drivetrain.drive_for(FORWARD, 150, MM)
wait(1, SECONDS)
# Drive slower
drivetrain.set_drive_velocity(20, PERCENT)
drivetrain.drive_for(FORWARD, 150, MM)
wait(1, SECONDS)
# Drive faster
drivetrain.set_drive_velocity(100, PERCENT)
drivetrain.drive_for(FORWARD, 150, MM)
# VR threads — Do not delete
vr_thread(main)
set_turn_velocity#
set_turn_velocity le dice al robot qué tan rápido debe girar. Un porcentaje más alto hace que el robot gire más rápido y un porcentaje más bajo hace que el robot gire más lento.
Cada proyecto comienza con el robot girando a una velocidad del 50% por defecto.
Nota: Una velocidad más alta hace que el robot gire más rápido, pero puede ser menos preciso. Una velocidad más baja hace que el robot gire más lento, pero puede ser más preciso.
Usage:
drivetrain.set_turn_velocity(velocity, units)
Parámetros |
Descripción |
|---|---|
|
La velocidad para girar es de 0% a 100%. Esto puede ser un |
|
Opcional. La unidad de velocidad: |
def main():
# Turn at different velocities
# Default velocity
drivetrain.turn_for(RIGHT, 120, DEGREES)
wait(1, SECONDS)
# Turn slower
drivetrain.set_turn_velocity(20, PERCENT)
drivetrain.turn_for(RIGHT, 120, DEGREES)
wait(1, SECONDS)
# Turn faster
drivetrain.set_turn_velocity(100, PERCENT)
drivetrain.turn_for(RIGHT, 120, DEGREES)
# VR threads — Do not delete
vr_thread(main)
Getters#
encabezado#
Un rumbo es la dirección hacia la que mira el robot, medida en grados. El heading devuelve el rumbo actual del robot de 0 a 359,99 grados.
El rumbo inicial del robot es de 0 grados.
Usage:
drivetrain.heading(units)
Parámetros |
Descripción |
|---|---|
|
Opcional. La unidad de encabezado: |
def main():
# Display the heading after turning
drivetrain.turn_for(RIGHT, 450, DEGREES)
brain.screen.print("Heading: ")
brain.screen.print(drivetrain.heading(DEGREES))
# VR threads — Do not delete
vr_thread(main)
rotación#
La rotación es cuánto ha girado el robot, medida en grados. Al comienzo de un proyecto, el valor de rotación se establece en 0 grados. La rotation devuelve la rotación actual del robot.
Girar a la derecha aumenta la rotación y girar a la izquierda disminuye la rotación. Por ejemplo, hacer dos giros completos a la derecha devolverá una rotación de 720 grados.
Usage:
drivetrain.rotation(units)
Parámetros |
Descripción |
|---|---|
|
Opcional. La unidad de rotación: |
def main():
# Display the rotation after turning
drivetrain.turn_for(RIGHT, 450, DEGREES)
brain.screen.print("Rotation: ")
brain.screen.print(drivetrain.rotation(DEGREES))
# VR threads — Do not delete
vr_thread(main)
is_done#
is_done devuelve si el robot ha terminado de moverse, como un valor booleano. Esto se puede utilizar para controlar el tiempo de otros comportamientos basados en el movimiento del robot.
True: el robot ha terminado de moverse.False: el robot todavía se está moviendo.
Este método funciona junto con los siguientes métodos de transmisión que tienen el parámetro wait: drive_for, turn_for, turn_to_heading y turn_to_rotation.
Usage:
drivetrain.is_done()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
is_moving#
is_moving devuelve si el robot se está moviendo, como un valor booleano. Esto se puede utilizar para controlar el tiempo de otros comportamientos basados en el movimiento del robot.
True: el robot se está moviendo.False— El robot no se mueve.
Usage:
drivetrain.is_moving()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
velocidad#
velocity devuelve la velocidad a la que conduce el robot, como un porcentaje de -100% a 100%.
Usage:
drivetrain.velocity(units)
Parámetros |
Descripción |
|---|---|
|
Opcional. La unidad de velocidad: |
Ejemplo
def main():
# Display the velocity after driving
drivetrain.drive_for(FORWARD, 150, MM)
brain.screen.print("Velocity: ")
brain.screen.print(drivetrain.velocity(PERCENT))
Movimiento#
Huey utiliza el motor de la garra para abrir y cerrar la garra para que los pasadores y las vigas se puedan levantar o soltar. El motor de elevación sube y baja los pasadores o vigas para que puedan unirse entre sí.
Cada motor tiene su propio comportamiento de dirección. Las descripciones de las direcciones explican cómo cada dirección mueve ese motor en Huey.
Acciones#
girar#
spin hace girar un motor hacia adelante o hacia atrás para siempre. El motor continuará girando hasta que se le dé otra acción, como girar en una dirección diferente o detenerse.
Uso:
Se puede utilizar uno de los dos objetos de motor disponibles con este método, como se muestra a continuación:
motor |
Comando |
|---|---|
|
|
|
|
Parámetros |
Descripción |
|---|---|
|
Dirección de giro del motor:
|
def main():
# Raise the lift, drive forward, then open the claw.
lift_motor.spin_for(REVERSE, 600, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
# VR threads — Do not delete
vr_thread(main)
spin_for#
spin_for hace girar un motor para una distancia específica. El giro es relativo a la posición actual del motor. El proyecto esperará hasta que el motor termine de girar antes de que se ejecute la siguiente línea de código.
Uso:
Se puede utilizar uno de los dos objetos de motor disponibles con este método, como se muestra a continuación:
motor |
Comando |
|---|---|
|
|
|
|
Parámetros |
Descripción |
|---|---|
|
Dirección de giro del motor:
|
|
La distancia que gira el motor. |
|
Opcional. La unidad de distancia: |
|
Opcional.
|
def main():
# Raise the lift, drive forward, then open the claw.
lift_motor.spin_for(REVERSE, 600, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
# VR threads — Do not delete
vr_thread(main)
spin_to_position#
spin_to_position hace girar un motor a una posición específica.
La posición de un motor es la distancia a la que ha girado, medida en DEGREES o TURNS. Un giro equivale a 360 grados. Al comienzo de un proyecto, la posición del motor se establece en 0 grados. La posición del motor también se puede configurar utilizando el método set_position.
Los valores de posición son absolutos. Esto significa que la dirección del giro depende de la posición actual del motor.
Por ejemplo, si el motor arranca a 0 grados y gira a una posición de 720 grados, girará hacia adelante dos vueltas. Si luego gira a una posición de 360 grados, girará en reversa una vuelta, porque 360 es menos de 720.
Uso:
Se puede utilizar uno de los dos objetos de motor disponibles con este método, como se muestra a continuación:
motor |
Comando |
|---|---|
|
|
|
|
Parámetros |
Descripción |
|---|---|
|
El valor de posición al que girará el motor. |
|
Opcional. La unidad de posición: |
|
Opcional.
|
def main():
# Raise the lift to a known position, drive, then open the claw
lift_motor.spin_to_position(-720, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
# VR threads — Do not delete
vr_thread(main)
motor de parada#
stop detiene el giro de un motor.
Uso:
Se puede utilizar uno de los dos objetos de motor disponibles con este método, como se muestra a continuación:
motor |
Comando |
|---|---|
|
|
|
|
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
def main():
# Raise the lift for 2 seconds, then stop
lift_motor.spin(REVERSE)
wait(2, SECONDS)
lift_motor.stop()
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
# VR threads — Do not delete
vr_thread(main)
Mutadores#
set_position#
La posición de un motor es la distancia a la que ha girado, medida en DEGREES o TURNS. Un giro es igual a 360 grados. set_position cambia la posición actual del motor a un nuevo valor.
Por ejemplo, si un motor ha girado a 180 grados, ajustar la posición a 0 grados restablecerá esa posición de 180 a 0 grados. Entonces el motor puede girar a posiciones basadas en ese nuevo valor.
Uso:
Se puede utilizar uno de los dos objetos de motor disponibles con este método, como se muestra a continuación:
motor |
Comando |
|---|---|
|
|
|
|
Parámetros |
Descripción |
|---|---|
|
El valor de posición que se debe establecer para el motor. |
|
Opcional. La unidad de posición: |
def main():
# Reset the lift position, then move to a new target.
lift_motor.set_position(100, DEGREES)
lift_motor.spin_to_position(-500, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
# VR threads — Do not delete
vr_thread(main)
set_velocity#
set_velocity le dice a un motor qué tan rápido debe girar. Un porcentaje más alto hace que el motor gire más rápido y un porcentaje más bajo hace que el motor gire más lento.
Cada proyecto comienza con cada motor girando al 50% de velocidad por defecto.
Nota: Una velocidad más alta hace que el motor gire más rápido, pero puede ser menos preciso. Una velocidad más baja hace que el motor gire más lento, pero puede ser más preciso.
Uso:
Se puede utilizar uno de los dos objetos de motor disponibles con este método, como se muestra a continuación:
motor |
Comando |
|---|---|
|
|
|
|
Parámetros |
Descripción |
|---|---|
|
La velocidad para girar es de 0% a 100%. Esto puede ser un |
|
La unidad de velocidad: |
def main():
# Set lift speed, then raise it.
lift_motor.set_velocity(100, PERCENT)
lift_motor.spin_for(REVERSE, 600, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
# VR threads — Do not delete
vr_thread(main)
set_timeout#
set_timeout establece cuánto tiempo intentará un motor terminar un movimiento. Si el motor no puede terminar en ese tiempo, dejará de intentarlo y pasará a la siguiente línea de código. Esto evita que el motor se atasque en un movimiento.
Uso:
Se puede utilizar uno de los dos objetos de motor disponibles con este método, como se muestra a continuación:
motor |
Comando |
|---|---|
|
|
|
|
Parámetros |
Descripción |
|---|---|
|
La cantidad de tiempo que el motor puede intentar terminar un movimiento. Esto puede ser un |
|
La unidad de tiempo: |
def main():
# Limit how long the lift waits to reach its target.
lift_motor.set_timeout(2, SECONDS)
lift_motor.spin_for(REVERSE, 1800, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
# VR threads — Do not delete
vr_thread(main)
Getters#
is_done#
is_done devuelve si el motor ha terminado de moverse, como un valor booleano. Esto se puede utilizar para controlar el tiempo de otros comportamientos basados en el movimiento del motor.
True: el motor ha terminado de moverse.False: el motor todavía está en movimiento.
Este método funciona junto con los siguientes métodos de movimiento que tienen el parámetro wait: spin_for y spin_to_position.
Uso:
Se puede utilizar uno de los dos objetos de motor disponibles con este método, como se muestra a continuación:
motor |
Comando |
|---|---|
|
|
|
|
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
def main():
# Flash the Touch LED while the lift is moving.
lift_motor.spin_for(REVERSE, 600, DEGREES, wait=False)
wait(0.1, SECONDS)
while not lift_motor.is_done():
touchled.set_color(RED)
wait(0.5, SECONDS)
touchled.set_color(NONE)
wait(0.5, SECONDS)
# VR threads — Do not delete
vr_thread(main)
is_spinning#
is_spinning devuelve si el motor está girando, como un valor booleano. Esto se puede utilizar para controlar el tiempo de otros comportamientos basados en el movimiento del motor.
True: el motor está girando.False— El motor no está girando.
Este método funciona junto con los siguientes métodos de movimiento que tienen el parámetro wait: spin_for y spin_to_position.
Uso:
Se puede utilizar uno de los dos objetos de motor disponibles con este método, como se muestra a continuación:
motor |
Comando |
|---|---|
|
|
|
|
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
def main():
# Flash the Touch LED while the lift is spinning.
lift_motor.spin_for(REVERSE, 600, DEGREES, wait=False)
wait(0.1, SECONDS)
while lift_motor.is_spinning():
touchled.set_color(RED)
wait(0.5, SECONDS)
touchled.set_color(NONE)
wait(0.5, SECONDS)
# VR threads — Do not delete
vr_thread(main)
cargo#
La posición de un motor es la distancia a la que ha girado, medida en DEGREES o TURNS. Un giro equivale a 360 grados. La position devuelve la posición actual del motor.
Al comienzo de un proyecto, la posición del motor se establece en 0 grados. Si el motor gira una vuelta completa hacia adelante, la posición será de 360 grados o 1 vuelta. Si el motor gira en la otra dirección, la posición será negativa.
Uso:
Se puede utilizar uno de los dos objetos de motor disponibles con este método, como se muestra a continuación:
motor |
Comando |
|---|---|
|
|
|
|
Parámetros |
Descripción |
|---|---|
|
La unidad para devolver la posición del motor en: |
def main():
# Raise the lift until it reaches roughly 600 degrees.
lift_motor.spin(REVERSE)
while not lift_motor.position(DEGREES) <= -600:
wait(2, MSEC)
lift_motor.stop()
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
# VR threads — Do not delete
vr_thread(main)
velocidad#
velocity devuelve la velocidad a la que gira el motor.
Un valor positivo significa que el motor está girando hacia adelante. Un valor negativo significa que el motor está girando en reversa.
Uso:
Se puede utilizar uno de los dos objetos de motor disponibles con este método, como se muestra a continuación:
motor |
Comando |
|---|---|
|
|
|
|
Parámetros |
Descripción |
|---|---|
|
La unidad de velocidad a devolver: |
def main():
# Print the lift velocity while it is moving.
lift_motor.set_velocity(100, PERCENT)
lift_motor.spin_for(REVERSE, 600, DEGREES, wait=False)
wait(0.5, SECONDS)
brain.screen.print(lift_motor.velocity(PERCENT))
# VR threads — Do not delete
vr_thread(main)
Visión de IA#
Getters#
take_snapshot#
take_snapshot filtra los datos del marco del sensor de visión IQ AI en una sola firma, una descripción guardada de algo que el sensor puede reconocer, como un elemento de juego en el campo, y devuelve una tupla.
La tupla almacena objetos ordenados de mayor a menor por ancho, comenzando en el índice 0. Se puede acceder a las propiedades de cada objeto utilizando su índice. Se devuelve una tupla vacía si no se detectan objetos coincidentes.
Usage:
ai_vision.take_snapshot(signature)
Parámetros |
Descripción |
|---|---|
|
Filtra el conjunto de datos para incluir solo los datos de la firma dada. Las firmas disponibles son
|
def main():
# Place the Red Pin on the top-left Blue Pin.
lift_motor.spin_for(REVERSE, 600, DEGREES)
drivetrain.turn_for(LEFT, 38, DEGREES)
ai_objects = ai_vision.take_snapshot(AiVision.ALL_AIOBJS)
while not ai_objects[0].width > 48:
ai_objects = ai_vision.take_snapshot(AiVision.ALL_AIOBJS)
drivetrain.drive(FORWARD)
drivetrain.drive_for(FORWARD, 160, MM)
claw_motor.spin(FORWARD)
# VR threads — Do not delete
vr_thread(main)
Propiedades#
Hay siete propiedades que se incluyen con cada objeto almacenado en una tupla después de usar take_snapshot.
Todos los valores de propiedad, excepto .id, describen la posición y el tamaño del objeto detectado en la vista del sensor de visión IQ AI en el momento en que se utilizó take_snapshot. Estos valores se miden en píxeles, en función de la resolución de 320 por 240 píxeles del sensor.
.width#
.width devuelve el ancho del objeto detectado en píxeles, que es un número entero entre 1 y 320.
def main():
ai_objects = ai_vision.take_snapshot(AiVision.ALL_AIOBJS)
if len(ai_objects) > 0:
brain.screen.print(ai_objects[0].width)
# VR threads — Do not delete
vr_thread(main)
.height#
.height devuelve la altura del objeto detectado en píxeles, que es un número entero entre 1 y 240.
def main():
ai_objects = ai_vision.take_snapshot(AiVision.ALL_AIOBJS)
if len(ai_objects) > 0:
brain.screen.print(ai_objects[0].height)
# VR threads — Do not delete
vr_thread(main)
.centerX#
.centerX devuelve la coordenada x del centro del objeto detectado en píxeles, que es un entero entre 0 y 320.
def main():
ai_objects = ai_vision.take_snapshot(AiVision.ALL_AIOBJS)
if len(ai_objects) > 0:
brain.screen.print(ai_objects[0].centerX)
# VR threads — Do not delete
vr_thread(main)
.centerY#
.centerY devuelve la coordenada y del centro del objeto detectado en píxeles, que es un número entero entre 0 y 240.
def main():
ai_objects = ai_vision.take_snapshot(AiVision.ALL_AIOBJS)
if len(ai_objects) > 0:
brain.screen.print(ai_objects[0].centerY)
# VR threads — Do not delete
vr_thread(main)
.originX#
.originX devuelve la coordenada x de la esquina superior izquierda del cuadro delimitador del objeto detectado en píxeles, que es un número entero entre 0 y 320.
def main():
ai_objects = ai_vision.take_snapshot(AiVision.ALL_AIOBJS)
if len(ai_objects) > 0:
brain.screen.print(ai_objects[0].originX)
# VR threads — Do not delete
vr_thread(main)
.originY#
.originY devuelve la coordenada y de la esquina superior izquierda del cuadro delimitador del objeto detectado en píxeles, que es un número entero entre 0 y 240.
def main():
ai_objects = ai_vision.take_snapshot(AiVision.ALL_AIOBJS)
if len(ai_objects) > 0:
brain.screen.print(ai_objects[0].originY)
# VR threads — Do not delete
vr_thread(main)
.id#
.id devuelve el ID de la Clasificación de IA detectada como un número entero.
Clasificación de IA |
id |
Firma |
|---|---|---|
Viga |
0 |
|
Pin azul |
1 |
|
Pin rojo |
2 |
|
Pasador naranja |
3 |
|
def main():
# Find the nearest Blue Pin in the current snapshot.
lift_motor.spin_for(REVERSE, 600, DEGREES)
object_count = 1
ai_objects = ai_vision.take_snapshot(AiVision.ALL_AIOBJS)
if len(ai_objects) > 0:
for repeat_count in range(len(ai_objects)):
if ai_objects[repeat_count].id == GameElements.BLUE_PIN:
brain.screen.print(str("Closest Blue Pin is ") + str(object_count))
break
object_count = object_count + 1
# VR threads — Do not delete
vr_thread(main)
Consola#
La Consola muestra texto, números y valores de variables mientras se ejecuta un proyecto. Los métodos de consola también pueden mover el cursor a una nueva fila, borrar la consola y agregar variables o valores de sensor a la pestaña Monitor.
Imprimir#
brain.screen.print#
brain.screen.print muestra texto, números o valores de variables en la Consola utilizando la posición actual del cursor. Se comporta como print en la página de la API de la consola.
Use brain.screen.next_row cuando desee que el siguiente valor impreso comience en una nueva fila.
Usage:
brain.screen.print(value)
Parámetros |
Descripción |
|---|---|
|
El texto, el número o el valor de la variable que se mostrará en la Consola. |
def main():
# Display a message in the Console
brain.screen.print("Hello, robot!")
# VR threads — Do not delete
vr_thread(main)
brain.screen.next_row#
brain.screen.next_row mueve el cursor a la columna 1 en la siguiente fila de la Consola. El siguiente valor impreso aparecerá en esa fila.
Usage:
brain.screen.next_row()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
def main():
# Print on two rows
brain.screen.print("Row 1")
brain.screen.next_row()
brain.screen.print("Row 2")
# VR threads — Do not delete
vr_thread(main)
brain.screen.clear_screen#
brain.screen.clear_screen borra todas las filas de la consola y mueve el cursor a la fila 1.
Usage:
brain.screen.clear_screen()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
def main():
# Display text, then clear it after two seconds
brain.screen.print("This will disappear...")
wait(2, SECONDS)
brain.screen.clear_screen()
# VR threads — Do not delete
vr_thread(main)
Monitor#
monitor_variable#
monitor_variable agrega una o más variables predefinidas a la pestaña Monitor en VEXcode. Esto le permite ver el cambio de valor de una variable mientras se ejecuta un proyecto.
Las variables deben ser globales para que monitor_variable las monitoree con éxito. Proporcione cada nombre de variable como una cadena.
Usage:
monitor_variable(“variable”)
monitor_variable(“variable1”, “variable2”)
Parámetros |
Descripción |
|---|---|
|
El nombre de una variable global predefinida para monitorear, dada como una cadena. Para monitorear más de una variable, separe cada nombre de variable con una coma. |
def main():
# Monitor the amount of loops
global loops
monitor_variable("loops")
# Drive in a square 3 times
for loops in range(12):
drivetrain.turn_for(RIGHT, 90, DEGREES)
drivetrain.drive_for(FORWARD, 150, MM)
# VR threads — Do not delete
vr_thread(main)
monitor_sensor#
monitor_sensor agrega uno o más valores de sensor a la pestaña Monitor en VEXcode. Esto le permite ver cómo cambian los valores del sensor mientras se ejecuta un proyecto.
Proporcione cada valor del sensor como una cadena.
Usage:
monitor_sensor(“sensor”)
monitor_sensor(“sensor1”, “sensor2”)
Parámetros |
Descripción |
|---|---|
|
El valor del sensor que se va a monitorizar, especificado como una cadena de texto. Para monitorizar más de un valor de sensor, sepárelos con una coma. Los identificadores de sensor admitidos incluyen:
|
def main():
# Monitor the robot's heading
monitor_sensor("drivetrain.heading")
drivetrain.turn_for(RIGHT, 450, DEGREES)
# VR threads — Do not delete
vr_thread(main)
Detección#
LED TÁCTIL#
set_color#
set_color establece el color del LED táctil.
Usage:
touchled.set_color(color)
Parámetros |
Descripción |
|---|---|
|
El color para configurar el LED táctil es:
|
def main():
# Light the Touch LED while placing a Pin.
touchled.set_color(RED)
lift_motor.spin_for(REVERSE, 600, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
touchled.set_color(NONE)
# VR threads — Do not delete
vr_thread(main)
Óptico#
is_near_object#
is_near_object devuelve un booleano que indica si el sensor óptico detecta o no un objeto dentro del alcance.
True: el sensor óptico detecta un objeto.False– El sensor óptico no detecta un objeto.
Usage:
optical.is_near_object()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
def main():
# Wait until the claw no longer detects an object, then lower the lift.
lift_motor.spin_for(REVERSE, 600, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
while optical.is_near_object():
wait(2, MSEC)
lift_motor.spin_to_position(0, DEGREES)
# VR threads — Do not delete
vr_thread(main)
color#
color devuelve una instancia de una clase Color , basada en el valor de tono detectado. Estos se pueden comparar con objetos Color predefinidos para crear declaraciones condicionales.
Los colores posibles son:
NONERED- Un valor de tono entre 340° - 20°GREEN- Un valor de tono entre 80° - 140°BLUE- Un valor de tono entre 200° - 240°YELLOW- Un valor de tono entre 40° - 60°ORANGE- Un valor de tono entre 20° - 40°PURPLE- Un valor de tono entre 240° - 280°CYAN- Un valor de tono entre 140° - 200°
Nota: El sensor óptico está buscando rangos de tonalidad que coincidan con el color especificado. Para detectar rangos de tonalidad específicos, consulte hue.
Usage:
optical.color()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
def main():
# Wait until the Optical Sensor detects red, then lower the lift.
lift_motor.spin_for(REVERSE, 600, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
while not optical.color() == RED:
wait(5, MSEC)
lift_motor.spin_to_position(0, DEGREES)
# VR threads — Do not delete
vr_thread(main)
brillo#
el brightness devuelve la cantidad de luz reflejada desde el objeto como un decimal (float) que representa un porcentaje.
Un porcentaje más alto significa que se refleja más luz al sensor óptico. Un porcentaje más bajo significa que se refleja menos luz.
Usage:
optical.brightness()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
def main():
# Lower the lift once the claw sees a darker object.
lift_motor.spin_for(REVERSE, 600, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
while not 30 > optical.brightness():
wait(5, MSEC)
lift_motor.spin_to_position(0, DEGREES)
# VR threads — Do not delete
vr_thread(main)
matiz#
hue devuelve el valor de tono del color detectado como un decimal (float) de 0 a 359.
El tono es una forma de describir el color usando números alrededor de una rueda de color.
Usage:
optical.hue()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
def main():
# Lower the lift once the Optical Sensor reports a hue value.
lift_motor.spin_for(REVERSE, 600, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
while not optical.hue() > 0:
wait(5, MSEC)
lift_motor.spin_to_position(0, DEGREES)
# VR threads — Do not delete
vr_thread(main)
object_detected#
object_detected registra una función que se llamará cada vez que el sensor óptico detecte un nuevo objeto.
Usage:
optical.object_detected(callback, arg)
Parámetros |
Descripción |
|---|---|
|
Una función previamente definida que se ejecuta cuando el sensor óptico detecta un nuevo objeto. |
|
Opcional. Una tupla que contiene argumentos para pasar a la función de devolución de llamada. Consulte Uso de funciones con parámetros para obtener más información. |
def pin_in_claw():
touchled.set_color(RED)
def main():
# Change the Touch LED color when the claw detects an object.
optical.object_detected(pin_in_claw)
touchled.set_color(GREEN)
lift_motor.spin_for(REVERSE, 600, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
# VR threads — Do not delete
vr_thread(main)
object_lost#
object_lost registra una función que se llamará cada vez que el sensor óptico pierda un objeto detectado.
Usage:
optical.object_lost(callback, arg)
Parámetros |
Descripción |
|---|---|
|
Una función previamente definida que se ejecuta cuando el sensor óptico pierde un objeto detectado. |
|
Opcional. Una tupla que contiene argumentos para pasar a la función de devolución de llamada. Consulte Uso de funciones con parámetros para obtener más información. |
def lower_lift():
# Lower the lift when the claw no longer holds an object.
lift_motor.spin_to_position(0, DEGREES)
def main():
optical.object_lost(lower_lift)
lift_motor.spin_for(REVERSE, 600, DEGREES)
drivetrain.drive_for(FORWARD, 140, MM)
claw_motor.spin(FORWARD)
# VR threads — Do not delete
vr_thread(main)