Skip to content

Commit c9b1538

Browse files
committed
updated readme to include suggested pre-work and installation tips
1 parent 6260e75 commit c9b1538

File tree

1 file changed

+23
-8
lines changed

1 file changed

+23
-8
lines changed

README.md

Lines changed: 23 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,21 @@ _Created with R2021a. Compatible with R2021a and later releases._
77
## Description ##
88
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®.
99

10-
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.
10+
These modules connect the theory and application of the specific subject, which will support various student learning objectives. These lessons can be used as part of a lecture to supplement learning, as activities in an instructional setting, or as interactive assignments to be completed outside class.
11+
12+
## Get started with the Virtual Controls Laboratory interactive examples ##
13+
14+
**Option 1: Download to Desktop** Download and unzip the repository. Then, double-click the VirtualControlsLabortory.prj file inside MATLAB&reg;. If you open a script or model and MATLAB notifies you that a certain toolbox is not installed, click the arrow on the <img src="https://github.com/MathWorks-Teaching-Resources/Virtual-Controls-Laboratory/assets/88105902/079f23c8-11cc-46e9-a935-26dccf0b32eb"> **Add-Ons** button in the **ENVIRONMENT** section on the **HOME** tab in the MATLAB Toolstrip. Then, navigate to **Manage Add-ons** to install the necessary toolboxes.
15+
16+
**Option 2: [Open in MATLAB Online](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Virtual-Controls-Laboratory&project=VirtualControlsLabortory.prj)** Log in to your MathWorks account to access your license. If you are associated with a university, use your university email to access a license.
17+
18+
- From there, you can follow the landing page instructions to get started with the examples.
19+
- The instructions inside the live scripts will guide you through the exercises and activities.
20+
- Get started with each live script by running it one section at a time.
21+
- To stop running the script or a section midway (for example, if a loop is running longer than intended), click the <img src="https://user-images.githubusercontent.com/88841524/182219991-17ef7bf9-369b-4463-8de6-9e440ca3bc9b.png"> **Stop** button in the **RUN** section of the **Live Editor** tab in the MATLAB Toolstrip.
22+
23+
## Prerequisite Domain Knowledge ##
24+
These scripts assume some familiarity with open/closed loop feedback control, deriving transfer functions, PID controllers, and stability control (poles and zeros). It is possible to work through this module without extensive experience in MATLAB and Simulink. However, some background in these products will be helpful. Please see the suggested pre-work section below for self-paced tutorials that can support quicker onboarding.
1125

1226
## Details ##
1327

@@ -17,7 +31,7 @@ Get started with the Virtual Controls Laboratory by downloading and unzipping th
1731
<td width=290>
1832
<b>Cruise control</b>
1933
<br><code>CruiseControl.slx</code>
20-
<img src = "./SupportingFiles/gifs/vehiclecover.png" alt="Vehicle animation" width=250>
34+
<img src = "./SupportingFiles/gifs/cruisecontrol.gif" alt="Vehicle animation" width=250>
2135
</td>
2236
<td width=290>
2337
<b>DC motor</b>
@@ -49,7 +63,6 @@ Get started with the Virtual Controls Laboratory by downloading and unzipping th
4963
</tr>
5064
</table>
5165

52-
5366
### Labs ###
5467
**Lab 1: Cruise control `(Lab1_CruiseControl.mlx)`**
5568
A virtual lab that explores the basics of open-loop and feedback control.
@@ -90,9 +103,11 @@ In this lab, students construct and analyze the closed-loop transfer function of
90103
- Assess the stability of a closed-loop transfer function.
91104

92105
## Suggested Prework ##
93-
[MATLAB Onramp](https://matlabacademy.mathworks.com/details/matlab-onramp/gettingstarted) – a free two-hour introductory tutorial that teaches the essentials of MATLAB.
94-
<br>
95-
[Simulink Onramp](https://matlabacademy.mathworks.com/details/simulink-onramp/simulink) – a free three-hour introductory tutorial that teaches the essentials of Simulink.
106+
The suggested prework detailed below are complementary interactive online courses available for all to use with a valid MathWorks account.
107+
108+
* [MATLAB Onramp](https://matlabacademy.mathworks.com/details/matlab-onramp/gettingstarted) – a free two-hour introductory tutorial that teaches the basics of programming in MATLAB.
109+
* [Simulink Onramp](https://matlabacademy.mathworks.com/details/simulink-onramp/simulink) – a free two-hour introductory tutorial that teaches the basics of simulating mathematical models in Simulink.
110+
* [Control Design Onramp with Simulink](https://matlabacademy.mathworks.com/details/control-design-onramp-with-simulink/controls) - a free one-hour introductory tutorial that teaches the basics of control design in Simulink.
96111

97112
## Products ##
98113
MATLAB, Simulink, Control System Toolbox&trade;, Simscape&trade;, Simscape Multibody&trade;, Simscape Driveline&trade;
@@ -101,9 +116,9 @@ MATLAB, Simulink, Control System Toolbox&trade;, Simscape&trade;, Simscape Multi
101116
The license for this module is available in the [LICENSE.md](license.md) file in this GitHub repository.
102117

103118
## Educator Resources ##
119+
* [Transfer Function Analysis of Dynamics Systems Courseware](https://www.mathworks.com/matlabcentral/fileexchange/94635-transfer-function-analysis-of-dynamic-systems?s_tid=srchtitle)
104120
* [Featured Courseware](https://www.mathworks.com/academia/courseware/course-materials.html)
105-
* [Teach with MATLAB and Simulink](https://www.mathworks.com/academia/educators.html)
106-
* [MATLAB Grader](https://www.mathworks.com/products/matlab-grader.html)
121+
* [Resources for Educators](https://www.mathworks.com/academia/educators.html)
107122

108123
The lab solutions are available upon instructor request. If you would like to request solutions or have a question, contact the <a href="mailto:[email protected]">MathWorks online teaching team.</a> If you are having technical issues using MATLAB, please contact our [Technical Support Team](https://www.mathworks.com/support/contact_us.html).
109124

0 commit comments

Comments
 (0)