Package: machathon-judge
Machathon4.0-JudgeThe Machathon4.0 Judge repository provides all the required tools and utilities for theMachathon4.0 Competition - self driving cars edition. It features convenient wrapper functions for controlling the movement of the car and capturing images from the camera within the CoppeliaSim simulator. It also includes the judge code that evaluates the competitor's solution and updates the leader-board.This project can be found inthe following repository.For more information about the competition regulations, please refer to the Official CompetitionRules Book.InstallationClone the repositrygit clone https://github.com/NouranHany/Machathon4.0-Judge.gitNavigate to the repository directorycd Machathon4.0-JudgeInstall all dependencies neededpip install -r requirements.txtPreparation for running the codeBefore running your code, it's important to make sure you have opened thefilteration_scene.tttin CoppeliaSim. Here are the steps to follow:Open CoppeliaSim.Load thefilteration_scene.tttfile by going to File > Open Scene > Browse, then navigating to the location where the scene file is stored.How to Use the Judge?Create an instance of the Judge class and provide your team information, including the team name, team code, and the path to a zip containing your code.judge=Judge(team_name="TeamX",team_code="9digit_team_code",code_file_paths=['your_solution.zip'])Pass the function where you have written your main solution to the judge. For example, if your solution is in a function named run_car, use the following code:judge.set_run_hook(run_car)Call the judge to run your code. The judge will call your code twice and calculate the lap time for each run. If you choose to publish the lap time to the leaderboard, set thesend_scoreparameter toTrue.judge.run(send_score=True)The providedtest.pyfile demonstrates how to use the Judge class. Note: don't submit your solution using this script as it uses the keyboard to manually control the car which is against the rules.Note for Ubuntu usersThe test.py script uses the keyboard library which requires running "sudo", so replace "pip3" with "sudo pip3" and "python3" with "sudo python3". This is only needed for the test.pyProject Hierarchy└── Machathon4.0-Judge/
    ├── machathon_judge/
    │   ├── data.py  # contains important variables that are used throughout the project
    │   ├── judge.py # Module containing the Judge class to run the competition's tracks and publish the scores to the leaderboard
    |   ├── collision_manager.py # Module containing the CollisionManager class to manage the collision events
    │   ├── simulator.py  # Wrapper for the API that connects CoppeliaSim and Python
    │   └── filteration_scene.ttt  # The competition environment in CoppeliaSim, which includes the track and the vehicle
    ├── test.py  # Demonstrates how to utilize the competition judge and simulator classes
    └── requirements.txtAttributionThis code was developed and maintained by Step Towards Progress STP, a non-profit organization focuses on developing youth in various fields personally and technically through academic programs, projects, and events. You can find more information about STP at https://stp-org.com/If you have any questions or would like to get in touch with our team, please email us atstp23.official@gmail.comor find us onFacebook.