مسافة

مقدمة

يستطيع مستشعر المسافة اكتشاف ما إذا كان هناك جسم ما أمام المستشعر وإرجاع المسافة التي يبعدها هذا الجسم.

يستخدم مستشعر المسافة VEX IQ (الجيل الأول) تقنية السونار للكشف عن الأجسام وقياس المسافة. أما مستشعر المسافة VEX IQ (الجيل الثاني) فيستخدم ليزرًا آمنًا للاستخدام في الفصول الدراسية، ويمكنه أيضًا تحديد السرعة النسبية للجسم المكتشف وتقدير حجمه (صغير، متوسط، كبير).

تستخدم هذه الصفحة الاسم distance_1 كمثال لاسم مستشعر المسافة. استبدله بالاسم الذي قمت بتكوينه حسب الحاجة.

فيما يلي قائمة بجميع الطرق المتاحة:

المُستقبِلات — تُعيد البيانات من مستشعر المسافة.

• is_object_detected — (VEX IQ Distance Sensor (الجيل الأول) أو (الجيل الثاني)) إرجاع ما إذا كان مستشعر المسافة يكتشف حاليًا وجود جسم.

• distance — (مستشعر المسافة VEX IQ (الجيل الأول)) يُرجع المسافة بين مستشعر المسافة وأقرب جسم تم اكتشافه.

• object_distance — (VEX IQ Distance Sensor (2nd gen)) إرجاع المسافة بين مستشعر المسافة وأقرب كائن تم اكتشافه.

• object_velocity — (VEX IQ Distance Sensor (2nd gen)) تُرجع مدى سرعة تحرك الجسم المكتشف باتجاه أو بعيدًا عن مستشعر المسافة.

• object_size — (مستشعر المسافة VEX IQ (الجيل الثاني)) يُرجع الحجم المقدر للكائن المكتشف.

• installed — (مستشعر المسافة VEX IQ (الجيل الأول) أو (الجيل الثاني)) إرجاع ما إذا كان مستشعر المسافة مثبتًا ومتصلًا.

المنشئات — تهيئة وتكوين مستشعر المسافة يدويًا.

• Sonar — إنشاء مستشعر مسافة VEX IQ (الجيل الأول).

• Distance — إنشاء مستشعر مسافة VEX IQ (الجيل الثاني).

المحصلون

is_object_detected

is_object_detected تُرجع ما إذا كان مستشعر المسافة يكتشف حاليًا وجود جسم ضمن النطاق.

• True — مستشعر المسافة يكتشف وجود جسم.

• False — لا يكتشف مستشعر المسافة وجود جسم.

Usage:
distance_1.is_object_detected()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

# 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 تُرجع المسافة بين مستشعر المسافة وأقرب جسم تم اكتشافه كعدد عشري (float).

ملاحظة: هذه طريقة خاصة بمستشعر المسافة VEX IQ (الجيل الأول).

Usage:
distance_1.distance(units)

حدود	وصف
units	اختياري. وحدة المسافة: MM (افتراضي، من 24 مم إلى 1000 مم) أو INCHES (من 1 بوصة إلى 40 بوصة).

# 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 تُرجع المسافة بين مستشعر المسافة وأقرب كائن تم اكتشافه كعدد عشري (float).

ملاحظة: هذه طريقة خاصة بمستشعر المسافة VEX IQ (الجيل الثاني).

Usage:
distance_1.object_distance(units)

حدود	وصف
units	اختياري. وحدة المسافة: MM (افتراضي، من 20 مم إلى 2000 مم)، INCHES (من 0.78 بوصة إلى 78 بوصة)، أو DistanceUnits.CM (من 2 سم إلى 200 سم).

# 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 تُرجع السرعة النسبية للكائن المكتشف كعدد عشري (float) بوحدة م/ث (متر في الثانية).

تُظهر السرعة مدى سرعة تحرك الجسم باتجاه مستشعر المسافة أو ابتعاده عنه. تشير القيمة الموجبة إلى أن الجسم يتحرك باتجاه مستشعر المسافة، بينما تشير القيمة السالبة إلى أنه يتحرك بعيدًا عنه. أما القيمة القريبة من الصفر فتشير إلى أن الجسم لا يتحرك كثيرًا بالنسبة للمستشعر.

ملاحظة: هذه طريقة خاصة بمستشعر المسافة VEX IQ (الجيل الثاني).

Usage:
distance_1.object_velocity()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

# 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 تُرجع الحجم المُقدّر للكائن الذي تم اكتشافه بواسطة مستشعر المسافة.

يقوم مستشعر المسافة بتقدير حجم الجسم بناءً على مقدار مجال رؤية المستشعر الذي يشغله الجسم المكتشف.

• ObjectSizeType.NONE — لم يتم اكتشاف أي كائن.

• ObjectSizeType.SMALL — تم اكتشاف جسم صغير.

• ObjectSizeType.MEDIUM — تم اكتشاف كائن متوسط ​​الحجم.

• ObjectSizeType.LARGE — تم اكتشاف كائن كبير.

ملاحظة: هذه طريقة خاصة بمستشعر المسافة VEX IQ (الجيل الثاني).

Usage:
distance_1.object_size()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

installed

installed يُرجع ما إذا كان مستشعر المسافة مثبتًا ومتصلًا.

• True — تم تركيب مستشعر المسافة وتوصيله.

• False — مستشعر المسافة غير مثبت أو غير متصل.

Usage:
distance_1.installed()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

المُنشئون

Constructors are used to manually create Distance and Sonar objects, such as when configuring a Distance Sensor outside of VEXcode.

Sonar

Sonar يقوم بإنشاء كائن مستشعر المسافة VEX IQ (الجيل الأول).

Usage:
distance_1 = Sonar(smartport)

المعلمة	وصف
smartport	المنفذ الذكي الذي يتصل به مستشعر المسافة، مكتوبًا على النحو التالي: Ports.PORTx، حيث x هو رقم المنفذ.

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

Distance

Distance ينشئ كائن مستشعر المسافة VEX IQ (الجيل الثاني).

Usage:
distance_1 = Distance(smartport)

المعلمة	وصف
smartport	المنفذ الذكي الذي يتصل به مستشعر المسافة، مكتوبًا على النحو التالي: Ports.PORTx، حيث x هو رقم المنفذ.

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