From f3fb6101cebe1b985ca8ecd1a6aaa44460727f17 Mon Sep 17 00:00:00 2001 From: callie Date: Wed, 8 Feb 2023 14:41:45 -0600 Subject: [PATCH] Added updated readme and license files with working links. --- README.md | 112 +++++++++++++++++++++++++++++++++++++++++++++++++++++ license.md | 27 +++++++++++++ 2 files changed, 139 insertions(+) create mode 100644 README.md create mode 100644 license.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..0e9933c --- /dev/null +++ b/README.md @@ -0,0 +1,112 @@ +# Virtual Controls Laboratory +[![View Virtual Controls Laboratory on File Exchange](https://www.mathworks.com/matlabcentral/images/matlab-file-exchange.svg)](https://www.mathworks.com/matlabcentral/fileexchange/) or [![Open in MATLAB Online](https://www.mathworks.com/images/responsive/global/open-in-matlab-online.svg)](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Virtual-Controls-Laboratory&project=VirtualControlsLaboratory.prj) + +**Curriculum Module** +_Created with R2021a. Compatible with R2021a and later releases._ + +## Description ## +The Virtual Controls Laboratory contains virtual models of several mechanisms commonly used in controls courses. These virtual mechanisms offer opportunities to visually analyze dynamic systems, identify system parameters, design and test controllers, among others. Instructions for four introductory labs are included. These labs are designed to give an intuitive introduction to basic controls concepts, such as feedback control. Students also have the opportunity to implement and test simple controllers in Simulink®. + +Get started with the Virtual Controls Laboratory by downloading and unzipping the repository. Then, double-click the project .prj file inside MATLAB®. From there, you can follow the landing page instructions to get started with the labs and virtual mechanisms. + +## Details ## + +### Virtual Mechanisms ### + + + + + + + + + + + +
+ Cruise control +
CruiseControl.slx + Vehicle animation + 		+ DC motor +
DCMotorControl.slx + DC motor animation + 		+ Inverted pendulum +
InvertedPendulum.slx + Inverted pendulum animation +
+ Rotary pendulum +
RotaryPendulum.slx + Rotary pendulum animation + 		+ Ball and beam +
BallAndBeam.slx + Ball and beam animation + 		+ Ball and plate +
BallAndPlate.slx + Ball and plate animation +
+ + +### Labs ### +**Lab 1: Cruise control `(Lab1_CruiseControl.mlx)`** +A virtual lab that explores the basics of open-loop and feedback control. + +**Learning Goals:** +- Compare and contrast open-loop and feedback control. +- Implement a simple open-loop controller in Simulink. +- Analyze the performance of an open-loop controller. +- Implement a proportional controller in Simulink. +- Analyze the performance of a proportional controller. + +## ## +**Lab 2: Vehicle Transfer Function Model `(Lab2_VehicleModel.mlx)`** +In this lab, students derive a transfer function model of a virtual vehicle. + +**Learning Goals:** +- Derive the transfer function of a first order system. +- Compare the transfer function and virtual vehicle responses. +- Identify the model parameters for the virtual vehicle. + +## ## +**Lab 3: Position Control `(Lab3_PositionControl.mlx)`** +In this lab, students implement a PID controller to control the position of a virtual DC motor. + +**Learning Goals:** +- Implement a PID controller. +- Identify rise time, settling time, overshoot, and peak time. +- Explain how changes to PID parameters affect the time-domain response. + +## ## +**Lab 4: Position Control Analysis `(Lab4_PositionAnalysis.mlx)`** +In this lab, students construct and analyze the closed-loop transfer function of a feedback controller. + +**Learning Goals:** +- Construct a closed-loop transfer function. +- Plot the step response of a closed-loop transfer function. +- Identify the poles of a closed-loop transfer function. +- Assess the stability of a closed-loop transfer function. + +## Suggested Prework ## +[MATLAB Onramp](https://matlabacademy.mathworks.com/details/matlab-onramp/gettingstarted) – a free two-hour introductory tutorial that teaches the essentials of MATLAB. +
+[Simulink Onramp](https://matlabacademy.mathworks.com/details/simulink-onramp/simulink) – a free three-hour introductory tutorial that teaches the essentials of Simulink. + +## Products ## +MATLAB, Simulink, Control System Toolbox™, Simscape™, Simscape Multibody™, Simscape Driveline™ + +## License ## +The license for this module is available in the [LICENSE.md](license.md) file in this GitHub repository. + +## Educator Resources ## +* [Featured Courseware](https://www.mathworks.com/academia/courseware/course-materials.html) +* [Teach with MATLAB and Simulink](https://www.mathworks.com/academia/educators.html) +* [MATLAB Grader](https://www.mathworks.com/products/matlab-grader.html) + +The lab solutions are available upon instructor request. If you would like to request solutions or have a question, contact the MathWorks online teaching team. If you are having technical issues using MATLAB, please contact our [Technical Support Team](https://www.mathworks.com/support/contact_us.html). + +# # + +_Copyright 2023-2024 The MathWorks, Inc._ diff --git a/license.md b/license.md new file mode 100644 index 0000000..b3b537a --- /dev/null +++ b/license.md @@ -0,0 +1,27 @@ +Copyright (c) 2022, The MathWorks, Inc. +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the distribution + * Neither the name of the The MathWorks, Inc. nor the names + of its contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. \ No newline at end of file