| Name | rotorpy JSON |
| Version |
1.1.1
JSON |
| download |
| home_page | None |
| Summary | A multirotor simulator with aerodynamics for education and research. |
| upload_time | 2024-11-26 20:58:10 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | Copyright 2023 RotorPy Authors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
drone
uav
quadrotor
multirotor
aerodynamics
simulation
controls
robotics
estimation
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# RotorPy
A Python-based multirotor simulation environment with aerodynamic wrenches, useful for education and research in estimation, planning, and control for UAVs.
<p align="center"><img src="/media/double_pillar.gif" width="32%"/><img src="/media/gusty.gif" width="32%"/><img src="/media/minsnap.gif" width="32%"/></p>
**NEW in `v1.1.0`**: RotorPy now includes a customizable [Gymnasium](https://github.com/Farama-Foundation/Gymnasium) environment found in the new `rotorpy/learning/` module.
<p align="center"><img src="/media/ppo_hover_20k.gif" width="32%"/><img src="/media/ppo_hover_600k.gif" width="32%"/><img src="/media/ppo_hover_1000k.gif" width="32%"/></p>
## Purpose and Scope
The original focus of this simulator was on accurately simulating rotary-wing UAV dynamics with added lumped parameter representations of the aerodynamics for course design and exploratory research. These aerodynamic effects, listed below, are negligible at hover in still air; however, as relative airspeed increases (e.g. for aggressive maneuvers or in the presence of high winds), they quickly become noticeable and force the student/researcher to reconcile with them.
As RotorPy continues to grow, the focus is now on building a realistic dynamics simulator that can scale to quickly generate thousands (or even millions) of simulated rotary-wing UAVs for applications in deep learning, reinforcement learning, and Monte Carlo studies on existing (or new!) algorithms in estimation, planning, and control.
The engine is designed from the bottom up to be lightweight, easy to install with very limited dependencies or requirements, and interpretable to anyone with basic working knowledge of Python. The simulator is intended to gain intuition about UAV dynamics/aerodynamics and learn how to develop control and/or estimation algorithms for rotary wing vehicles subject to aerodynamic wrenches.
The following aerodynamic effects of interest are within the scope of this model:
1. **Parasitic Drag** - Drag associated with non-lifting surfaces like the frame. This drag is quadratic in airspeed.
2. **Rotor Drag** - This is an apparent drag force that is a result of the increased drag produced by the advancing blade of a rotor. Rotor drag is linear in airspeed.
3. **Blade Flapping** - An effect of dissymmetry of lift, blade flapping is the motion of the blade up or down that results in a pitching moment. The pitching moment is linear in the airspeed.
4. **Induced Drag** - Another effect of dissymmetry of lift, more apparent in semi-rigid or rigid blades, where an increase of lift on the advancing blade causes an increased induced downwash, which in turn tilts the lift vector aft resulting in more drag. Induced drag is linear in the airspeed.
5. **Translational Lift** - In forward motion, the induced velocity at the rotor plane decreases, causing an increase in lift generation. *Note: currently this effect is NOT modeled in the thrust produced by the rotor.*
6. **Translational Drag** - A consequence of translational lift, and similar to **Induced Drag**, the increased lift produced in forward flight will produce an increase in induced drag on the rotor.
Ultimately the effects boil down to forces acting anti-parallel to the relative airspeed and a combination of pitching moments acting parallel and perpendicular to the relative airspeed. The rotor aerodynamic effects (rotor drag, blade flapping, induced drag, and translational drag) can be lumped into a single drag force acting at each rotor hub, whereas parasitic drag can be lumped into a single force and moment vector acting at the center of mass.
What's currently ignored: any lift produced by the frame or any torques produced by an imbalance of drag forces on the frame. We also currently neglect variations in the wind along the length of the UAV, implicitly assuming that the characteristic length scales of the wind fields are larger than UAV's maximum dimensions.
RotorPy also includes first-order motor dynamics to simulate lag, as well as support for spatio-temporal wind flow fields for the UAV to interact with.
# Installation
RotorPy can be installed using `pip`:
```
pip install rotorpy
```
# Usage
There are a few example scripts found in `rotorpy/examples/` that demonstrate how to use RotorPy in a variety of ways including for Monte Carlo evaluations, reinforcement learning, and swarms.
#### Regular usage
A good place to start would be to reference the `rotorpy/examples/basic_usage.py` script. It goes through the necessary imports and how to create and execute an instance of the simulator.
At minimum the simulator requires vehicle, controller, and trajectory objects. The vehicle (and potentially the controller) is parameterized by a unique parameter file, such as in `rotorpy/vehicles/hummingbird_params.py`. There is also the option to specify your own IMU, world bounds, and how long you would like to run the simulator for.
The output of the simulator is a dictionary containing a time vector and the time histories of all the vehicle's states, inputs, and measurements.
Below is a minimum working example:
```
from rotorpy.vehicles.multirotor import Multirotor
from rotorpy.vehicles.crazyflie_params import quad_params
from rotorpy.controllers.quadrotor_control import SE3Control
from rotorpy.trajectories.circular_traj import CircularTraj
from rotorpy.wind.default_winds import SinusoidWind
sim_instance = Environment(vehicle=Multirotor(quad_params), # vehicle object, must be specified.
controller=SE3Control(quad_params), # controller object, must be specified.
trajectory=CircularTraj(radius=2), # trajectory object, must be specified.
wind_profile=SinusoidWind(), # OPTIONAL: wind profile object, if none is supplied it will choose no wind.
sim_rate = 100, # OPTIONAL: The update frequency of the simulator in Hz. Default is 100 Hz.
imu = None, # OPTIONAL: imu sensor object, if none is supplied it will choose a default IMU sensor.
mocap = None, # OPTIONAL: mocap sensor object, if none is supplied it will choose a default mocap.
estimator = None, # OPTIONAL: estimator object
world = None, # OPTIONAL: the world, same name as the file in rotorpy/worlds/, default (None) is empty world
safety_margin= 0.25 # OPTIONAL: defines the radius (in meters) of the sphere used for collision checking
)
x0 = {'x': np.array([0,0,0]),
'v': np.zeros(3,),
'q': np.array([0, 0, 0, 1]), # [i,j,k,w]
'w': np.zeros(3,),
'wind': np.array([0,0,0]), # Since wind is handled elsewhere, this value is overwritten
'rotor_speeds': np.array([1788.53, 1788.53, 1788.53, 1788.53])}
sim_instance.vehicle.initial_state = x0
# The results are a dictionary containing the relevant state, input, and measurements vs time.
results = sim_instance.run(t_final = 20, # The maximum duration of the environment in seconds
use_mocap = False, # Boolean: determines if the controller should use the motion capture estimates.
terminate = False, # Boolean: if this is true, the simulator will terminate when it reaches the last waypoint.
plot = True, # Boolean: plots the vehicle states and commands
plot_mocap = True, # Boolean: plots the motion capture pose and twist measurements
plot_estimator = True, # Boolean: plots the estimator filter states and covariance diagonal elements
plot_imu = True, # Boolean: plots the IMU measurements
animate_bool = True, # Boolean: determines if the animation of vehicle state will play.
animate_wind = True, # Boolean: determines if the animation will include a scaled wind vector to indicate the local wind acting on the UAV.
verbose = True, # Boolean: will print statistics regarding the simulation.
fname = None # Filename is specified if you want to save the animation. The save location is rotorpy/data_out/.
)
```
#### Reinforcement Learning
New in `v1.1.0`, RotorPy includes a custom Gymnasium environment, `QuadrotorEnv`, which is a stripped down version of the regular simulation environment intended for applications in reinforcement learning. `QuadrotorEnv` features all the aerodynamics and motor dynamics, but also supports different control abstractions ranging from high level velocity vector commands all the way down to direct individual motor speed commands. This environment also allows the user to specify their own reward function.
For an example of how to interface with this environment, see `rotorpy/examples/gymnasium_basic_usage.py`. You can also see an example of training a quadrotor to hover using this environment in `rotorpy/examples/ppo_hover_train.py` and `rotorpy/examples/ppo_hover_eval.py`.
You can find this new environment in the `rotorpy/learning/` module.
# Development
It is rather straightforward if you would like to add more tracking methods into the simulator. For instance, if you'd like to add a new trajectory generator or a new controller, we've added respective templates that you can use under `rotorpy/trajectories/` and `rotorpy/controllers/` to help structure your code appropriately. If you'd like to add your own wind field, you can add a new class in `rotorpy/wind/` following the template there.
As for adding more core functionality (e.g., sensors, new vehicle dynamics, animations, etc.), those require a bit more effort to make sure that all the inputs and outputs are set up accordingly. One piece of advice is that the main loop occurs in `rotorpy/simulate.py`. Under the `while` loop, you can see the process by which the vehicle dynamics, trajectory generator, IMU sensor, and controller interface with each other.
If you are adding new functionality, as opposed to simply adding new controllers, wind fields, or trajectories, please make a new branch before starting to make those changes.
# Citation
If you use RotorPy for your work please cite our companion workshop paper contributed to the [RS4UAVs Workshop at ICRA 2023](https://imrclab.github.io/workshop-uav-sims-icra2023/):
```
@article{folk2023rotorpy,
title={{RotorPy}: A Python-based Multirotor Simulator with Aerodynamics for Education and Research},
author={Folk, Spencer and Paulos, James and Kumar, Vijay},
journal={arXiv preprint arXiv:2306.04485},
year={2023}
}
```
This paper addresses the theory, simulation framework, and benchmarking studies.
# Elsewhere In Literature
The following is a selection of papers that have used RotorPy (or previous versions of RotorPy) for generating their simulated results:
1. K. Y. Chee and M. A. Hsieh. "Learning-enhanced Nonlinear Model Predictive Control using Knowledge-based Neural Ordinary Differential Equations and Deep Ensembles," submitted to *5th Annual Learning for Dynamics \& Control Conference*, Philadelphia, PA USA, Jun 2023.
2. K. Y. Chee, T. Z. Jiahao and M. A. Hsieh. "KNODE-MPC: A Knowledge-Based Data-Driven Predictive Control Framework for Aerial Robots,'' in *IEEE Robotics and Automation Letters*, vol. 7, no. 2, pp. 2819-2826, Apr 2022.
3. Jiahao, Tom Z. and Chee, Kong Yao and Hsieh, M. Ani. "Online Dynamics Learning for Predictive Control with an Application to Aerial Robots," in *the Proc. of the 2022 Conference on Robot Learning (CoRL)*, Auckland, NZ, Dec 2022.
4. K. Mao, J. Welde, M. A. Hsieh, and V. Kumar, “Trajectory planning for the bidirectional quadrotor as a differentially flat hybrid system,” in *2023 International Conference on Robotics and Automation (ICRA) (accepted)*, 2023.
5. He, S., Hsu, C. D., Ong, D., Shao, Y. S., & Chaudhari, P. (2023). "Active Perception using Neural Radiance Fields," submitted to *arXiv preprint arXiv:2310.09892*.
6. Tao, R., Cheng, S., Wang, X., Wang, S., & Hovakimyan, N. (2024). "DiffTune-MPC: Closed-loop learning for model predictive control," in *IEEE Robotics and Automation Letters*.
7. Hsu, C. D., & Chaudhari, P. (2024). "Active Scout: Multi-Target Tracking Using Neural Radiance Fields in Dense Urban Environments." submitted to *arXiv preprint arXiv:2406.07431*.
8. Sanghvi, H., Folk, S., & Taylor, C. J. "OCCAM: Online Continuous Controller Adaptation with Meta-Learned Models," in *8th Annual Conference on Robot Learning (CoRL)*.
RotorPy was also listed among other UAV simulators in two recent surveys:
Dimmig, C. A., Silano, G., McGuire, K., Gabellieri, C., Hšnig, W., Moore, J., & Kobilarov, M. (2024). "Survey of Simulators for Aerial Robots: An Overview and In-Depth Systematic Comparisons," in *IEEE Robotics & Automation Magazine*.
Nikolaiev, M., & Novotarskyi, M. (2024). "Comparative Review of Drone Simulators," in *Information, Computing and Intelligent systems*, (4), 79-98.
**If you use this simulator for published work, let me know as I am happy to add your reference to this list.**
# Acknowledgements
We would like to acknowledge [Jimmy Paulos](https://github.com/jpaulos) who wrote the majority of the underlying engine for RotorPy, and the teaching assistants who contributed code to the initial version of this simulator, especially [Dan Mox](https://github.com/danmox), [Laura Jarin-Lipschitz](https://github.com/ljarin), [Rebecca Li](https://github.com/rebeccali), [Shane Rozen-Levy](https://github.com/ShaneRozenLevy), [Xu Liu](https://github.com/XuRobotics), [Yuezhan Tao](https://github.com/tyuezhan), [Yu-Ming Chen](https://github.com/yminchen), and [Fernando Cladera](https://github.com/fcladera).
Raw data
{
"_id": null,
"home_page": null,
"name": "rotorpy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Spencer Folk <sfolk@seas.upenn.edu>",
"keywords": "drone, uav, quadrotor, multirotor, aerodynamics, simulation, controls, robotics, estimation",
"author": null,
"author_email": "Spencer Folk <sfolk@seas.upenn.edu>",
"download_url": "https://files.pythonhosted.org/packages/ee/aa/ce41a4a5aa0c36b5e9d5835a39d6b11d5173538afc3a30db4d4fc54d15c4/rotorpy-1.1.1.tar.gz",
"platform": null,
"description": "# RotorPy\nA Python-based multirotor simulation environment with aerodynamic wrenches, useful for education and research in estimation, planning, and control for UAVs.\n<p align=\"center\"><img src=\"/media/double_pillar.gif\" width=\"32%\"/><img src=\"/media/gusty.gif\" width=\"32%\"/><img src=\"/media/minsnap.gif\" width=\"32%\"/></p>\n\n**NEW in `v1.1.0`**: RotorPy now includes a customizable [Gymnasium](https://github.com/Farama-Foundation/Gymnasium) environment found in the new `rotorpy/learning/` module. \n\n<p align=\"center\"><img src=\"/media/ppo_hover_20k.gif\" width=\"32%\"/><img src=\"/media/ppo_hover_600k.gif\" width=\"32%\"/><img src=\"/media/ppo_hover_1000k.gif\" width=\"32%\"/></p>\n\n## Purpose and Scope\nThe original focus of this simulator was on accurately simulating rotary-wing UAV dynamics with added lumped parameter representations of the aerodynamics for course design and exploratory research. These aerodynamic effects, listed below, are negligible at hover in still air; however, as relative airspeed increases (e.g. for aggressive maneuvers or in the presence of high winds), they quickly become noticeable and force the student/researcher to reconcile with them. \n\nAs RotorPy continues to grow, the focus is now on building a realistic dynamics simulator that can scale to quickly generate thousands (or even millions) of simulated rotary-wing UAVs for applications in deep learning, reinforcement learning, and Monte Carlo studies on existing (or new!) algorithms in estimation, planning, and control. \n\nThe engine is designed from the bottom up to be lightweight, easy to install with very limited dependencies or requirements, and interpretable to anyone with basic working knowledge of Python. The simulator is intended to gain intuition about UAV dynamics/aerodynamics and learn how to develop control and/or estimation algorithms for rotary wing vehicles subject to aerodynamic wrenches. \n\nThe following aerodynamic effects of interest are within the scope of this model: \n1. **Parasitic Drag** - Drag associated with non-lifting surfaces like the frame. This drag is quadratic in airspeed. \n2. **Rotor Drag** - This is an apparent drag force that is a result of the increased drag produced by the advancing blade of a rotor. Rotor drag is linear in airspeed. \n3. **Blade Flapping** - An effect of dissymmetry of lift, blade flapping is the motion of the blade up or down that results in a pitching moment. The pitching moment is linear in the airspeed. \n4. **Induced Drag** - Another effect of dissymmetry of lift, more apparent in semi-rigid or rigid blades, where an increase of lift on the advancing blade causes an increased induced downwash, which in turn tilts the lift vector aft resulting in more drag. Induced drag is linear in the airspeed. \n5. **Translational Lift** - In forward motion, the induced velocity at the rotor plane decreases, causing an increase in lift generation. *Note: currently this effect is NOT modeled in the thrust produced by the rotor.*\n6. **Translational Drag** - A consequence of translational lift, and similar to **Induced Drag**, the increased lift produced in forward flight will produce an increase in induced drag on the rotor. \n\nUltimately the effects boil down to forces acting anti-parallel to the relative airspeed and a combination of pitching moments acting parallel and perpendicular to the relative airspeed. The rotor aerodynamic effects (rotor drag, blade flapping, induced drag, and translational drag) can be lumped into a single drag force acting at each rotor hub, whereas parasitic drag can be lumped into a single force and moment vector acting at the center of mass. \n\nWhat's currently ignored: any lift produced by the frame or any torques produced by an imbalance of drag forces on the frame. We also currently neglect variations in the wind along the length of the UAV, implicitly assuming that the characteristic length scales of the wind fields are larger than UAV's maximum dimensions.\n\nRotorPy also includes first-order motor dynamics to simulate lag, as well as support for spatio-temporal wind flow fields for the UAV to interact with. \n\n# Installation\n\nRotorPy can be installed using `pip`:\n\n```\npip install rotorpy \n```\n\n# Usage\n\nThere are a few example scripts found in `rotorpy/examples/` that demonstrate how to use RotorPy in a variety of ways including for Monte Carlo evaluations, reinforcement learning, and swarms. \n\n#### Regular usage\nA good place to start would be to reference the `rotorpy/examples/basic_usage.py` script. It goes through the necessary imports and how to create and execute an instance of the simulator. \n \nAt minimum the simulator requires vehicle, controller, and trajectory objects. The vehicle (and potentially the controller) is parameterized by a unique parameter file, such as in `rotorpy/vehicles/hummingbird_params.py`. There is also the option to specify your own IMU, world bounds, and how long you would like to run the simulator for. \n\nThe output of the simulator is a dictionary containing a time vector and the time histories of all the vehicle's states, inputs, and measurements.\n\nBelow is a minimum working example: \n\n```\nfrom rotorpy.vehicles.multirotor import Multirotor\nfrom rotorpy.vehicles.crazyflie_params import quad_params\nfrom rotorpy.controllers.quadrotor_control import SE3Control\nfrom rotorpy.trajectories.circular_traj import CircularTraj\nfrom rotorpy.wind.default_winds import SinusoidWind\n\nsim_instance = Environment(vehicle=Multirotor(quad_params), # vehicle object, must be specified. \n controller=SE3Control(quad_params), # controller object, must be specified.\n trajectory=CircularTraj(radius=2), # trajectory object, must be specified.\n wind_profile=SinusoidWind(), # OPTIONAL: wind profile object, if none is supplied it will choose no wind. \n sim_rate = 100, # OPTIONAL: The update frequency of the simulator in Hz. Default is 100 Hz.\n imu = None, # OPTIONAL: imu sensor object, if none is supplied it will choose a default IMU sensor.\n mocap = None, # OPTIONAL: mocap sensor object, if none is supplied it will choose a default mocap. \n estimator = None, # OPTIONAL: estimator object\n world = None, # OPTIONAL: the world, same name as the file in rotorpy/worlds/, default (None) is empty world\n safety_margin= 0.25 # OPTIONAL: defines the radius (in meters) of the sphere used for collision checking\n )\n\nx0 = {'x': np.array([0,0,0]),\n 'v': np.zeros(3,),\n 'q': np.array([0, 0, 0, 1]), # [i,j,k,w]\n 'w': np.zeros(3,),\n 'wind': np.array([0,0,0]), # Since wind is handled elsewhere, this value is overwritten\n 'rotor_speeds': np.array([1788.53, 1788.53, 1788.53, 1788.53])}\nsim_instance.vehicle.initial_state = x0\n\n# The results are a dictionary containing the relevant state, input, and measurements vs time.\nresults = sim_instance.run(t_final = 20, # The maximum duration of the environment in seconds\n use_mocap = False, # Boolean: determines if the controller should use the motion capture estimates. \n terminate = False, # Boolean: if this is true, the simulator will terminate when it reaches the last waypoint.\n plot = True, # Boolean: plots the vehicle states and commands \n plot_mocap = True, # Boolean: plots the motion capture pose and twist measurements\n plot_estimator = True, # Boolean: plots the estimator filter states and covariance diagonal elements\n plot_imu = True, # Boolean: plots the IMU measurements\n animate_bool = True, # Boolean: determines if the animation of vehicle state will play. \n animate_wind = True, # Boolean: determines if the animation will include a scaled wind vector to indicate the local wind acting on the UAV. \n verbose = True, # Boolean: will print statistics regarding the simulation. \n fname = None # Filename is specified if you want to save the animation. The save location is rotorpy/data_out/. \n )\n\n```\n\n#### Reinforcement Learning\nNew in `v1.1.0`, RotorPy includes a custom Gymnasium environment, `QuadrotorEnv`, which is a stripped down version of the regular simulation environment intended for applications in reinforcement learning. `QuadrotorEnv` features all the aerodynamics and motor dynamics, but also supports different control abstractions ranging from high level velocity vector commands all the way down to direct individual motor speed commands. This environment also allows the user to specify their own reward function. \n\nFor an example of how to interface with this environment, see `rotorpy/examples/gymnasium_basic_usage.py`. You can also see an example of training a quadrotor to hover using this environment in `rotorpy/examples/ppo_hover_train.py` and `rotorpy/examples/ppo_hover_eval.py`. \n\nYou can find this new environment in the `rotorpy/learning/` module. \n\n# Development\n\nIt is rather straightforward if you would like to add more tracking methods into the simulator. For instance, if you'd like to add a new trajectory generator or a new controller, we've added respective templates that you can use under `rotorpy/trajectories/` and `rotorpy/controllers/` to help structure your code appropriately. If you'd like to add your own wind field, you can add a new class in `rotorpy/wind/` following the template there. \n\nAs for adding more core functionality (e.g., sensors, new vehicle dynamics, animations, etc.), those require a bit more effort to make sure that all the inputs and outputs are set up accordingly. One piece of advice is that the main loop occurs in `rotorpy/simulate.py`. Under the `while` loop, you can see the process by which the vehicle dynamics, trajectory generator, IMU sensor, and controller interface with each other. \n\nIf you are adding new functionality, as opposed to simply adding new controllers, wind fields, or trajectories, please make a new branch before starting to make those changes. \n\n# Citation\n\nIf you use RotorPy for your work please cite our companion workshop paper contributed to the [RS4UAVs Workshop at ICRA 2023](https://imrclab.github.io/workshop-uav-sims-icra2023/): \n\n```\n@article{folk2023rotorpy,\n title={{RotorPy}: A Python-based Multirotor Simulator with Aerodynamics for Education and Research},\n author={Folk, Spencer and Paulos, James and Kumar, Vijay},\n journal={arXiv preprint arXiv:2306.04485},\n year={2023}\n}\n```\n\nThis paper addresses the theory, simulation framework, and benchmarking studies.\n\n# Elsewhere In Literature\n\nThe following is a selection of papers that have used RotorPy (or previous versions of RotorPy) for generating their simulated results: \n1. K. Y. Chee and M. A. Hsieh. \"Learning-enhanced Nonlinear Model Predictive Control using Knowledge-based Neural Ordinary Differential Equations and Deep Ensembles,\" submitted to *5th Annual Learning for Dynamics \\& Control Conference*, Philadelphia, PA USA, Jun 2023.\n2. K. Y. Chee, T. Z. Jiahao and M. A. Hsieh. \"KNODE-MPC: A Knowledge-Based Data-Driven Predictive Control Framework for Aerial Robots,'' in *IEEE Robotics and Automation Letters*, vol. 7, no. 2, pp. 2819-2826, Apr 2022.\n3. Jiahao, Tom Z. and Chee, Kong Yao and Hsieh, M. Ani. \"Online Dynamics Learning for Predictive Control with an Application to Aerial Robots,\" in *the Proc. of the 2022 Conference on Robot Learning (CoRL)*, Auckland, NZ, Dec 2022.\n4. K. Mao, J. Welde, M. A. Hsieh, and V. Kumar, \u201cTrajectory planning for the bidirectional quadrotor as a differentially flat hybrid system,\u201d in *2023 International Conference on Robotics and Automation (ICRA) (accepted)*, 2023.\n5. He, S., Hsu, C. D., Ong, D., Shao, Y. S., & Chaudhari, P. (2023). \"Active Perception using Neural Radiance Fields,\" submitted to *arXiv preprint arXiv:2310.09892*.\n6. Tao, R., Cheng, S., Wang, X., Wang, S., & Hovakimyan, N. (2024). \"DiffTune-MPC: Closed-loop learning for model predictive control,\" in *IEEE Robotics and Automation Letters*.\n7. Hsu, C. D., & Chaudhari, P. (2024). \"Active Scout: Multi-Target Tracking Using Neural Radiance Fields in Dense Urban Environments.\" submitted to *arXiv preprint arXiv:2406.07431*.\n8. Sanghvi, H., Folk, S., & Taylor, C. J. \"OCCAM: Online Continuous Controller Adaptation with Meta-Learned Models,\" in *8th Annual Conference on Robot Learning (CoRL)*.\n\n\nRotorPy was also listed among other UAV simulators in two recent surveys:\n\nDimmig, C. A., Silano, G., McGuire, K., Gabellieri, C., H\u0161nig, W., Moore, J., & Kobilarov, M. (2024). \"Survey of Simulators for Aerial Robots: An Overview and In-Depth Systematic Comparisons,\" in *IEEE Robotics & Automation Magazine*.\n\nNikolaiev, M., & Novotarskyi, M. (2024). \"Comparative Review of Drone Simulators,\" in *Information, Computing and Intelligent systems*, (4), 79-98.\n\n\n**If you use this simulator for published work, let me know as I am happy to add your reference to this list.**\n\n# Acknowledgements\n\nWe would like to acknowledge [Jimmy Paulos](https://github.com/jpaulos) who wrote the majority of the underlying engine for RotorPy, and the teaching assistants who contributed code to the initial version of this simulator, especially [Dan Mox](https://github.com/danmox), [Laura Jarin-Lipschitz](https://github.com/ljarin), [Rebecca Li](https://github.com/rebeccali), [Shane Rozen-Levy](https://github.com/ShaneRozenLevy), [Xu Liu](https://github.com/XuRobotics), [Yuezhan Tao](https://github.com/tyuezhan), [Yu-Ming Chen](https://github.com/yminchen), and [Fernando Cladera](https://github.com/fcladera). \n",
"bugtrack_url": null,
"license": "Copyright 2023 RotorPy Authors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "A multirotor simulator with aerodynamics for education and research.",
"version": "1.1.1",
"project_urls": {
"Bug Reports": "https://github.com/spencerfolk/rotorpy/issues",
"Homepage": "https://github.com/spencerfolk/rotorpy",
"Source": "https://github.com/spencerfolk/rotorpy"
},
"split_keywords": [
"drone",
" uav",
" quadrotor",
" multirotor",
" aerodynamics",
" simulation",
" controls",
" robotics",
" estimation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bde33cb8883e4fd18655da34ebe8b827cfec2ffef3ab4968770c46411ba3a1a4",
"md5": "e161c4e986a80ea0cdc71131e5555e2a",
"sha256": "a96a6ec6892f2b5984fc011c7aa761bde83b19e456336c615fbb3ee23cc9809f"
},
"downloads": -1,
"filename": "rotorpy-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e161c4e986a80ea0cdc71131e5555e2a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 91132,
"upload_time": "2024-11-26T20:58:08",
"upload_time_iso_8601": "2024-11-26T20:58:08.510972Z",
"url": "https://files.pythonhosted.org/packages/bd/e3/3cb8883e4fd18655da34ebe8b827cfec2ffef3ab4968770c46411ba3a1a4/rotorpy-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "eeaace41a4a5aa0c36b5e9d5835a39d6b11d5173538afc3a30db4d4fc54d15c4",
"md5": "ad41b333e31560838ddc264d1b7287cf",
"sha256": "1ce5f3c066569f75636e0bad1501b6aac2bccf3bbcfcad0a9b942146c8e39dcc"
},
"downloads": -1,
"filename": "rotorpy-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "ad41b333e31560838ddc264d1b7287cf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 78319,
"upload_time": "2024-11-26T20:58:10",
"upload_time_iso_8601": "2024-11-26T20:58:10.390572Z",
"url": "https://files.pythonhosted.org/packages/ee/aa/ce41a4a5aa0c36b5e9d5835a39d6b11d5173538afc3a30db4d4fc54d15c4/rotorpy-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-26 20:58:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "spencerfolk",
"github_project": "rotorpy",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "rotorpy"
}
