{"id":48600406,"url":"https://github.com/cybergalactic/PythonVehicleSimulator","last_synced_at":"2026-04-24T15:01:10.992Z","repository":{"id":41854773,"uuid":"256510626","full_name":"cybergalactic/PythonVehicleSimulator","owner":"cybergalactic","description":"The Python Vehicle Simulator is software that supplements the textbook \"Handbook of Marine Craft Hydrodynamics and Motion Control,\" 2nd Edition, by T. I. Fossen, published in 2021 by John Wiley \u0026 Sons Ltd.","archived":false,"fork":false,"pushed_at":"2025-05-13T10:53:03.000Z","size":1076,"stargazers_count":259,"open_issues_count":0,"forks_count":64,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-05-23T19:01:40.904Z","etag":null,"topics":["autopilot","auv","control","control-systems","guidance","marine-systems-simulator","navigation","ship","simulation","simulator","underwater-robotics","underwater-vehicles","usv"],"latest_commit_sha":null,"homepage":"https://python.fossen.biz","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cybergalactic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-04-17T13:28:42.000Z","updated_at":"2025-05-22T23:36:16.000Z","dependencies_parsed_at":"2024-02-13T10:31:20.540Z","dependency_job_id":"2f1cf379-b5b0-494f-b6eb-8fec323dfbbb","html_url":"https://github.com/cybergalactic/PythonVehicleSimulator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cybergalactic/PythonVehicleSimulator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybergalactic%2FPythonVehicleSimulator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybergalactic%2FPythonVehicleSimulator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybergalactic%2FPythonVehicleSimulator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybergalactic%2FPythonVehicleSimulator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cybergalactic","download_url":"https://codeload.github.com/cybergalactic/PythonVehicleSimulator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybergalactic%2FPythonVehicleSimulator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32228437,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autopilot","auv","control","control-systems","guidance","marine-systems-simulator","navigation","ship","simulation","simulator","underwater-robotics","underwater-vehicles","usv"],"created_at":"2026-04-08T22:00:19.234Z","updated_at":"2026-04-24T15:01:10.987Z","avatar_url":"https://github.com/cybergalactic.png","language":"Python","funding_links":[],"categories":["Simulation Platforms"],"sub_categories":[],"readme":"# Python Vehicle Simulator\n\nThe Python Vehicle Simulator supplements the Matlab MSS (Marine Systems Simulator) toolbox. It includes models for autonomous underwater vehicles (AUVs), unmanned surface vehicles (USVs), and ships. The vehicle models are based on the MSS vessel models in /MSS/VESSELS/catalog. Each vehicle is modeled as an object in Python, and the vehicle class has methods for guidance, navigation, and control. The main program ```main.py``` defines vehicle objects for real-time simulation. \n\n    Root folder:\n    /src/python_vehicle_simulator/ \n        main.py                 - MAIN PROGRAM (terminal command \u003e\u003epython3 main.py)\n        3D_animation.gif        - 3D animation file that can be opened in a web browser by right-clicking the file   \n        \n    Library files:\n    /src/python_vehicle_simulator/lib/         \n        control.py              - feedback control systems\n        gnc.py                  - generic GNC functions\n        guidance.py             - guidance functions        \n        mainLoop.py             - main simulation loop\n        plotTimeSeries.py       - plotting and animation functions\n\n    Vehicle classes/methods: \n    /src/python_vehicle_simulator/vehicles/              \n        DSRV.py                 - Deep submergence rescue vehicle (DSRV) controlled by a stern plane, L = 5.0 m\n        frigate.py              - Frigate, rudder-controlled ship described by a nonlinear Nomoto model, L = 100.0 m\n        otter.py                - Otter unmanned surface vehicle (USV) controlled by two propellers, L = 2.0 m\n        ROVzefakkel.py          - ROV Zefakkel, rudder-controlled ship described by a nonlinear Nomoto model, L = 54.0 m\n        semisub.py              - Semisubmersible controlled by tunnel thrusters and main propellers, L = 84.5 m\n        shipClarke83.py         - Ship, linear maneuvering model specified by L, B and T using the Clarke (1983) formulas\n        supply.py               - Offshore supply vessel controlled by tunnel thrusters and main propellers, L = 76.2 m\n        tanker.py               - Tanker, rudder-controlled ship model including shallow water effects, L = 304.8 m\n        remus100.py             - Cylinder-shaped AUV controlled by a rudder, stern planes and a propeller, L = 1.6 m \n        torpedo.py              - Cylinder-shaped torpedo controlled by a rudder, stern planes and a propeller, L = 1.6 m         \n        \nFor more information about the mathematical modeling of marine craft and methods for guidance, navigation, and control, please consult:\n\nT. I. Fossen (2021). Handbook of Marine Craft Hydrodynamics and Motion Control. 2nd. Edition, Wiley. \nhttps://wiley.fossen.biz\n\n## Install:\nTo run the main program ```main.py``` the following modules must be installed:\n\n    numpy           https://numpy.org/install/\n    matplotlib      https://matplotlib.org/stable/users/installing.html\n    pytest          https://docs.pytest.org\n\nThese dependencies will be automatically installed using the following command:\n\n```pip install -e \u003cpath\u003e```\n\nwhere ```\u003cpath\u003e``` is the location of the downloaded or cloned PythonVehicleSimulator repository. \n\n####Example:\n\n1. Go to [https://github.com/cybergalactic/PythonVehicleSimulator](https://github.com/cybergalactic/PythonVehicleSimulator)\n2. Click the green Code button and choose Download ZIP\n3. Extract the ZIP file (you’ll get a folder like PythonVehicleSimulator-main, which you can rename it if desired).\n3. Open a terminal and run:\n```python3 -m pip install -e /MY_PATH/PythonVehicleSimulator-main`` \nReplace /MY_PATH/ with the actual path on your system.\n\n**Note:** \nThe -e option installs the simulator in editable mode, which allows you to modify the source files and immediately see changes. If you omit -e, you can still run the program, but changes to the code won’t take effect until you reinstall the package.\n\nTo run tests:\n\n\tpip install pytest\n\tpytest\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybergalactic%2FPythonVehicleSimulator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcybergalactic%2FPythonVehicleSimulator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybergalactic%2FPythonVehicleSimulator/lists"}