شبیهساز مسابقهی چوگان، ورزش تیمی سنتی ایران، برای رباتهای خودمختار. دو تیم، هر کدام با چهار ربات، در یک زمین مجازی با فیزیک واقعی بازی میکنند. پس از شروع مسابقه هیچ انسانی رباتها را کنترل نمیکند؛ همهچیز را کد Python شما تصمیم میگیرد و گل، خطا و زمان بهصورت خودکار و دقیق ثبت میشود.

هر تیم کدی مینویسد که چهار ربات آن را هدایت میکند. رباتهای تیم آبی B1 تا B4 و رباتهای تیم زرد Y1 تا Y4 نام دارند (در شبیهساز بهصورت قرمز و آبی نمایش داده میشوند). هر ربات GPS، قطبنما، چهار حسگر فاصله، گیرندهی توپ و فرستنده/گیرندهی تیمی دارد و فقط سرعت چرخ چپ و راست خودش را تعیین میکند. هیچ دکمهی «شوت» یا «پاس» وجود ندارد؛ هر تعامل با توپ فیزیکی است.
مسابقه دو نیمهی ۲ دقیقهای دارد. هر گل معتبر یک امتیاز است و تیمی که گل بیشتری بزند برنده است. امتیاز جداگانهای برای مالکیت توپ، پاس، زیبایی کد یا مصاحبه داده نمیشود؛ فقط نتیجهی مسابقه. تیمها در دو ردهی کاملاً جدای U14 و U19 بازی میکنند. در U14 یک قابلیت ویژه به نام Coach Board وجود دارد که در U19 نیست.
یک مسابقه کامل در شبیهساز رسمی CHOVGAN: دو تیم چهار رباتی، توپ، گلها و تابلوی امتیاز. این همان چیزی است که در روز مسابقه روی پرده دیده میشود.
تصاویر از نسخهی Windows شبیهساز (Showcase v1) و راهنمای دانشآموزی v1.3 گرفته شدهاند. برخی صفحهها هنوز نام قدیمی «CHOVGAN» را روی خود دارند؛ نام رسمی لیگ CHOVGAN است. ترتیب پیشنهادی یادگیری: Rules & Guide ← Robot Lab ← Training ← Competition.







این بخش برای کسی نوشته شده که هنوز هیچچیز نصب نکرده. مرحلهها را به ترتیب بروید؛ در پایان یک مسابقه یا پرواز واقعی با کد خودتان دیدهاید.
یک رایانهی ویندوزی ۶۴ بیتی (ویندوز ۱۰ یا ۱۱) با حدود یک گیگابایت فضای خالی، و یک ویرایشگر متن مثل VS Code یا Notepad++. Python لازم نیست نصب کنید، چون داخل خود شبیهساز هست. اینترنت فقط برای دانلود لازم است.
از بخش دانلود همین صفحه فایل CHOVGAN-1.0.0-windows-x86_64.zip را بگیرید. روی آن راستکلیک کنید و Extract All را بزنید تا در پوشهای مثل C:\CHOVGAN باز شود. داخل پوشه چیزی را جابهجا نکنید؛ CHOVGAN.exe باید کنار پوشههای python و sdk بماند.
روی CHOVGAN.exe دوبار کلیک کنید. نصب ندارد. اگر ویندوز پنجرهی آبی «Windows protected your PC» نشان داد، روی More info و بعد Run anyway بزنید. منوی اصلی با گزینههای Competition، Training، Robot Lab، Rules & Guide و Settings باز میشود. برای بار اول یک سر به Rules & Guide و Robot Lab بزنید تا زمین و ربات را ببینید.
از بخش دانلود فایل Chovgan-BaseCode.zip را بگیرید و آن را هم باز کنید، مثلاً در Documents\chovgan_base. پوشهی chovgan_team همان کد تیم شماست: robot1.py دروازهبان، robot2.py مدافع، robot3.py و robot4.py دو مهاجم. فایل robot.py فقط تشخیص میدهد هر ربات کدام فایل را اجرا کند و معمولاً لازم نیست به آن دست بزنید.
در شبیهساز Competition را بزنید و ردهی خود را انتخاب کنید (Select U14 یا Select U19). مرحلهی MATCH و TEAMS را پر کنید (نام دو تیم). در مرحلهی STRATEGY برای هر دو تیم روی Select team ZIP… بزنید و همان Chovgan-BaseCode.zip را بدهید. شبیهساز کد را بررسی میکند و زیر نام تیم باید VALID بنویسد. بعد READY و شروع مسابقه. اگر این مسابقه اجرا شد، همهچیز درست نصب شده.
پوشهی chovgan_team را در VS Code باز کنید (File → Open Folder). فایل robot3.py را باز کنید و یک چیز کوچک را عوض کنید، مثلاً سرعت حرکت را. ذخیره کنید. حالا باید دوباره ZIP بسازید: پوشهی chovgan_team و فایل team_name.txt را با هم انتخاب کنید، راستکلیک، Send to → Compressed (zipped) folder. این ZIP جدید را در مرحلهی STRATEGY بارگذاری کنید و مسابقه بدهید. هر بار که کد را عوض میکنید همین چرخه تکرار میشود: ویرایش، ذخیره، ZIP، بارگذاری.
در chovgan_team/robot.py عدد LESSON را ۱ بگذارید، دوباره ZIP بسازید و در Training → Movement اجرا کنید. هشت درس داریم: فرمانهای ساده مثل forward(2) و turn_left(90)، موتورها، حسگرها، قطبنما، GPS، سونار، توپ و پیام تیمی. توضیح هر کدام در آموزش از صفر است. برای مسابقه LESSON = 0 بگذارید.
همان ZIP مرحلهی قبل را تحویل میدهید: داخل آن پوشهی chovgan_team/ و فایل team_name.txt (نام تیم در یک خط) باید مستقیم در سطح اول باشد، نه داخل یک پوشهی دیگر. پوشهی local_runtime را داخل ZIP نگذارید. محل و مهلت آپلود در کانال کمیته فنی اعلام میشود.
اگر زیر نام تیم INVALID آمد، پیام خطا را بخوانید. معمولاً یکی از اینهاست: پوشه داخل پوشه در ZIP، فایل بازیکنی که حذف شده، یا خطای نگارشی در Python. ZIP را باز کنید و مطمئن شوید chovgan_team همان سطح اول است. اگر حل نشد، در کانال کمیته فنی با ذکر کد خطا بپرسید.
ChovganTeam.zip
chovgan_team/
robot.py # راهانداز: بازیکن درست را انتخاب میکند
chovgan_robot.py # کمکی مشترک ChovganRobot
robot1.py # بازیکن ۱
robot2.py # بازیکن ۲
robot3.py # بازیکن ۳
robot4.py # بازیکن ۴
utils.py # اختیاری: توابع مشترک
team_name.txt # نام تیم
logo.png # اختیاری
from controller import Robot
from robot1 import ChovganPlayer1
from robot2 import ChovganPlayer2
from robot3 import ChovganPlayer3
from robot4 import ChovganPlayer4
PLAYERS = {1: ChovganPlayer1, 2: ChovganPlayer2,
3: ChovganPlayer3, 4: ChovganPlayer4}
robot = Robot()
number = int(robot.getName()[1:]) # "B3" -> 3
player = PLAYERS[number](robot)
player.run()
robot.py آنها را درست import میکند؛ team_name.txt واقعاً متنی است (نه team_name.txt.txt)؛ ZIP بدون خطا باز میشود؛ پوشهی اضافی یا پوشهی controllers/ وجود ندارد؛ بستهی controller خود شبیهساز را داخل ZIP نگذاشتهاید.در جریان مسابقه، کلید Esc را بزنید تا منوی مکث (drawer) باز شود؛ در فهرست CAMERA هفت نما هست. میانبر صفحهکلید هم دارد: 1 Broadcast، 2 Sideline، 3 Spider، 4 Rider (سوار بر ربات)، 5 Behind Goal، 6 Tactical، 7 Free Camera. Space بازی را نگه میدارد و دوباره ادامه میدهد؛ Esc منو را باز و بسته میکند.







از منوی اصلی Training و بعد کاشی Movement را بزنید. با Import ZIP همان ZIP تیم را بدهید و Start را بزنید. هر چهار ربات با کد شما در زمین خالی (فقط توپ، بدون حریف) اجرا میشوند. دکمههای Reset (برگرداندن رباتها و توپ به جای اول)، Retry (اجرای دوبارهی همان کد) و Reload code (خواندن دوبارهی ZIP بعد از ویرایش) چرخهی ویرایش→تست را کوتاه میکنند. در پایان، نتیجه بهصورت یک فایل JSON (مسافت طیشده، تماس با توپ، خطاها) ذخیره میشود.
Robot Lab و بعد Open live sensor practice. یک ربات در زمین است و مقدار لحظهای GPS، قطبنما، سونارها و گیرندهی توپ کنار صفحه نشان داده میشود. با Motion Presets حرکتهای آماده (جلو، عقب، چرخش) و با Turning Test رابطهی سرعت چپ/راست با جهت چرخش را امتحان کنید؛ همینجا میفهمید «چپ بزرگتر از راست = چرخش ساعتگرد».
در Competition، مرحلهی STRATEGY پس از انتخاب ZIP کد را بررسی میکند: ساختار پوشه، importهای مجاز، و یک اجرای آزمایشی چهار ربات. زیر نام تیم VALID یا INVALID میآید. کدهای خطای رایج: MISSING_ENTRYPOINT (پوشهی chovgan_team/robot.py در سطح اول ZIP نیست)، IMPORT_ERROR (ماژولی خارج از فهرست مجاز مثل os یا numpy)، UNKNOWN_DEVICE (نام دستگاه اشتباه در getDevice)، PYTHON_SYNTAX_ERROR (خطای نگارشی؛ شمارهی خط در پیام هست). تا هر دو تیم VALID نباشند، READY فعال نمیشود.
در جریان مسابقه Esc و بعد Controller status. برای هر ربات (B1…B4 / Y1…Y4) وضعیت (RUNNING / CRASHED)، فایل اجراشده و آخرین خطوط خروجی print() کد شما دیده میشود. اگر رباتی کرش کند فقط همان ربات میایستد، بقیه ادامه میدهند و متن خطا (traceback) همینجا نشان داده میشود؛ پس print() گذاشتن در کد، سادهترین راه اشکالزدایی است.

team_name.txt خوانده شده.


print() هر هشت کنترلر؛ ربات کرشکرده با CRASHED و متن خطا مشخص میشود.

این یک فایل chovgan_team/robot.py کامل است که بهتنهایی کار میکند (به robot1.py تا robot4.py نیاز ندارد؛ هر چهار ربات همین فایل را اجرا میکنند). کار ربات: توپ را پیدا کن، پشت آن قرار بگیر و آن را به سمت دروازهی حریف هل بده. همین کد در اعتبارسنج شبیهساز VALID است و برای هر دو ردهی U14 و U19 عیناً قابل استفاده است.
# سادهترین کد پایهی CHOVGAN: دنبال توپ برو و آن را به سمت دروازهی حریف هل بده
import json, math
from controller import Robot
robot = Robot()
team = robot.getName()[0] # "B" یا "Y"
left = robot.getDevice("left wheel motor") # موتور چپ
right = robot.getDevice("right wheel motor") # موتور راست
gps = robot.getDevice("gps") # موقعیت [x, y, h]
compass = robot.getDevice("compass") # قطبنما
ball = robot.getDevice("ball receiver") # گیرندهی توپ
referee = robot.getDevice("supervisor receiver") # پیامهای داور
for device in (gps, compass, ball, referee):
device.enable(32)
left.setPosition(float("inf")) # حالت سرعتی موتورها
right.setPosition(float("inf"))
attack_x = -52.5 if team == "B" else 52.5 # دروازهی حریف (تا پیام داور برسد)
ball_x, ball_y = None, None
while robot.step(32) != -1:
x, y, _h = gps.getValues() # کجا هستم؟
v = compass.getValues()
heading = math.atan2(v[0], v[1]) + math.pi / 2 # به کدام سمت نگاه میکنم؟
while referee.getQueueLength() > 0: # پیام داور: کدام دروازه مال حریف است؟
msg = json.loads(referee.getString() or "{}")
referee.nextPacket()
if msg.get("type") == "chovgan.match_state.v1" and "attack_x" in msg:
attack_x = float(msg["attack_x"][team])
while ball.getQueueLength() > 0: # توپ را میبینم؟
d = ball.getEmitterDirection() # [جلو, چپ, بالا]
dist = 1.0 / math.sqrt(ball.getSignalStrength()) # قدرت سیگنال = 1/d²
ball.nextPacket()
angle = heading + math.atan2(d[1], d[0])
ball_x, ball_y = x + dist * math.cos(angle), y + dist * math.sin(angle)
if ball_x is None: # هنوز توپ را ندیدهام: بایست
left.setVelocity(0.0); right.setVelocity(0.0)
continue
to_goal = math.atan2(0.0 - ball_y, attack_x - ball_x) # جهت توپ به دروازه
tx, ty = ball_x - 3.0 * math.cos(to_goal), ball_y - 3.0 * math.sin(to_goal)
if math.hypot(x - tx, y - ty) < 2.0: # پشت توپ هستم: به سمت دروازه هل بده
tx, ty = attack_x, 0.0
turn = math.atan2(ty - y, tx - x) - heading # چقدر باید بچرخم؟
turn = math.atan2(math.sin(turn), math.cos(turn)) # بین -π و π
speed = 10.0 if abs(turn) < 0.6 else 2.0 # تا رو به هدف نشدهام آرام برو
turn = max(-6.0, min(6.0, 4.0 * turn))
left.setVelocity(max(-10.0, min(10.0, speed - turn))) # چپ>راست = چرخش ساعتگرد
right.setVelocity(max(-10.0, min(10.0, speed + turn)))
Robot() ربات را میسازد و getName()[0] حرف تیم را میدهد (B آبی، Y زرد). با getDevice دو موتور، GPS، قطبنما، گیرندهی توپ و گیرندهی داور گرفته و با enable(32) روشن میشوند (۳۲ میلیثانیه = یک گام شبیهساز). setPosition(inf) موتورها را به حالت «سرعتی» میبرد تا بعداً فقط setVelocity بین −۱۰ و +۱۰ بدهیم. attack_x مختصات x دروازهی حریف است؛ مقدار اولیه برای نیمهی اول حدس زده شده و با اولین پیام داور درست میشود.
robot.step(32) یک گام شبیهساز جلو میرود؛ وقتی −۱ برگرداند مسابقه تمام شده. gps.getValues() سه عدد [x, y, h] میدهد (x در طول زمین، y در عرض، h ارتفاع). قطبنما سه عدد میدهد و فرمول atan2(v[0], v[1]) + π/2 جهت نگاه ربات را به رادیان برمیگرداند.
گیرندهی supervisor receiver صف پیامهای JSON داور است. پیام نوع chovgan.match_state.v1 کلید attack_x دارد: attack_x["B"] و attack_x["Y"]، یعنی x دروازهای که هر تیم باید به آن حمله کند. بعد از نیمه، زمین عوض میشود و این عدد قرینه میشود؛ چون هر بار آن را میخوانیم، ربات خودبهخود جهت درست را میگیرد. (شرط "attack_x" in msg لازم است چون در اجرای آزمایشی اعتبارسنج، پیام اولیه این کلید را ندارد.)
گیرندهی توپ هر گام یک «مشاهده» در صف میگذارد. getEmitterDirection() بردار [جلو, چپ, بالا] نسبت به بدنهی ربات است و getSignalStrength() برابر 1/d²؛ پس فاصله d = 1/√strength. زاویهی توپ نسبت به ربات atan2(چپ, جلو) است؛ با جمعکردن آن با جهت ربات و ضرب در فاصله، مختصات جهانی توپ (ball_x, ball_y) به دست میآید.
اگر هنوز توپ دیده نشده، ربات میایستد. وگرنه جهت «توپ → دروازهی حریف» را حساب میکند و نقطهای ۳ متر پشت توپ (سمت مخالف دروازه) را هدف میگیرد. وقتی به ۲ متری آن نقطه رسید، هدف را خود دروازه میکند: با حرکت رو به دروازه، توپ که جلوی ربات است هل داده میشود.
turn اختلاف زاویهی هدف با جهت فعلی است (نرمالشده بین −π و π). اگر تقریباً رو به هدفیم با سرعت ۱۰ میرویم، وگرنه آرام (۲) تا اول بچرخیم. به موتور چپ speed − turn و به راست speed + turn داده میشود: اگر هدف سمت چپ باشد (turn مثبت) موتور راست تندتر میچرخد و ربات به چپ میپیچد؛ «چپ بزرگتر از راست = چرخش ساعتگرد». max/min مقدار را در بازهی مجاز −۱۰ تا ۱۰ نگه میدارد.

robot.getName() به هر شماره نقش متفاوتی بدهید تا همه روی توپ جمع نشوند.)در ردهی U14 مربی میتواند پیش از مسابقه و در جریان آن از Coach Board برنامه (playbook) را تغییر دهد. شبیهساز این برنامه را بهصورت پیام chovgan.coach.plan.v1 در همان supervisor receiver میفرستد. شش خط زیر را به کد بالا اضافه کنید (کد با این خطوط هم در اعتبارسنج VALID است):
# ۱) قبل از حلقهی اصلی، کنار ball_x, ball_y:
playbook = "BALANCED" # U14: برنامهی مربی (ATTACK / BALANCED / DEFEND)
# ۲) داخل حلقهی پیام داور، بعد از شرط match_state:
if msg.get("type") == "chovgan.coach.plan.v1" and msg.get("team") == team:
playbook = msg.get("settings", {}).get("playbook", "BALANCED") # فقط U14
# ۳) بعد از خط speed = ... :
if playbook == "DEFEND" and abs(x - attack_x) < 60.0: # DEFEND: جلوتر از وسط زمین نرو
tx, ty = -attack_x * 0.5, 0.0; turn = math.atan2(math.sin(math.atan2(ty - y, tx - x) - heading), math.cos(math.atan2(ty - y, tx - x) - heading))
speed = speed if playbook != "ATTACK" else 10.0 # ATTACK: همیشه تمامسرعت
ATTACK: ربات حتی هنگام چرخش با سرعت کامل (۱۰) میرود. DEFEND: اگر ربات از وسط زمین به دروازهی حریف نزدیکتر شده باشد، به جای توپ به نقطهای در نیمهی خودی (نزدیک دروازهی خودمان) برمیگردد. BALANCED: همان رفتار کد پایه. پیامهای مربی فقط برای تیم خودتان میآید (msg["team"] == team).
chovgan.coach.plan.v1 نمیفرستد؛ این شش خط در U19 بیاثر میمانند و ضرری هم ندارند، پس میتوانید یک کد را برای هر دو رده نگه دارید.
chovgan_team/ (فقط با همین robot.py) و فایل team_name.txt (نام تیم در یک خط) را با هم انتخاب و ZIP کنید. همین ZIP را هم در Training → Movement تست میکنید، هم در مرحلهی STRATEGY بارگذاری میکنید و هم تحویل میدهید. نبود robot1.py تا robot4.py فقط یک هشدار (warning) است، نه خطا.ربات با دو موتور (چپ و راست، سرعت −۱۰ تا +۱۰) راه میرود و میچرخد و با هل دادن توپ آن را جلو میبرد؛ دستور «شوت» ندارد. همهی اینها را با Python و دستور robot.getDevice("نام حسگر") میخوانید؛ جزئیات هر کدام در جدول پایین است.
هر ربات با robot.getDevice("نام") به این دستگاهها دسترسی دارد. نامها را دقیقاً همینطور بنویسید. حسگرها را با enable(32) روشن کنید و بعد از هر robot.step(32) مقدار جدید بخوانید.
left wheel motor / right wheel motorدو درایو مجازی ربات چهارپا. اول setPosition(float("inf")) (حالت سرعتی)، بعد setVelocity(v) با v بین −10 تا +10. دو سرعت برابر مثبت = جلو، برابر منفی = عقب، چپ بزرگتر از راست = چرخش ساعتگرد، سرعت نابرابر = مسیر منحنی. فرمان ۱۰ ≈ ۱۴ متر بر ثانیه؛ فرمان ۰ در حدود نیم ثانیه ترمز میکند.
gpsgetValues() → [x, y, height] به متر. زمین ۱۰۵×۶۸ متر است؛ x از −52.5 تا +52.5 در طول زمین، y از −34 تا +34 در عرض، مبدأ وسط زمین. دروازهها در x = ±52.5 (عرض ۱۱ متر).
compassgetValues() سه عدد میدهد؛ جهت ربات (رادیان) = math.atan2(v[0], v[1]) + math.pi/2: صفر یعنی رو به +x، π/2 یعنی رو به +y.
distancesensor front / back / left / rightgetValue() عددی بین ۰ تا ۱۰۰۰: ۰ یعنی برخورد، ۱۰۰۰ یعنی تا ۱۰ متر چیزی نیست (۳۰۰ ≈ ۳ متر). رباتهای دیگر و توپ مانع حساب میشوند.
ball receiverدر هر گام یک مشاهده در صف میگذارد: getQueueLength()، getEmitterDirection() → بردار واحد [جلو، چپ، بالا] نسبت به خود ربات، getSignalStrength() = ۱/فاصله² (۰٫۰۱ ≈ ۱۰ متر، ۰٫۱۱ ≈ ۳ متر؛ فاصله = 1/math.sqrt(strength))، و بعد nextPacket().
team emitter / team receiversend(text) پیام (حداکثر ۴۰۹۶ بایت، ۸ پیام در هر گام) را فقط به سه همتیمی میرساند؛ گیرنده صف FIFO است: getQueueLength() / getString() / nextPacket(). تیم حریف هرگز پیام شما را نمیگیرد.
supervisor receiver (فقط خواندنی)رشتههای JSON: chovgan.match_state.v1 (وضعیت بازی، نیمه، زمان باقیمانده، نتیجه و attack_x هر تیم = دروازهای که باید به آن حمله کنید؛ نیمهها عوض میشوند) و chovgan.referee.v1 (گل، گلبهخودی، پرتاب، عدم پیشرفت…). در U14 پیام chovgan.coach.plan.v1 تخته مربی هم از همینجا میآید.
robot.getName() → B1…B4 یا Y1…Y4 (از طرف شبیهساز)، robot.getTime() → زمان شبیهسازی به ثانیه، robot.step(32) → یک گام ۳۲ میلیثانیهای مشترک برای هر هشت ربات (−1 یعنی پایان).
kick() وجود ندارد. ماژولهای مجاز: فایلهای خودتان در chovgan_team/ + کتابخانهی استاندارد (math، json، random، collections، …)؛ os/sys/socket بستهاند.برای شبیهساز CHOVGAN 1.0.0. همین ZIP مستقیم در شبیهساز بارگذاری میشود. ربات را با فرمانهای ساده خطبهخط تکان میدهید و با یک عدد در robot.py بین درسها و تیم کامل جابهجا میشوید. آموزش خطبهخط در صفحهی آموزش از صفر و طرح درس جلسهبهجلسه پایین همین صفحه است.
LESSON | چه یاد میگیرید |
|---|---|
| ۱ | فرمانهای ساده: forward، turn_left، turn_right، backward، wait |
| ۲ | زیر فرمانها: دو موتور چپ و راست و حلقهی اصلی |
| ۳ | همهی حسگرها: GPS، قطبنما، چهار سونار، توپ، جهت حمله |
| ۴ | قطبنما: چرخش دقیق با turn_to |
| ۵ | GPS: رفتن به هر نقطه با drive_to |
| ۶ | سونار: قبل از برخورد بایست و دور بزن |
| ۷ | توپ: پشت توپ برو و به دروازه هل بده |
| ۸ | پیام تیمی: فقط نزدیکترین ربات سراغ توپ میرود |
| ۰ | تیم کامل: دروازهبان، مدافع، مهاجم اول، مهاجم کناری |
در chovgan_team/robot.py عدد LESSON را بگذارید، chovgan_team و team_name.txt را ZIP کنید و در Training → Movement با Import ZIP اجرا کنید. خروجی print هر ربات در Esc → Controller status دیده میشود.
هر هشت درس و تیم کامل در خود شبیهساز اجرا شدند: هشت کنترلر فعال، بدون خطا. چرخشهای turn_to با خطای کمتر از ۳ درجه و drive_to به همهی نقطهها رسید. اعتبارسنج رسمی ZIP را VALID میداند. بدون کد، رباتها هیچ حرکتی ندارند.
class Lesson1Commands(ChovganRobot):
def run(self):
self.wait(0.5) # حسگرها اولین عددشان را بگیرند
self.turn_to(180) # رو به -x، جای خالی
self.forward(2) # ۲ ثانیه جلو
self.turn_left(90) # ۹۰ درجه به چپ
self.forward(1.5)
self.turn_right(90) # ۹۰ درجه به راست
self.backward(1) # ۱ ثانیه عقب
self.forward(t, speed=5) self.backward(t)
self.turn_left(d) self.turn_right(d)
self.turn_to(h) # 0=+x 90=+y 180=-x -90=-y
self.drive_to(x, y) self.wait(t) self.stop()
self.set_motors(left, right) # -10 .. 10
self.position() # GPS (x, y) متر
self.heading_deg() # قطبنما، درجه
self.distance("front") # سونار، متر
self.ball_distance() self.ball_angle()
self.ball_position() self.attack_x
bx, by = self.ball_position()
to_goal = math.atan2(0 - by, self.attack_x - bx)
behind = (bx - 4 * math.cos(to_goal), by - 4 * math.sin(to_goal))
self.drive_to(*behind)
self.turn_to(math.degrees(to_goal))
self.forward(1.5, speed=10)
هر جلسه حدود ۹۰ دقیقه است و دقیقاً یکی از درسهای کد پایه (عدد LESSON در chovgan_team/robot.py) را دنبال میکند. همهی کدها با Python نوشته شدهاند و در خود شبیهساز CHOVGAN 1.0.0 اجرا و آزمایش شدهاند. U14 میتواند جلسههای ۱ تا ۸ را آرامتر و با تمرین بیشتر جلو ببرد؛ U19 همهی جلسهها را کار میکند. آموزش خطبهخط هر درس در صفحهی «آموزش از صفر» و در فایل TUTORIAL-FA.md داخل کد پایه است.
شبیهساز را نصب و اجرا کنند، کد پایه را بارگذاری کنند و یک مسابقهی کامل را از شروع تا نتیجه ببینند.
CHOVGAN-1.0.0-windows-x86_64.zip را باز کنید و CHOVGAN.exe را اجرا کنید. Python جدا لازم نیست.Chovgan-BaseCode.zip را دانلود کنید. Competition → رده → نام تیمها → در STRATEGY همین ZIP را برای هر دو تیم بدهید → READY.آبی در نیمهی اول به کدام دروازه حمله میکند؟ بعد از نیمه چه میشود؟ چرا بدون ZIP بازی شروع نمیشود؟
با فرمانهای ساده یک برنامهی ترتیبی بنویسند و ببینند هر خط دقیقاً چه کاری میکند.
forward(t) و backward(t): به مدت t ثانیه مستقیم جلو یا عقب. ربات با قطبنما جهتش را نگه میدارد.turn_left(d) و turn_right(d): به اندازهی d درجه در جا بچرخ.wait(t): t ثانیه بایست. اول برنامه wait(0.5) میگذاریم تا حسگرها اولین عددشان را بگیرند.chovgan_team/robot.py بنویسید LESSON = 1، پوشهی chovgan_team و team_name.txt را ZIP کنید.forward(3)، turn_left(45). بعد از هر تغییر Reload code بزنید.self.wait(0.5)
self.turn_to(180)
self.forward(2)
self.turn_left(90)
self.forward(1.5)
self.turn_right(90)
self.backward(1)
اگر forward(2) را به forward(4) تغییر دهیم چه میشود؟ چرا اول wait(0.5) لازم است؟
بفهمند forward و turn در واقع دو عدد سرعت برای دو موتور هستند و حلقهی step چطور زمان را جلو میبرد.
robot.step(32) زمان بازی را ۳۲ میلیثانیه جلو میبرد. در کد پایه self.tick() همین کار را میکند و حسگرها را هم تازه نگه میدارد.LESSON = 2 و اجرا. هر تغییر حرکت در Controller status چاپ میشود.self.left.setVelocity(5) # موتور چپ
self.right.setVelocity(5) # موتور راست: هر دو برابر = جلو
self.tick() # ۳۲ میلیثانیه جلو برو
سرعت چپ ۶ و راست ۳: ربات به کدام سمت قوس میزند؟ چرا؟
هر حسگر را بخوانند، واحدش را بدانند و بگویند برای چه کاری مفید است.
position() جای ربات به متر. قطبنما: heading_deg() جهت ربات؛ ۰ = رو به +x، ۹۰ = رو به +y.distance("front") و back، left، right. فاصله تا نزدیکترین ربات، توپ یا مانع، تا ۱۰ متر.ball_angle(): زاویهی توپ نسبت به دماغه؛ مثبت = سمت چپ. ball_position(): جای توپ در زمین.LESSON = 3 و اجرا. یک جدول بکشید: هر حسگر، عددی که دیدید، واحد، کاربرد.ball_angle() منفی ۹۰ باشد توپ کجاست؟x, y = self.position()
h = self.heading_deg()
front = self.distance("front")
d = self.ball_distance()
a = self.ball_angle()
قدرت سیگنال توپ ۰.۰۴ است. توپ چند متر دور است؟ (جواب: ۵ متر)
با خطای زاویه و کنترل تناسبی ربات را دقیقاً رو به یک جهت بچرخانند.
turn_to(۰) رو به +x، turn_to(۹۰) رو به +y، turn_to(۱۸۰) رو به -x، turn_to(-90) رو به -y. در آزمایش ما خطا کمتر از ۳ درجه بود.LESSON = 4 و اجرا. heading بعد از هر turn_to را با هدف مقایسه کنید.chovgan_robot.py ضریب ۴.۰ تابع turn_to را ۱.۰ و بعد ۱۰ کنید و فرقش را ببینید.for heading in (180, -90, 0, 90):
self.turn_to(heading)
self.forward(1.5)
جهت فعلی ۱۷۰ و هدف -170 است. خطای زاویه چند درجه و ربات به کدام سمت بچرخد؟
ربات را با GPS و قطبنما به هر نقطهی زمین بفرستند و گشت بزنند.
atan2(ty - y, tx - x).LESSON = 5 و اجرا. پیام arrived هر ربات را در Controller status ببینید.home = -self.attack_sign # نیمهی خودی
self.drive_to(home * 13, y)
self.drive_to(home * 31, y)
ربات در (0, 0) است و رو به +x. نقطهی (0, 10) در چه جهتی است و ربات اول چند درجه باید بچرخد؟
با if و else روی عدد سونار تصمیم بگیرند: جلو برو یا بایست و بچرخ.
distance("front") کمتر از SAFE متر = چیزی جلوی ماست.LESSON = 6 و اجرا. پیام obstacle هر ربات را بخوانید.distance("back")) چه کند؟if self.distance("front") > 3.0:
self.set_motors(5, 5)
self.tick()
elif self.distance("left") >= self.distance("right"):
self.turn_left(60)
else:
self.turn_right(60)
سونار جلو ۲، چپ ۸ و راست ۳ است. ربات چه میکند؟
جای توپ را حساب کنند و توپ را به سمت دروازهی حریف هل بدهند، نه به هر سمتی.
atan2(0 - by, attack_x - bx). نقطهی پشت توپ ۴ متر در خلاف همین جهت است.LESSON = 7 و اجرا (فقط ربات ۳ بازی میکند).bx, by = self.ball_position()
to_goal = math.atan2(0 - by, self.attack_x - bx)
behind = (bx - 4 * math.cos(to_goal), by - 4 * math.sin(to_goal))
self.drive_to(*behind)
self.turn_to(math.degrees(to_goal))
self.forward(1.5, speed=10)
توپ در (10, 0) است و attack_x = -52.5. نقطهی پشت توپ کجاست؟ (جواب: (14, 0))
با فرستادن و خواندن پیام JSON کار را بین رباتها تقسیم کنند.
json.dumps یک دیکشنری را به متن تبدیل میکند و json.loads برعکس. self.inbox پیامهای رسیده است.LESSON = 8 و اجرا. ببینید فقط یک ربات سراغ توپ میرود.self.team_emitter.send(json.dumps({"robot": self.name, "dist": mine}))
for msg in self.inbox:
distances[msg["robot"]] = msg["dist"]
اگر همهی رباتها پیام بفرستند ولی هیچکدام inbox را نخوانند چه میشود؟
کد تیم کامل را بخوانند و برای هر نقش اولین بهبود را بدهند.
robot1.py دروازهبان: جلوی دروازهی خودی میماند و با توپ چپ و راست میرود؛ اگر توپ نزدیک شد دورش میکند.robot2.py مدافع: وسط نیمهی خودی؛ اگر توپ نزدیکتر از ۹ متر شد سراغش میرود.robot3.py مهاجم: پشت توپ و هل به دروازه. robot4.py مهاجم کناری: وقتی ۳ نزدیکتر است، جلوتر و آن طرف زمین منتظر میماند.LESSON = 0 یعنی تیم کامل. در آزمایش ما مقابل تیم ایستای تمرینی ۱ بر ۰ برد و مقابل تیم تمرینی رسمی ۰ بر ۱ باخت.LESSON = 0 و در Training مقابل حریف Baseline بازی کنید.نقش هر ربات را با یک جمله توضیح دهید. کدام نقش بیشترین اثر را روی گل خوردن دارد؟
با آزمایشهای تکرارپذیر کد تیم را بهتر کنند. U14 تابلوی مربی را به کد وصل کند.
chovgan.coach.plan.v1 در self.coach_playbook (ATTACK، BALANCED یا DEFEND). در U19 این پیام نمیآید.if self.coach_playbook == "DEFEND":
home = -self.attack_sign * 20
self.drive_to(home, 0)
گزارش کوتاه: چه چیزی را عوض کردید، چرا، و نتیجه چه شد؟
ZIP تحویلی درست بسازند و در یک مسابقهی آزمایشی شرکت کنند.
LESSON = 0 باشد. ZIP فقط chovgan_team/ و team_name.txt را در سطح اول دارد.روبریک: اجرا و عملکرد ۴۰٪، درک مفاهیم ۳۰٪، کار تیمی و پیامها ۱۵٪، تحلیل و بهبود ۱۵٪.
"gps" "compass"
"ball receiver" "supervisor receiver"
"team emitter" "team receiver"
"distancesensor front" "distancesensor back"
"distancesensor left" "distancesensor right"
"left wheel motor" "right wheel motor"
TIME_STEP = 32 ms | motor speed: -10 .. +10 | team message <= 4096 bytes
این خلاصه برای فهم سریع است؛ متن کامل و رسمی را از بخش دانلود بگیرید. در صورت اختلاف، آخرین نسخهی رسمی منتشرشده توسط کمیته فنی معتبر است.
بهروزترین نسخهی فایلها همیشه ابتدا در کانال کمیته فنی منتشر میشود.
ربات چوگان یک ربات چهارپای مجازی است که با Python هدایت میشود. چشم و گوشش اینهاست:
و دست و پایش: دو موتور (چپ و راست، سرعت −۱۰ تا +۱۰) برای رفتن و چرخیدن؛ توپ را با هل دادن جلو میبرد و دستور شوت جداگانه ندارد. دوربین، لیدار یا GPS دقیقتر ندارد؛ همهی تصمیمها از همین چند عدد گرفته میشود. جزئیات و نام دقیق هر دستگاه در بخش سنسورها.
خلاصهی همهفهم؛ جزئیات فنی در بخش «شروع از صفر» است.
ربات چوگان یک ماشین کوچک دوچرخ است. شما فقط سرعت چرخ چپ و راستش را تعیین میکنید (از −۱۰ تا +۱۰). دکمهی شوت یا پاس ندارد؛ توپ را با هل دادن جلو میبرد. برای تصمیمگیری شش چیز «میفهمد»:
از اینها چطور استفاده میکند؟ با GPS و قطبنما جهت دروازه و توپ را حساب میکند (هندسهی ساده: فاصله و زاویه)، با حسگرهای فاصله به دیوار و همتیمی نمیخورد، با گیرندهی توپ دنبال توپ میرود، با پیام تیم نقشها را تقسیم میکند (چه کسی حمله کند، چه کسی دفاع) و با پیام داور میفهمد نیمه عوض شده یا بازی متوقف است. همهی اینها با Python و دستور robot.getDevice("نام") خوانده میشود و کد پایهی پایین صفحه نمونهی کاملش را دارد.
برای دریافت فایلها، اطلاعیهها و پرسیدن سؤال از کمیته فنی جوین شوید.