Jarak#

Perkenalan #

Sensor Jarak dapat mendeteksi apakah ada objek di depan sensor dan memberikan informasi seberapa jauh objek tersebut berada.

Sensor Jarak VEX IQ (generasi ke-1) menggunakan sonar untuk mendeteksi objek dan mengukur jarak. Sensor Jarak VEX IQ (generasi ke-2) menggunakan laser yang aman untuk ruang kelas dan juga dapat mengembalikan kecepatan relatif objek yang terdeteksi serta memperkirakan apakah objek tersebut kecil, sedang, atau besar.

Halaman ini menggunakan distance_1 sebagai contoh nama Sensor Jarak. Ganti dengan nama yang Anda konfigurasi sendiri sesuai kebutuhan.

Berikut adalah daftar semua metode yang tersedia:

Getter — Mengembalikan data dari Sensor Jarak.

is_object_detected — (VEX IQ Distance Sensor (generasi ke-1) atau (generasi ke-2)) Mengembalikan apakah Sensor Jarak saat ini mendeteksi suatu objek.
distance — (VEX IQ Distance Sensor (1st gen)) Mengembalikan jarak antara Sensor Jarak dan objek terdekat yang terdeteksi.
object_distance — (VEX IQ Distance Sensor (2nd gen)) Mengembalikan jarak antara Sensor Jarak dan objek terdekat yang terdeteksi.
object_velocity — (VEX IQ Distance Sensor (2nd gen)) Mengembalikan seberapa cepat objek yang terdeteksi bergerak mendekati atau menjauhi Sensor Jarak.
object_size — (VEX IQ Distance Sensor (2nd gen)) Mengembalikan perkiraan ukuran objek yang terdeteksi.
installed — (Sensor Jarak VEX IQ (generasi ke-1) atau (generasi ke-2)) Mengembalikan apakah Sensor Jarak terpasang dan terhubung.

Konstruktor — Menginisialisasi dan mengkonfigurasi Sensor Jarak secara manual.

Sonar — Membuat Sensor Jarak VEX IQ (generasi ke-1).
Distance — Membuat Sensor Jarak VEX IQ (generasi ke-2).

Pencari #

is_object_detected #

is_object_detected mengembalikan nilai boolean yang menunjukkan apakah Sensor Jarak saat ini mendeteksi objek dalam jangkauan.

True — Sensor Jarak mendeteksi sebuah objek.
False — Sensor Jarak tidak mendeteksi objek.

Usage:
distance_1.is_object_detected()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

# Turn until an object is detected
drivetrain.turn(RIGHT)
while not distance_1.is_object_detected():
    wait(15, MSEC)
drivetrain.stop()
brain.screen.print("Object detected!")

distance #

distance mengembalikan jarak antara Sensor Jarak dan objek terdekat yang terdeteksi sebagai angka desimal (float).

Catatan: Ini adalah metode Sensor Jarak VEX IQ (generasi ke-1).

Usage:
distance_1.distance(units)

Parameter	Keterangan
`units`	Opsional. Satuan jarak: `MM` (standar, 24 mm hingga 1000 mm) atau `INCHES` (1 inci hingga 40 inci).

# Display the distance to an object
if distance_1.is_object_detected():
    print("Distance: ")
    print(distance_1.distance(MM))
else:
    print("No object detected")

object_distance #

object_distance mengembalikan jarak antara Sensor Jarak dan objek terdekat yang terdeteksi sebagai angka desimal (float).

Catatan: Ini adalah metode Sensor Jarak VEX IQ (generasi ke-2).

Usage:
distance_1.object_distance(units)

Parameter	Keterangan
`units`	Opsional. Satuan jarak: `MM` (standar, 20 mm hingga 2000 mm), `INCHES` (0,78 inci hingga 78 inci), atau `DistanceUnits.CM` (2 cm hingga 200 cm).

# Drive forward until an object is 200 mm away
while distance_1.object_distance(MM) > 200:
    drivetrain.drive(FORWARD)
drivetrain.stop()

object_velocity #

object_velocity mengembalikan kecepatan relatif objek yang terdeteksi sebagai angka desimal (float) dalam m/s (meter per detik).

Kecepatan menunjukkan seberapa cepat objek bergerak mendekati atau menjauhi Sensor Jarak. Nilai positif berarti objek bergerak mendekati Sensor Jarak. Nilai negatif berarti objek bergerak menjauhinya. Nilai mendekati 0 berarti objek tidak banyak bergerak relatif terhadap sensor.

Catatan: Ini adalah metode Sensor Jarak VEX IQ (generasi ke-2).

Usage:
distance_1.object_velocity()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

# Display the velocity of a moving object
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print("Velocity: ")
    brain.screen.print(distance_1.object_velocity())
    wait(100, MSEC)

object_size #

object_size mengembalikan perkiraan ukuran objek yang terdeteksi oleh Sensor Jarak.

Sensor Jarak memperkirakan ukuran objek berdasarkan seberapa banyak area pandang sensor yang ditempati oleh objek yang terdeteksi.

ObjectSizeType.NONE — Tidak ada objek yang terdeteksi.
ObjectSizeType.SMALL — Objek kecil terdeteksi.
ObjectSizeType.MEDIUM — Objek berukuran sedang terdeteksi.
ObjectSizeType.LARGE — Objek besar terdeteksi.

Catatan: Ini adalah metode Sensor Jarak VEX IQ (generasi ke-2).

Usage:
distance_1.object_size()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

installed #

installed mengembalikan informasi apakah Sensor Jarak terpasang dan terhubung.

True — Sensor Jarak telah terpasang dan terhubung.
False — Sensor Jarak tidak terpasang atau tidak terhubung.

Usage:
distance_1.installed()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

Konstruktor #

Konstruktor digunakan untuk membuat objek Distance dan Sonar secara manual, misalnya saat mengkonfigurasi Sensor Jarak di luar VEXcode.

Sonar #

Sonar membuat objek VEX IQ Distance Sensor (generasi ke-1).

Usage:
distance_1 = Sonar(smartport)

Parameter	Keterangan
`smartport`	Port Pintar tempat Sensor Jarak terhubung, ditulis sebagai `Ports.PORTx`, di mana `x` adalah nomor port.

# Create a Sonar object in Port 1
distance_1 = Sonar(Ports.PORT1)

Distance #

Distance membuat objek VEX IQ Distance Sensor (generasi ke-2).

Usage:
distance_1 = Distance(smartport)

Parameter	Keterangan
`smartport`	Port Pintar tempat Sensor Jarak terhubung, ditulis sebagai `Ports.PORTx`, di mana `x` adalah nomor port.

# Create a Distance object in Port 1
distance_1 = Distance(Ports.PORT1)