Metadata-Version: 2.1
Name: wa_simulator
Version: 0.0.6.dev0
Summary: Simulation tool for prototyping autonomous vehicle related algorithms. Wrapper of the PyChrono simulator.
Home-page: UNKNOWN
Author: Wisconsin Autonomous
Author-email: wisconsinautonomous@studentorg.wisc.edu
License: BSD3
Project-URL: Homepage, https://github.com/WisconsinAutonomous/wa_simulator/
Project-URL: Documentation, https://WisconsinAutononomous.github.io/wa_simulator
Project-URL: Bug Reports, https://github.com/WisconsinAutonomous/wa_simulator/issues
Project-URL: Source Code, https://github.com/WisconsinAutonomous/wa_simulator/
Project-URL: Our Team!, https://wisconsinautonomous.org
Description: # WA Vehicle Simulator
        
        The WA Simulator is a powerful, multi-platform, lightweight and *user-friendly* simulation platform for testing algorithms intended for autonomous robot or vehicle applications.
        This project is under active development by [Wisconsin Autonomous](https://wisconsinautonomous.org/), a student organization at the University of Wisconsin - Madison.
        
        ## Usage
        
        The WA Simulator is a lightweight tool meant to facilitate algorithm development. As a result, the majority of the actual vehicle dynamics is hidden behind the wa_simulator API. All you need to do is import the module and instantiate the classes.
        
        ### Default Usage
        
        ```python
        # Import the wa_simulator
        import wa_simulator as wa
        
        def main():
            # Create the system
            sys = wa.WASystem(step_size=1e-3)
        
            # Create an environment using a premade environment description
            env_filename = wa.WASimpleEnvironment.EGP_ENV_MODEL_FILE
            env = wa.WASimpleEnvironment(env_filename, sys)
        
            # Create an vehicle using a premade vehicle description
            veh_filename = wa.WALinearKinematicBicycle.GO_KART_MODEL_FILE
            veh = wa.WALinearKinematicBicycle(veh_filename)
        
            # Visualize the simulation using matplotlib
            vis = wa.WAMatplotlibVisualization(veh, sys)
        
            # Control the vehicle using the arrow keys
            ctr = wa.WAMatplotlibController(sys, vis)
        
            # Instantiate the simulation manager
            sim = wa.WASimulation(sys, env, veh, vis, ctr)
        
            # Run the simulation
            sim.Run()
        
        
        if __name__ == "__main__":
            main()
        ```
        
        ### With Chrono
        
        Using Chrono is as simple as changing a few file names and importing the chrono version of the simulator. Even though `wa_simulator.chrono` is the new import, all default `wa_simulator` classes are still accessible as seen above. [Background about Chrono can be found here](https://wisconsinautonomous.github.io/wa_simulator/background.html#ProjectChrono).
        
        ```python
        # Import the wa_simulator
        import wa_simulator.chrono as wa
        
        def main():
            # Create the system
            sys = wa.WAChronoSystem(step_size=1e-3)
        
            # Create an environment using a premade environment description
            env_filename = wa.WAChronoEnvironment.EGP_ENV_MODEL_FILE
            env = wa.WAChronoEnvironment(env_filename, sys)
        
            # Create an vehicle using a premade vehicle description
            veh_filename = wa.WAChronoVehicle.GO_KART_MODEL_FILE
            veh = wa.WAChronoVehicle(veh_filename)
        
            # Visualize the simulation using matplotlib
            vis = wa.WAMatplotlibVisualization(veh, sys)
        
            # Control the vehicle using the arrow keys
            ctr = wa.WAMatplotlibController(sys, vis)
        
            # Instantiate the simulation manager
            sim = wa.WASimulation(sys, env, veh, vis, ctr)
        
            # Run the simulation
            sim.Run()
        
        
        if __name__ == "__main__":
            main()
        ```
        
        ## Documentation
        
        - [Home](https://wisconsinautonomous.github.io/wa_simulator/index.html)
        - [Background](https://wisconsinautonomous.github.io/wa_simulator/background.html)
        - [Installation](https://wisconsinautonomous.github.io/wa_simulator/install.html)
        - [API Reference](https://wisconsinautonomous.github.io/wa_simulator/autoapi/wa_simulator/index.html)
        - [PyPI](https://pypi.org/project/wa-simulator/)
        - [Github](https://github.com/WisconsinAutonomous/wa_simulator)
        
        ## License 
        `wa_simulator` is made available under the BSD-3 License. For more details, see [LICENSE](https://github.com/WisconsinAutonomous/wa_simulator/blob/develop/LICENSE).
        
        ## Support
        
        Contact [Aaron Young](mailto:aryoung5@wisc.edu) for any questions or concerns regarding the contents of this repository.
        
        ## See Also
        
        Stay up to date with our technical info by following our [blog](https://www.wisconsinautonomous.org/blog).
        
        Follow us on [Facebook](https://www.facebook.com/wisconsinautonomous/), [Instagram](https://www.instagram.com/wisconsinautonomous/), and [LinkedIn](https://www.linkedin.com/company/wisconsin-autonomous/about/)!
        
        <br>
        
        <div>
        	<img src="https://github.com/WisconsinAutonomous/wa-resources/blob/master/Images/WA.png?raw=true" alt="Wisconsin Autonomous Logo" class="readme-img" height="100px">  
        	<img src="https://github.com/WisconsinAutonomous/wa-resources/blob/master/Images/UWCrest.png?raw=true" alt="University of Wisconsin - Madison Crest" class="readme-img" height="100px" align="right">
        </div>
Keywords: simulation,autonomous vehicles,robotics
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Software Development
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.0
Description-Content-Type: text/markdown
