advertisement
M
ATLAB
®
The Language of Technical Computing
Release Notes for Release 12.1
Computation
Visualization
Programming
How to Contact The MathWorks: www.mathworks.com
comp.soft-sys.matlab
Web
Newsgroup [email protected]
support [email protected]
Product [email protected]
reports [email protected]
Documentation error reports
Order status, license renewals, passcodes
Sales, pricing, and general information
508-647-7000 Phone
508-647-7001
The MathWorks, Inc.
3 Apple Hill Drive
Natick, MA 01760-2098
Fax
For contact information about worldwide offices, see the MathWorks Web site.
Release Notes for Release 12.1
COPYRIGHT 2001 by The MathWorks, Inc.
The software described in this document is furnished under a license agreement. The software may be used or copied only under the terms of the license agreement. No part of this manual may be photocopied or reproduced in any form without prior written consent from The MathWorks, Inc.
FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentation by or for the federal government of the United States. By accepting delivery of the Program, the government hereby agrees that this software qualifies as "commercial" computer software within the meaning of FAR
Part 12.212, DFARS Part 227.7202-1, DFARS Part 227.7202-3, DFARS Part 252.227-7013, and DFARS Part
252.227-7014. The terms and conditions of The MathWorks, Inc. Software License Agreement shall pertain to the government’s use and disclosure of the Program and Documentation, and shall supersede any conflicting contractual terms or conditions. If this license fails to meet the government’s minimum needs or is inconsistent in any respect with federal procurement law, the government agrees to return the Program and Documentation, unused, to MathWorks.
MATLAB, Simulink, Stateflow, Handle Graphics, and Real-Time Workshop are registered trademarks, and
Target Language Compiler is a trademark of The MathWorks, Inc.
Other product or brand names are trademarks or registered trademarks of their respective holders.
Printing History: June 2001 First printing New for Release 12.1
Introducing Release 12.1
What’s New in Release 12.1? . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Updated Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
New Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-16
Platform Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-17
Differences for the HP and IBM Platforms . . . . . . . . . . . . . . . 1-17
Problems Entering Accented Characters on Linux . . . . . . . . . 1-18
Problems Entering Accented Characters on UNIX Platforms 1-18
Installation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-19
Maintaining Preference Files After Uninstalling . . . . . . . . . . 1-19
Correcting the Documentation Location . . . . . . . . . . . . . . . . . 1-19
Linux Distribution Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-20
For More Information About What’s New in Release 12.1 1-21
Printable Version of the Release Notes . . . . . . . . . . . . . . . . . . 1-21
MATLAB Software Acknowledgments . . . . . . . . . . . . . . . . . 1-23
MATLAB 6.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Development Environment Features . . . . . . . . . . . . . . . . . . . . . 2-2
Contents
iii
Mathematics Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Programming and Data Types Features . . . . . . . . . . . . . . . . . . 2-8
Graphics Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
OpenGL Renderer Feature — Microsoft Windows . . . . . . . . . . 2-11
External Interfaces/API Features . . . . . . . . . . . . . . . . . . . . . . . 2-12
Creating Graphical User Interfaces — GUIDE . . . . . . . . . . . . 2-17
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18
Development Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18
Mathematics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18
Platform Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Patch Required for HP-UX 11.0 . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Mathematics Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Graphics and Printing Limitations . . . . . . . . . . . . . . . . . . . . . . 2-21
GUIDE Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21
You May Need to Overwrite the MATLAB Default
Choice of BLAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 2-26
Development Environment Issues . . . . . . . . . . . . . . . . . . . . . . 2-26
Mathematics Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-27
Programming and Data Types Issues . . . . . . . . . . . . . . . . . . . . 2-28
Graphics Issue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-29
External Interfaces/API Issues . . . . . . . . . . . . . . . . . . . . . . . . . 2-30
Known Software and Documentation Problems . . . . . . . . . 2-32
Development Environment Problems . . . . . . . . . . . . . . . . . . . . 2-32
Documentation Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-33
Simulink 4.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Simulink Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Modeling Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Simulink Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
iv
Block Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
Platform Limitations for HP and IBM . . . . . . . . . . . . . . . . . . 3-12
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 3-13
Running Simulink 4.1 Models in Simulink 4.0 . . . . . . . . . . . . 3-13
Simulink Block Library Reorganization . . . . . . . . . . . . . . . . . . 3-13
Direct Feedthrough Compensation Deprecated . . . . . . . . . . . . 3-13
S-Functions Sorted Like Built-In Blocks . . . . . . . . . . . . . . . . . 3-14
Added Latched Triggered Subsystems . . . . . . . . . . . . . . . . . . . 3-14
Self-Triggering Subsystems Are No Longer Allowed . . . . . . . . 3-14
Improved Invalid Model Configuration Diagnostics . . . . . . . . 3-15
Known Software Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
Accelerator Mode Does Not Support Inline Parameters . . . . . 3-16
Turn the New Wrap Lines Option Off . . . . . . . . . . . . . . . . . . . 3-16
Stateflow 4.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Smart Transitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Search & Replace Tool Enhancements . . . . . . . . . . . . . . . . . . . . 4-3
Stateflow Chart Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Model Coverage Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Editing Crossing Transitions out of Grouped Subcharts . . . . . . 4-4
Disabled and Restored Library Chart Links . . . . . . . . . . . . . . . 4-4
Too Many Action Statements During Simulation . . . . . . . . . . . 4-4
False State Inconsistency Runtime Error . . . . . . . . . . . . . . . . . 4-4
MATLAB Variables Improperly Overwritten . . . . . . . . . . . . . . . 4-4
Target Options Fields Overwritten . . . . . . . . . . . . . . . . . . . . . . . 4-5
Transitions Assertions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Build Failures with Custom Code . . . . . . . . . . . . . . . . . . . . . . . . 4-5
v
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . . 4-6
Transition Actions into Junctions Disallowed . . . . . . . . . . . . . . 4-6
Real-Time Workshop 4.1 Release Notes
Release Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Block Reduction Option On by Default . . . . . . . . . . . . . . . . . . . . 5-3
Buffer Reuse Code Generation Option . . . . . . . . . . . . . . . . . . . . 5-3
Build Directory Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4
Build Subsystem Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . 5-4
C API for Parameter Tuning Documented . . . . . . . . . . . . . . . . . 5-4
Code Readability Improvements . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Control Flow Blocks Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Expression Folding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
External Mode Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
Generate Comments Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
Include System Hierarchy in Identifiers . . . . . . . . . . . . . . . . . . 5-7
Rapid Simulation Target Supports Inline Parameters . . . . . . . 5-7
S-Function Target Enhancements . . . . . . . . . . . . . . . . . . . . . . . 5-7
Storage Classes for Block States . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Support for tilde (~) in Filenames on UNIX Platforms . . . . . . . 5-8
Target Language Compiler 4.1 . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
Block Reduction Crash Fixed . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
Build Subsystem Gives Better Error Message for
Function Call Subsystems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
Check Consistency of Parameter Storage Class and
Type Qualifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
Code Optimization for Unsigned Saturation and
DeadZone Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
Correct Code Generation of Fixed-Point Blockset Blocks in
DSP Blockset Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
vi
Correct Compilation with Green Hills and DDI
Compilers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Fixed Error Copying Custom Code Blocks . . . . . . . . . . . . . . . . 5-12
Fixed Error in commonmaplib.tlc . . . . . . . . . . . . . . . . . . . . . . . 5-13
Fixed Name Clashes with Run-Time Library Functions . . . . . 5-13
Improved Handling of Sample Times . . . . . . . . . . . . . . . . . . . . 5-13
Look-Up Table (n-D) Code Generation Bug Fix . . . . . . . . . . . . 5-13
Parenthesize Negative Numerics in Fcn Block Expressions . . 5-13
Retain .rtw File Option Now Works in Accelerator Mode . . . . 5-14
S-Function Target Memory Allocation Bug Fix . . . . . . . . . . . . 5-14
Platform Limitations for HP and IBM . . . . . . . . . . . . . . . . . . 5-15
Tunable Parameters Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . 5-15
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 5-16
RTWInfo Property Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16
S-Function Target MEX-Files Must Be Rebuilt . . . . . . . . . . . . 5-17
TLC Compatibility Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
Known Software Problem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
Turn the New Wrap Lines Option Off . . . . . . . . . . . . . . . . . . . 5-19
CDMA Reference Blockset 1.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Frame-Based Signal Support . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . . 6-3
vii
Communications Blockset 2.0.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
Setting Simulink Preferences Automatically . . . . . . . . . . . . . . . 7-2
Converting Between Bipolar and Unipolar Signals . . . . . . . . . . 7-2
Choosing Seeds for Random-Output Blocks . . . . . . . . . . . . . . . . 7-2
Using Error Counts to Control Simulation Duration . . . . . . . . 7-3
Choosing the Algorithm for Integrator Blocks . . . . . . . . . . . . . . 7-3
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4
Bug Fixes Incorporated from Release 12.0 . . . . . . . . . . . . . . . . . 7-4
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . . 7-5
Known Software and Documentation Problems . . . . . . . . . . 7-6
Code Generation Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6
Limited Frame and Matrix Support . . . . . . . . . . . . . . . . . . . . . . 7-6
Errors in Printed Version of Documentation . . . . . . . . . . . . . . . 7-7
Control System Toolbox 5.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2
SISO Design Tool Enhancements . . . . . . . . . . . . . . . . . . . . . . . . 8-2
Algorithmic Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3
Platform Limitations for HP and IBM . . . . . . . . . . . . . . . . . . . 8-4
Preference and Property Editors . . . . . . . . . . . . . . . . . . . . . . . . . 8-4
SISO Design Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4
viii
Data Acquisition Toolbox 2.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2
Additional National Instruments Hardware Support . . . . . . . . 9-2
High Resolution Sound Card Support . . . . . . . . . . . . . . . . . . . . 9-2
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . . 9-3
Events, Callbacks, and Function Handles . . . . . . . . . . . . . . . . . 9-3
Vendor Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3
Removed and Obsolete Functions . . . . . . . . . . . . . . . . . . . . . . . . 9-4
Two daqhwinfo Fields Removed . . . . . . . . . . . . . . . . . . . . . . . . . 9-4
Known Software and Documentation Problems . . . . . . . . . . 9-5
High Resolution Sound Cards . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5
The putdata Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5
The daqread Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5
Vendor Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5
Database Toolbox 2.2 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2
Retrieve Data as numeric or structure Format . . . . . . . . . . . . 10-2
Export Numeric or Structure Data . . . . . . . . . . . . . . . . . . . . . . 10-2
Specify Error Handling Preference . . . . . . . . . . . . . . . . . . . . . . 10-2
LONGCHAR Data Type Supported . . . . . . . . . . . . . . . . . . . . . 10-3
No HP 10.2 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4
ix
Datafeed Toolbox 1.3 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
Hyperfeed Support Added . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
Hyperfeed Function Summary . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
FT Interactive Data Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3
Developer’s Kit for Texas Instruments™ DSP 1.1
Release Notes
Introduction to Developer’s Kit for Texas
Instruments™ DSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-4
New Link Functions for CCS IDE . . . . . . . . . . . . . . . . . . . . . . . 12-4
New Interface Between the Developer’s Kit and FDATool . . . 12-5
Unified CCS IDE and C6701 EVM Targeting . . . . . . . . . . . . . 12-5
New Run-Time Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-6
Architecture Change in CCSDSP Object . . . . . . . . . . . . . . . . . 12-6
Updated Function writemsg Help Text . . . . . . . . . . . . . . . . . . 12-7
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-8
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 12-9
New Libraries at Run-Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-9
CCSDSP Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-9
Unified Targeting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-9
Known Software and Documentation Problems . . . . . . . . 12-10
Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-10
Linking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-10
Targeting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-12
Demos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-14
Datatypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-14
x
General Target Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-15
Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-15
DSP Blockset 4.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2
New Digital Filter Design Block . . . . . . . . . . . . . . . . . . . . . . . . 13-2
Major Individual Block Enhancements . . . . . . . . . . . . . . . . . . 13-3
Blocks with Enhanced Data Type Support . . . . . . . . . . . . . . . . 13-5
Blocks with Tunability Enhancements . . . . . . . . . . . . . . . . . . . 13-7
Enhancements to Blocks Implemented with S-Functions . . . . 13-7
Real-Time Workshop Generated C Code Enhancements . . . . 13-8
Changes to Filtering Block Libraries . . . . . . . . . . . . . . . . . . . . 13-9
New and Renamed DSP Blockset Directories . . . . . . . . . . . . 13-10
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-11
Real-Time Workshop C Code Generated from DSP Blockset 13-11
Nontunable Block Parameters . . . . . . . . . . . . . . . . . . . . . . . . 13-11
Chirp Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-11
Matrix Viewer Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-11
Random Source Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-12
Stack and Queue Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-12
Window Function Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-12
Platform Limitations for HP and IBM . . . . . . . . . . . . . . . . . 13-13
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . 13-14
Known Software Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-15
Real-Time Workshop C Code Generation Limitations . . . . . . 13-15
Nonzero Simulation Start Times Not Supported . . . . . . . . . . 13-15
Triggered and Enabled Subsystem Support . . . . . . . . . . . . . . 13-16
Digital Filter Design Block Limitations . . . . . . . . . . . . . . . . . 13-16
Magnitude FFT Block Limitations . . . . . . . . . . . . . . . . . . . . . 13-17
xi
Excel Link 1.1.3 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-2
License Manager Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-2
Additional Error Detection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-2
Known Software Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-3
Enabling the MATLAB Desktop . . . . . . . . . . . . . . . . . . . . . . . . 14-3
Filter Design Toolbox 2.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-2
New Adaptive Filtering Functions . . . . . . . . . . . . . . . . . . . . . . 15-2
New FIR Filter Design Functions . . . . . . . . . . . . . . . . . . . . . . . 15-3
New Filter Transformation Functions . . . . . . . . . . . . . . . . . . . 15-3
Transformations Option in FDATool . . . . . . . . . . . . . . . . . . . . 15-4
New Analysis Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-4
New Context-Sensitive Help for Quantization . . . . . . . . . . . . . 15-5
Platform Limitations for HP 10.2 . . . . . . . . . . . . . . . . . . . . . . 15-6
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 15-7
Obsolete Functions in Version 2.0 . . . . . . . . . . . . . . . . . . . . . . . 15-7
Known Software and Documentation Problems . . . . . . . . . 15-8
Help for Filter Transformations in FDATool . . . . . . . . . . . . . . 15-8
xii
Financial Time Series Toolbox 1.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2
New Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2
Financial Time Series GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2
Major Changes to Functions . . . . . . . . . . . . . . . . . . . . . . . . . . 16-3
Fixed-Point Blockset 3.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-2
New Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-2
New Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-3
Renamed Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-8
New Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-9
Data Type Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-10
Changes to Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-10
Known Documentation Problem . . . . . . . . . . . . . . . . . . . . . . 17-11
Error in Printed Version of Documentation . . . . . . . . . . . . . . 17-11
Image Processing Toolbox 3.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2
Morphology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3
Spatial Transformations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4
Image Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5
Integer Image Arithmetic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6
Integer Image Filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7
Deconvolution/Deblurring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7
Support for DICOM Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-8
Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-8
xiii
xiv Contents
New Demos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-9
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-11
Instrument Control Toolbox 1.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2
VXI Block and FIFO Read Operations . . . . . . . . . . . . . . . . . . . 19-2
Freeing the Serial Port on Windows Platforms . . . . . . . . . . . . 19-2
Data Parsing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-2
binblock Data Transfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3
Tektronix VISA Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3
Enhancements to Existing Functions and Properties . . . . . . . 19-3
Vendor Driver Requirements and Limitations . . . . . . . . . . 19-4
Tektronix VISA Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 19-5
Events, Callbacks, and Function Handles . . . . . . . . . . . . . . . . 19-5
MATLAB C/C++ Math Library 2.2 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-2
New Math Library Functions . . . . . . . . . . . . . . . . . . . . . . . . . . 20-2
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 20-4
Recompile Your Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-4
Changed Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-4
Known Software and Documentation Problems . . . . . . . . . 20-6
Documentation Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-6
MATLAB Runtime Server 6.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2
Configuration File Generation Tool . . . . . . . . . . . . . . . . . . . . . 21-2
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 21-3
Repeat Compiling, Packaging, and Testing Process . . . . . . . . 21-3
Known Documentation Problems . . . . . . . . . . . . . . . . . . . . . . 21-4
Neural Network Toolbox 4.0.1 Release Notes
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-2
Proper Use of Validation and Test Data . . . . . . . . . . . . . . . . . . 22-2
Correct Version 3 Object Loading . . . . . . . . . . . . . . . . . . . . . . . 22-2
Optimization Toolbox 2.1.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-2
Support for Large Problems that Are Not Well-Scaled . . . . . . 23-2
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-3
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 23-4
xv
xvi Contents
Power System Blockset 2.2 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2
Powergui Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2
New powerlib_extras Documentation . . . . . . . . . . . . . . . . . . . . 24-2
Real-Time Workshop Ada Coder 4.1 Release Notes
Release Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-2
Real-Time Workshop Embedded Coder 2.0
Release Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-2
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-3
Custom Storage Classes for Data Objects . . . . . . . . . . . . . . . . 26-3
Enhanced Code Generation Options . . . . . . . . . . . . . . . . . . . . . 26-4
Virtualized Output Ports Optimization . . . . . . . . . . . . . . . . . . 26-4
Improved HTML Code Generation Report . . . . . . . . . . . . . . . . 26-4
Requirements Management Interface 1.0.2 Release
Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-2
Support for the Latest DOORS Release . . . . . . . . . . . . . . . . . . 27-2
Signal Processing Toolbox 5.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-2
Filter Visualization Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-2
New Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-3
New Signal Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-4
Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-5
FDATool Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-5
SPTool Enhancement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-5
Enhanced Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-6
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-7
Bug Fixes Incorporated from Release 12.0 . . . . . . . . . . . . . . . . 28-7
Platform Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-8
FDATool — 640 x 480 Resolution . . . . . . . . . . . . . . . . . . . . . . . 28-8
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 28-9
Changes to remez . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-9
Known Software Problem . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28-10
FDATool and FVTool Pole/Zero Plot . . . . . . . . . . . . . . . . . . . . 28-10
FDATool and FVTool Magnitude and Phase Plot . . . . . . . . . 28-10
Simulink Performance Tools 1.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29-2
Model Coverage Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29-2
Graphical Merge Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29-4
xvii
xviii Contents
Platform Limitations for HP and IBM . . . . . . . . . . . . . . . . . . 29-6
Limited Support Model Coverage Tool . . . . . . . . . . . . . . . . . . . 29-6
Graphical Merge Tool Not Supported . . . . . . . . . . . . . . . . . . . . 29-6
Simulink Report Generator 1.2 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30-2
Block Type: Look-Up Table Component Reports on
N-D Look-Up Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30-2
Real-Time Workshop Requirement Removed for
Some Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30-2
Image Titles for Snapshot Components . . . . . . . . . . . . . . . . . . 30-3
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 30-4
Use of Existing SGML Files . . . . . . . . . . . . . . . . . . . . . . . . . . . 30-4
Stateflow Coder 4.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31-2
Single-Precision Constants in Code Generation . . . . . . . . . . . 31-2
Major Bugs Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31-3
Code Generation for Default Transitions in Parallel States . . 31-3
Code Generation for Double-Precision Whole Numbers . . . . . 31-3
System Identification Toolbox 5.0.1 Release Notes
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 32-2
Syntax of data Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32-2
Theta Models No Longer Supported . . . . . . . . . . . . . . . . . . . . . 32-2
Virtual Reality Toolbox 2.0 Release Notes
Introduction to the Virtual Reality Toolbox . . . . . . . . . . . . 33-2
Simulink Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33-2
MATLAB Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33-2
Virtual Reality Modeling Language (VRML) . . . . . . . . . . . . . . 33-2
VRML Viewing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33-3
VRML Authoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33-3
Updated Documentation Coming in Printed and
Web-Downloadable Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33-3
Wavelet Toolbox 2.1 Release Notes
GUI Improvements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34-2
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34-3
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . 34-4
xPC Target 1.2 Release Notes
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35-2
UDP Driver Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35-2
xix
xx Contents
Asynchronous Event (Interrupt) Support . . . . . . . . . . . . . . . . . 35-2
CAN FIFO Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35-3
100 Mbit/Second Ethernet Support . . . . . . . . . . . . . . . . . . . . . . 35-3
Fixed-Point Kernel Support . . . . . . . . . . . . . . . . . . . . . . . . . . . 35-3
Increased Data Upload Speed . . . . . . . . . . . . . . . . . . . . . . . . . . 35-3
I/O Device Driver Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35-3
Known Software and Documentation Problems . . . . . . . . . 35-4
Uploading Data with External Mode . . . . . . . . . . . . . . . . . . . . 35-4
Target Command Line Interface . . . . . . . . . . . . . . . . . . . . . . . . 35-4
Memory-Mapped Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35-4
Selecting a Working Directory Inside the MATLAB
Root Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35-4
Release Notes for Release 12.1
Upgrading from Earlier Releases
The Release Notes for Release 12.1 describe differences between Release 12.1 and Release 12.0. These Release Notes contain links to the Release Notes for
Release 12, which provide information about upgrading to Release 12.1 from a release earlier than Release 12.0.
What’s in These Release Notes?
Chapter 1 gives an overview of the major features in Release 12.1. That chapter also summarizes platform limitations and provides some installation notes.
The other chapters describe products with major updates in more detail. As applicable, those chapters include information about a product’s:
• New features
• Major bug fixes
• Platform limitations
• Upgrade issues
• Known software and documentation problems
Core Products with Significant Updates for Release 12.1
• MATLAB
• Simulink
• Stateflow and Stateflow Coder
• Real-Time Workshop
Other Products with Significant Updates for Release 12.1
CDMA Reference
Blockset
Communications
Blockset
Control System
Toolbox
Data Acquisition
Toolbox
Database Toolbox
Datafeed Toolbox
Financial Time Series
Toolbox
Fixed-Point Blockset
Image Processing
Toolbox
Instrument Control
Toolbox
MATLAB C/C++
Math Library
MATLAB Runtime
Server
Real-Time Embedded
Coder
Real-Time Workshop
Ada Coder
Requirements
Management
Interface
Signal Processing
Toolbox
Simulink
Performance Tools
Simulink Report
Generator
DSP Blockset Neural Network
Toolbox
System Identification
Toolbox
Excel Link
Filter Design Toolbox
Optimization Toolbox Wavelet Toolbox
Power System
Blockset xPC Target
New Products for Release 12.1
• Virtual Reality Toolbox
• Developer’s Kit for Texas Instruments™ DSP
Products with Minor Updates for Release 12.1
These products have minor updates for Release 12.1, but are not documented in these Release Notes. The product names with links take you to the Release
Notes for Release 12 or the Release Notes for Release 11.1.
Communications
Toolbox
Dials & Gauges
Blockset
Financial Toolbox
Fuzzy Logic Toolbox
MATLAB C/C++
Graphics Library
Nonlinear Control
Design Toolbox
MATLAB Report
Generator
Partial Differential
Equation Toolbox
MATLAB Web Server Real-Time Windows
Target
Model Predictive
Control Toolbox
Robust Control
Toolbox
MATLAB Compiler
Printable Version of the Release Notes
A printable version of the Release Notes for Release 12.1 is available in PDF format.
Introducing Release 12.1
What’s New in Release 12.1? . . . . . . . . . . . . . 1-2
Updated Products . . . . . . . . . . . . . . . . . . 1-2
New Products . . . . . . . . . . . . . . . . . . . . 1-16
Platform Limitations . . . . . . . . . . . . . . . . 1-17
Differences for the HP and IBM Platforms . . . . . . . . 1-17
Problems Entering Accented Characters on Linux . . . . . 1-18
Problems Entering Accented Characters on UNIX Platforms . 1-18
Installation Notes . . . . . . . . . . . . . . . . . 1-19
Maintaining Preference Files After Uninstalling . . . . . . 1-19
Correcting the Documentation Location . . . . . . . . . 1-19
Linux Distribution Notes . . . . . . . . . . . . . . 1-20
For More Information About What’s New
in Release 12.1 . . . . . . . . . . . . . . . . . 1-21
Printable Version of the Release Notes . . . . . . . . . . 1-21
1
1
Introducing Release 12.1
What’s New in Release 12.1?
Release 12.1 includes significant enhancements to our code generation capabilities and the introduction of two new products. This release also includes major updates to the Image Processing Toolbox and several other products, as well as important bug fixes for many products.
This section includes the following two subsections:
• “Updated Products” on page 1-2
Updated Products
The table below lists the products that were updated for Release 12.1. For each product, the table indicates whether the update includes new features, bug fixes, or both. The new features for each product are briefly summarized following the table below, and discussed in more detail in a separate chapter in the online version of the Release Notes for Release 12.1. Some products include major bug fixes in this release and others include minor bug fixes. The minor bug fixes are not documented in these Release Notes.
Product
Stateflow® 4.1 and Stateflow Coder
Communications Toolbox 2.0.1
(no chapter in these Release Notes)
New Features
✔
✔
✔
✔
✔
✔
✔
Bug Fixes major major major major minor minor minor minor
1-2
What’s New in Release 12.1?
Product
Dials & Gauges Blockset 1.1.1
(no chapter in these Release Notes)
Financial Time Series Toolbox 1.1
Financial Toolbox 2.1.3
(no chapter in these Release Notes)
Fuzzy Logic Toolbox 2.1.1
(no chapter in these Release Notes)
Instrument Control Toolbox 1.1
MATLAB Compiler 2.2
(no chapter in these Release Notes)
MATLAB C/C++ Graphics Library
2.2
(no chapter in these Release Notes)
MATLAB Report Generator 1.2
(no chapter in these Release Notes)
New Features
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
Bug Fixes minor minor minor minor minor minor minor major minor minor minor minor minor minor minor minor minor minor
1-3
1
Introducing Release 12.1
Product
MATLAB Web Server 1.2.1
(no chapter in these Release Notes)
Model Predictive Control Toolbox
1.0.6
(no chapter in these Release Notes)
Neural Network Toolbox 4.0.1
Nonlinear Control Design Toolbox
1.1.5
(no chapter in these Release Notes)
Partial Differential Equation
Toolbox 1.0.4
(no chapter in these Release Notes)
Real-Time Windows Target 2.1
(no chapter in these Release Notes)
Real-Time Workshop Ada Coder 4.1
Robust Control Toolbox 2.0.8
(no chapter in these Release Notes)
Simulink Performance Tools 1.1
New Features
✔
✔
✔
✔
✔
✔
✔
✔
✔
Bug Fixes minor minor minor major minor minor minor minor minor minor minor minor minor minor minor minor
1-4
What’s New in Release 12.1?
Product
System Identification Toolbox 5.0.1
New Features
✔
✔
✔
Bug Fixes minor minor minor
MATLAB 6.1
Major enhancements to MATLAB 6.1 involve the following aspects of
MATLAB:
• Development environment, including:
- Editor/Debugger additional functionality and improvements
- Command Window line wrapping and ability to open the Editor from an error message
- Improved Workspace Browser sorting
- Improved source control feature support for Merant PVCS
• Mathematics, including:
- Evaluation of solutions to differential equation problems
- Additional functions use Qhull
- Several new or enhanced math functions
• Programming and data types, including:
- Support for partial evaluation of if and while expressions
- A new MATLAB search string function ( strfind )
- New file I/O functions for scientific data formats
- New audio functions
• Graphics, including:
- Additional support for Ghostscript
- Transparent legends
• OpenGL renderer support
1-5
1
Introducing Release 12.1
• External interfaces, including:
- Concatenation of Java arrays
- New Fortran MEX, MX, MAT, and ENG functions
- Serial I/O enhancements
• Creating graphical user interfaces (GUIDE), with enhancements to the
Layout Editor and the Menu Editor
Simulink 4.1
Major enhancements to Simulink 4.1 include:
• The Simulink Editor new features and enhancements, such as:
- Autoconnection and autorouting for blocks and signals
- Undo option improvements
- Ability to save Release 11 format models
• Modeling enhancements, including an S-Function Builder for generating an
S-function from a specification and generating code for Real-Time Workshop
• Block Library additions and enhancements, such as:
- New control flow blocks For Iterator, If, Switch Case, and While Iterator
- New Bus Creator block for combining the output of multiple blocks into a single signal bus
- Additional data type support for some blocks
- Floating Scope block, with enhancements for signal selection and saving selected signals
Note See “Simulink Performance Tools 1.1” on page 1-14, if you have that
product.
Stateflow 4.1 and Stateflow Coder 4.1
The major enhancements to Stateflow 4.1 and Stateflow Coder 4.1 include:
• More search capabilities added to Stateflow’s Search & Replace tool
• Stateflow charts now include the graphical innovation of “smart” transitions whose ends slide around the surfaces of states and junctions.
1-6
What’s New in Release 12.1?
• Chart annotation that is similar to Simulink annotation
• The Simulink Model Coverage tool now performs model coverage calculations for decisions and conditions of decision
Real-Time Workshop 4.1
Real-Time Workshop 4.1 has significant new and enhanced features and many improvements in the quality of generated code, including:
• Expression folding, which removes temporary variables, making the code more efficient and readable
• External mode support for inlined parameters
• Block states interface to externally written code, in a manner similar to signals.
• New debugger for Target Language Compiler (TLC) programs
• Support for new Simulink blocks, including control flow constructs such as do-while , for , and if
• Numerous bug fixes
Note See “Real-Time Workshop Ada Coder 4.1” on page 1-13 and “Real-Time
Embedded Coder 2.0” on page 1-13, if you have those products.
CDMA Reference Blockset 1.1
The CDMA Reference Blockset 1.1 supports frame-based signals and matrix signals. As a result, it is no longer necessary to change the signal attributes of blocks from the Communications Blockset or the DSP Blockset to use them in models with blocks from the CDMA Reference Blockset.
Communications Blockset 2.0.1
The enhancements to the Communications Blockset 2.0.1 include:
• A script that sets certain model preferences appropriately
• New blocks that convert between bipolar and unipolar signals
• A new function that generates seeds for random-output blocks
1-7
1
Introducing Release 12.1
• The ability to have error statistics determine the duration of the simulation
• A more flexible integrator block
The Communications Blockset 2.0.1 online documentation set now includes a new document, called “Getting Started with the Communications Blockset.”
Control System Toolbox 5.1
Major enhancements to the Control System Toolbox 5.1 include:
• Several important enhancements to the SISO Design Tool to make it more powerful and easier to use
• Enhancements to controls algorithms, such as:
- M-circle support in the nyquist function
- A new function, bandwidth , that calculates the bandwidth of SISO systems
- For LTI models with complex data, an option to specify transfer functions or state-space models with complex coefficients
Data Acquisition Toolbox 2.1
Major enhancements to the Data Acquisition Toolbox 2.1 include support for:
• The following additional National Instruments boards:
- 445x Dynamic Signal Acquisition (DSA) Series boards
- Analog output boards
- Digital I/O boards (no streaming)
• High resolution (greater than 16-bit) sound cards. Note that some sound card drivers may not support this feature because they are still in beta.
Database Toolbox 2.2
Major enhancements to the Database Toolbox 2.2 include:
• Retrieval of data as numeric, structure, or cell array format, as specified via preferences. In previous versions of the Database Toolbox, only the cell array format was supported. The numeric format allows for a significant reduction in memory usage. The structure format allows the retrieved data to be accessed as a MATLAB structure.
1-8
What’s New in Release 12.1?
• A preference for handling errors to be store , report , or empty . In previous versions of the Database Toolbox, only the store option was supported. The report option immediately displays any retrieval error messages in the
Command Window.
• Support for LONGCHAR data type, which is called the Memo data type in
Microsoft Access.
Datafeed Toolbox 1.3
The Datafeed Toolbox 1.3 adds the Hyperfeed data server to the list of previously supported servers (i.e., Bloomberg, FT Interactive Data, and
Yahoo).
Developer’s Kit for Texas Instruments DSP 1.1
Note The Developer’s Kit for Texas Instruments™ DSP 1.0 was released in a
Web-downloadable format prior to Release 12.1. Version 1.1 of this product includes some important updates to Version 1.0, as summarized below.
The major Developer’s Kit for Texas Instruments DSP 1.1 enhancements include:
• Five new functions that extend the program debugging and project management capabilities of the Developer’s Kit
• New interface between the Developer’s Kit and FDATool
• Unified CCS IDE and C6701 EVM targeting
• New run-time libraries
• Architectural changes to the CCSDSP object to speed up processing and support future target development
1-9
1
Introducing Release 12.1
DSP Blockset 4.1
Major enhancements to the DSP Blockset 4.1 include:
• The new Digital Filter Design block, which implements filters that you design in the Filter Design and Analysis Tool (FDATool)
• Enhancements to several blocks:
- Major enhancements to the FFT, IFFT, Magnitude FFT, Overlap-Add
FFT, Overlap-Save FFT, Random Source, Sine Wave, Unwrap, and
Window Function blocks
- Additional data type support of Simulink built-in data types, fixed-point data types, and custom data types
- Improved memory management for both simulation and Real-Time
Workshop C code generation
- Smaller, more efficient Real-Time Workshop generated code
• Extensible C-callable simulation and run-time library functions, macros, and definitions for use with your S-functions and Real-Time Workshop C code
Excel Link 1.1.3
Major enhancements to the Excel Link 1.1.3 include:
• Installation under control of the FLEXlm license manager, as with other
MathWorks products
• Additional error detection
Filter Design Toolbox 2.1
Major enhancements to the Filter Design Toolbox 2.1 include:
• Many new adaptive filtering functions
• Four new FIR filter design functions
• The new zerophase analysis function that returns the zero-phase response of a linear-phase FIR filter
• Several new filter transformation functions
• The FDATool’s new Transformation option that can save you from repeating the filter design process
• Context-sensitive help for the FDATool Quantization mode
1-10
What’s New in Release 12.1?
Financial Time Series Toolbox 1.1
The Financial Time Series Toolbox 1.1 includes the following features that were introduced in the Web-downloadable release of this product prior to
Release 12.1:
• Several new functions, including bar chart plotting functions
• A new Financial Time Series GUI that provides complete access to the full functionality of the Financial Time Series Toolbox
Fixed-Point Blockset 3.1
Major enhancements to the Fixed-Point Blockset 3.1 include:
• Tools to support approximating functions with look-up tables
• Support for matrix and frame-based signals
• More efficient code generation
• Many new blocks that enable you to do common operations more easily; some of the operations these new blocks support are:
- Calculations that depend on sample time
- Generating arbitrary wave forms
- Limiting the rate of control signals
Image Processing Toolbox 3.1
Major enhancements to the Image Processing Toolbox 3.1 include those introduced in Version 3.0, which was released in Web-downloadable form shortly before Release 12.1. The new features introduced in the Image
Processing Toolbox, Version 3.0, include:
• Many new morphology functions
• New spatial transformation functions
• New image registration functions, with a new graphical user interface
• New integer image arithmetic functions
• New Integer image filtering function
• New image deblurring (deconvolution) functions
• Support for DICOM files
1-11
1
Introducing Release 12.1
• Miscellaneous new functions
• New image processing demos
The new features introduced in the Image Processing Toolbox, Version 3.1, include:
• New deblurring function, deconvblind , that implements the blind deconvolution algorithm
• New utility function, label2rgb , that converts a label matrix into an RGB color image
Instrument Control Toolbox 1.1
The major enhancement to the Instrument Control Toolbox 1.1 is Binary block
(binblock) data transfer.
MATLAB C/C++ Math Library 2.2
Major enhancements to the MATLAB C/C++ Math Library 2.2 include:
• New library functions that evaluate the solution of a differential equation problem using the output of ode45 , ode23 , ode113 , ode15s , ode23s , ode23t , ode23tb , or bvp4c
• Enhancements to library functions for:
- Eigenvalues
- Eigenvectors
- Ordinary differential equations (ODEs)
MATLAB Runtime Server 6.1
The MATLAB Runtime Server 1.1 includes a new tool, makeconfig, for generating the configuration file for packaging an application.
Optimization Toolbox 2.1.1
In the Optimization Toolbox 2.1.1, large-scale finite differencing is improved numerically to handle cases when an optimization problem is not well scaled.
1-12
What’s New in Release 12.1?
Power System Blockset 2.2
Major enhancements to the Power System Blockset 2.2 include:
• The new Powergui tool Display spectrum of Signal feature, which displays the fast Fourier transform (FFT) of a specified signal
• Documentation for several blocks in the powerlib_extras library that were previously undocumented
Real-Time Workshop Ada Coder 4.1
The Real-Time Workshop Ada Coder 4.1 supports all applicable new features added to the Real-Time Workshop 4.1.
Real-Time Embedded Coder 2.0
Major enhancements to the Real-Time Embedded Coder 2.0 include:
• Significant improvements in efficiency and readability of generated code
(many improvements in Real-Time Workshop code generation technology are especially applicable to embedded systems development, such as expression folding and buffer optimizations)
• Custom storage classes for signal, state, and parameter objects, for embedded systems development
• Additional and enhanced code generation options
• Improved HTML code generation report
• Generated ERT S-function, which supports the Fixed-Point Blockset
• More streamlined model initialization
Requirements Management Interface 1.0.2
The Requirements Management Interface 1.0.2 now works with the latest
DOORS release, Version 5.1.
Signal Processing Toolbox 5.1
Major enhancements to the Signal Processing Toolbox 5.1 include:
• The new Filter Visualization Tool ( fvtool ) that groups all the filter analysis functions, such as magnitude, phase, impulse response, etc., into a single window where you can easily switch between analyses, add annotations, and print your filter response
1-13
1
Introducing Release 12.1
• Many FDATool enhancements
• The ability to print preview and print your filter design in the SPTool Filter
Viewer and Filter Designer
• Six new window functions and a general window function
• Five other new functions and enhancements to several functions
• A new demo, Vector Transition Processing Using Spectral Windows
Simulink Performance Tools 1.1
Major enhancements to the Simulink Performance Tools 1.1 to two tools:
• Model Coverage Tool improvements, including:
- Coverage analysis extended to include coverage for conditions (Logic block and Stateflow transitions), modified condition/decisions (MC/DC), and look-up tables.
- Increased coverage for more blocks
• Renaming the Model Differencing Tool to be the Graphical Merge Tool, to reflect its new model merging capability, including:
- Options to compare in-memory, on-disk, and source control system versions of models
- Improvements to graphical user interface display
Simulink Report Generator 1.2
Major enhancements to the Simulink Report Generator 1.2 include:
• The Block Type: Look-Up Table component that now reports on N-D look-up tables (as well as 1-D and 2-D look-up tables)
• For some components, removal of the previous requirement for Real-Time
Workshop
• The ability to add titles to images for the System Snapshot and Stateflow
Snapshot components
System Identification Toolbox 5.0.1
The System Identification Toolbox 5.0.1 adds a new function, getexp , which obsoletes the data(...) syntax.
1-14
What’s New in Release 12.1?
Wavelet Toolbox 2.1
Major enhancements to the Wavelet Toolbox 2.1 include:
• Reorganization and improvement of GUI menus
• The new disp method, which displays information for a WPTREE object
• The new wavefun2 function returns the 2-D scaling and wavelet functions from tensor products of 1-D scaling and wavelet functions
xPC Target 1.2
Major enhancements to the xPC Target 1.2 include:
• A C API to create stand-alone graphical user interfaces (GUIs) with a real-time target application (xPC Target includes examples for Visual C/C++ and Visual BASIC)
• Support for:
- User Datagram Protocol (UDP) packets
- CAN FIFO model I/IO drivers, for monitoring an entire CAN network or minimizing driver latency for certain applications
- Additional I/O device drivers
- 10 or 100 megabit/second communication between the host and target computers for downloading real-time application and uploading signal data
- Fixed-point kernel, for PCs (CPUs) that do not have a hardware floating-point unit
- The creation of subsystems that execute asynchronously when an event
(interrupt) occurs (these subsystems can communicate and be part of a larger model that executes with a monotonic step size)
• Log data uploading about five times faster or better; scope data uploading about three times faster
1-15
1
Introducing Release 12.1
New Products
The following products are new since Release 12.0. These products were made available in Web-downloadable form prior to the availability of Release 12.1:
• Virtual Reality Toolbox 2.0
• Developer’s Kit for Texas Instruments™ DSP 1.1
Note The Developer’s Kit for Texas Instruments™ DSP 1.0 was released as in a Web-downloadable format prior to Release 12.1. Version 1.1 of this product includes some important updates to Version 1.0.
1-16
Platform Limitations
Platform Limitations
For Release 12.1, all the features described in these Release Notes and in the
Release 12.1 documentation are supported in full for the following platforms:
• Microsoft Windows 95, Windows 98, Windows 2000, Windows Millenium, and Windows NT
• Compaq Alpha
• Linux
• SGI
• Sun Solaris
Note As in Release 11 and Release 12, there are some minor differences between Windows and UNIX for specific tools, as documented for those tools.
For details about each of these platforms, see the Support page of the
MathWorks Web page, at http://www.mathworks.com
.
Differences for the HP and IBM Platforms
Note The Release 12 platform limitations for the HP and IBM platforms still apply to Release 12.1. In addition, there are a few limitations new in Release
12.1, as described below.
1-17
1
Introducing Release 12.1
Release 12.1-Specific Limitations on HP and IBM Platforms
Product Limitations on HP and IBM Platforms
Image Processing
Toolbox
The cpselect GUI is not supported.
Simulink The following new Simulink features are not supported:
• Simulink Data Class Designer
• S-Function Builder
Problems Entering Accented Characters on Linux
On Linux platforms, using an accent key to accent a character in a two-stroke sequence in a MATLAB window, such as ^e for ê or ~n for ñ, may cause
MATLAB to hang. To avoid this problem in MATLAB, use matlab -nodesktop .
With Simulink, avoid the use of these keystrokes. To use characters such as the caret ^ when it is mapped as a dead-accent key, you must paste it into the
MATLAB IDE from a non-MATLAB window, such as an xterm, or use the power and mpower functions directly.
Problems Entering Accented Characters on UNIX
Platforms
Keys for accented characters, such as Ü on German keyboards and Å on
Swedish keyboards are ignored in the IDE. Pasting these characters into
MATLAB windows results in the character value 128 instead of the actual character value. For example, pasting the string double( ¯˜ ) into
MATLAB appears as double(' ') ans =
128 128 128 128 128 128 128
1-18
Installation Notes
Installation Notes
Maintaining Preference Files After Uninstalling
If you use the Release 12 uninstaller, it will automatically remove your preference files including the Command History, preferences, and Help browser favorites.
To keep these files for use in Release 12.1, make a copy of them before uninstalling Release 12. To see where the files are located, run prefdir in the
Command Window. The relevant files are listed below.
Filename cwdhistory.m
history.m
matlab.prf
matlab_help.hst
File For
Command Window history
Command History
Preferences
Help browser favorites
After uninstalling Release 12, put your backup copy of the files in the location returned by prefdir so that Release 12.1 can use the files.
Correcting the Documentation Location
On Windows concurrent license systems and on UNIX systems, if you installed
Release 12.1, including the help files, in a different location than Release 12.0
(as is recommended), the Help browser will not find the Release 12.1 help files.
When you run the Help browser, you will either see the Release 12.0 help files or you will see a warning stating that the help files cannot be found. To use the
Release 12.1 help files, select File -> Preferences -> Help and change the
Documentation Location for Local or network directory to the location of
Release 12.1 help files. The location is the help directory under the MATLAB
Release 12.1 directory, for example, d:\matlab_r12_1\help .
For single user Windows systems, the Help browser should automatically find the Release 12.1 help files, but if it does not, change the Documentation
Location as described above.
1-19
1
Introducing Release 12.1
Linux Distribution Notes
As of this writing, the following distributions are known to work:
• Redhat 7.0
• Mandrake 8.n
• SuSE 7.0
• Debian 2.1 and 2.2
• Slackware 7.1
1-20
For More Information About What’s New in Release 12.1
For More Information About What’s New in Release 12.1
For more detailed information about each product that is included in Release
12.1, see the sections of the online version of the Release Notes for the product(s) of interest to you. In those sections, as applicable, you can find out about a product’s:
• New features
• Major bug fixes
• Platform limitations
• Issues relating to upgrading from an earlier release
• Known software and documentation problems
The online Release Notes include links to the rest of the online documentation, where you can get detailed information about how to use the new and enhanced features.
Printable Version of the Release Notes
A printable version of the Release Notes for Release 12.1 is available in PDF format.
1-21
1
Introducing Release 12.1
1-22
MATLAB Software Acknowledgments
MATLAB and its associated products incorporate the following third-party software:
ARnoldi PACKage (ARPACK)
Rich Lehoucq, Kristi Maschhoff, Danny Sorensen, and Chao Yang http://www.caam.rice.edu/software/ARPACK
Automatically Tuned Linear Algebra Software (ATLAS)
R. Clint Whaley and Jack Dongarra http://www.netlib.org/atlas fft and related MATLAB functions are based on the FFTW library
Developed by Matteo Frigo and Steven G. Johnson
Copyright
1997-1999 Massachusetts Institute of Technology. All rights reserved.
Used under terms of a commercial license http://www.fftw.org
HDF capability in the functions imread , imwrite , imfinfo , and hdf is based on code of which portions were developed at
The National Center for Supercomputing Applications at the University of Illinois at
Urbana-Champaign.
JPEG capability in the functions imread , imwrite , imfinfo , print , and saveas
This software is based in part on the work of the Independent JPEG Group.
Linear Algebra PACKage (LAPACK) http://www.netlib.org/lapack (for general information about LAPACK)
For details, see the LAPACK User’s Guide .
E. Anderson, Z. Bai, C. Bischof, L. S. Blackford, J. Demmel, J. Dongarra, J. Du Croz, A. Greenbaum,
S. Hammarling, A. McKenney, and D. Sorensen
For a printed version of the LAPACK User’s Guide , go to http://www.siam.org
.
For an online version of the LAPACK User’s Guide, go to http://www.netlib.org/lapack/lug/lapack_lug.html
.
Qhull based computational geometry capability in MATLAB
Qhull copyright (c) 1993 The National Science and Technology Research Center for Computation and Visualization of Geometric Structures, The Geometry Center, University of Minnesota e-mail: [email protected]
For complete copyright information, issue the MATLAB command help qhull .
Sparse matrix minimum degree permutation functions colamd and symamd
Copyright
1998-2000 by the University of Florida. All rights reserved.
Authors of the code are Stefan I. Larimore and Timothy A. Davis ( [email protected]
), University of
Florida. The algorithm was developed in collaboration with John Gilbert, Xerox PARC, and Esmond Ng,
Oak Ridge National Laboratory.
This work was supported by the National Science Foundation, under grants DMS-9504974 and
DMS-9803599.
For complete copyright information, issue the MATLAB command edit colamd or edit symamd .
TIFF capability in the functions imread , imwrite , imfinfo , print , and saveas :
Copyright
Copyright
1988-1999 Sam Leffler
1991-1999 Silicon Graphics, Inc.
Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that (i) the above copyright notices and this permission notice appear in all copies of the software and related documentation, and (ii) the names of Sam Leffler and
Silicon Graphics may not be used in any advertising or publicity relating to the software without the specific, prior written permission of Sam Leffler and Silicon Graphics.
THE SOFTWARE IS PROVIDED “AS-IS” AND WITHOUT WARRANTY OF ANY KIND, EXPRESS,
IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL SAM
LEFFLER OR SILICON GRAPHICS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING
FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF
DAMAGE, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH
THE USE OR PERFORMANCE OF THIS SOFTWARE.
MATLAB 6.1 Release
Notes
New Features . . . . . . . . . . . . . . . . . . . 2-2
Development Environment Features . . . . . . . . . . . 2-2
Mathematics Features . . . . . . . . . . . . . . . . 2-5
Programming and Data Types Features . . . . . . . . . 2-8
Graphics Features . . . . . . . . . . . . . . . . . . 2-10
OpenGL Renderer Feature — Microsoft Windows . . . . . 2-11
External Interfaces/API Features . . . . . . . . . . . . 2-12
Creating Graphical User Interfaces — GUIDE . . . . . . . 2-17
Major Bug Fixes . . . . . . . . . . . . . . . . . . 2-18
Development Environment . . . . . . . . . . . . . . . 2-18
Mathematics . . . . . . . . . . . . . . . . . . . . 2-18
Platform Limitations . . . . . . . . . . . . . . . . 2-20
Patch Required for HP-UX 11.0 . . . . . . . . . . . . . 2-20
Mathematics Limitations . . . . . . . . . . . . . . . 2-20
Graphics and Printing Limitations . . . . . . . . . . . 2-21
GUIDE Limitations . . . . . . . . . . . . . . . . . . 2-21
Upgrading from an Earlier Release . . . . . . . . . 2-26
Development Environment Issues . . . . . . . . . . . . 2-26
Mathematics Issues . . . . . . . . . . . . . . . . . 2-27
Programming and Data Types Issues . . . . . . . . . . 2-28
Graphics Issue . . . . . . . . . . . . . . . . . . . . 2-29
External Interfaces/API Issues . . . . . . . . . . . . . 2-30
Known Software and Documentation Problems . . . . 2-32
Development Environment Problems . . . . . . . . . . 2-32
Documentation Updates . . . . . . . . . . . . . . . . 2-33
2
2
MATLAB 6.1 Release Notes
New Features
This section introduces the new features and enhancements added in MATLAB
6.1 since MATLAB 6.0 (Release 12.0).
For information about MATLAB features that are incorporated from recent releases, see the Release Notes for Release 12.
This section about new features is organized into the following subsections:
• “Development Environment Features” on page 2-2
• “Mathematics Features” on page 2-5
• “Programming and Data Types Features” on page 2-8
• “Graphics Features” on page 2-10
• “OpenGL Renderer Feature — Microsoft Windows” on page 2-11
• “External Interfaces/API Features” on page 2-12
• “Creating Graphical User Interfaces — GUIDE” on page 2-17
Development Environment Features
Command Window
MATLAB 6.1 includes two command window enhancements:
• You can set a preference for the command window to wrap lines. Input and output lines wrap to fit within the current width of the command window.
• If an error message appears when running an M-file, click on the underlined portion of the error message, or press Ctrl+Enter. The offending M-file opens in the Editor, scrolled to the line containing the error.
Help Browser
When you select documentation for the product filter, you can clear all currently selected products or select all products.
2-2
New Features
Editor/Debugger
The Editor/Debugger has the following enhancements:
• You can set bookmarks in M-files in the Editor/Debugger so that you can go directly to a particular line in the file. To set a bookmark, position the cursor at the line you want to bookmark, and then select Set/Clear Bookmark from the Edit menu.
After setting bookmarks, you can go to the next or previous bookmark in a file. This allows you to go directly to a marked spot. Use the Edit menu items
Next Bookmark and Previous Bookmark to navigate. Bookmarks are not saved when you close a file.
• You can include line numbers when printing files from the Editor/Debugger.
To include line numbers, select Preferences -> Editor/Debugger ->
Printing . Under Print options, check Print line numbers.
• You can use keyboard shortcuts to comment or uncomment a selection in the
Editor/Debugger. The shortcuts are platform dependent and are listed with the menu items on the Editor/Debugger Text menu.
• In the Find/Replace dialog box, settings for Match case, Whole word, and
Wrap around are remembered for the next MATLAB session.
• You can find the previous occurrence of a selection in the Editor/Debugger by pressing Ctrl+Shift+F3. You can also find the previous occurrence of a string you entered into the Find & Replace dialog box by pressing Shift+F3.
• When you move an arrow key over a token, for example, an opening parenthesis, (, the token and its match are briefly underlined. If there is no matching token, the token appears with a strike-through mark, .
• When you run a file from the Editor/Debugger and the file is not in a directory on the search path or in the current directory, a dialog box appears presenting you with options that allow you to run the file. You can either change the current directory to the directory containing the file, or you can add to the search path the directory containing the file.
If the file you want to run is already in a directory on the search path or in the current directory, the current directory remains as is and there are no actions you need to take.
2-3
2
MATLAB 6.1 Release Notes
• When you add a breakpoint to a file that is not in a directory on the search path or in the current directory, a dialog box appears presenting you with options that allow you to add the breakpoint. You can either change the current directory to the directory containing the file, or you can add to the search path the directory containing the file.
If the file you want to run is already in a directory on the search path or in the current directory, the current directory remains as is and there are no actions you need to take.
• If you type edit filename and filename does not exist, a prompt appears asking if you want to create a new file. If you select Yes, a blank file titled filename.m
is created in the Editor/Debugger. You can turn off this option in preferences for the Editor/Debugger.
Current Directory Browser
In the Find/Replace dialog box, settings for Match case, Whole word, and
Subdirectories are remembered for the next MATLAB session.
Also, you can delete directories that are not empty. All contents of the directory will be deleted along with the directory.
Workspace Browser
You can select the column on which to sort in the Workspace browser, as well as reverse the sort order of any column. Click on a column heading to sort on that column. Click on the column heading again to reverse the sort order in that column. For example, to sort on Size, click the column heading once. To change from ascending to descending, click on the heading again.
Source Control
If you use Merant PVCS with MATLAB source control features, you no longer need to specify the project configuration file using cmopts . If you did specify it in previous releases, you do not have to remove it as MATLAB will ignore it.
General
The computer function now displays the endian byte ordering of the computer with the following form.
[str,maxsize,endian] = computer
2-4
New Features
Mathematics Features
Evaluation of Solutions to Differential Equation Problems
A new function, deval , enables you to evaluate the solution of a differential equation problem at a vector of points from the interval in which the problem was solved. deval uses, as input, the output structure sol of an initial value problem solver ( ode45 , ode23 , ode113 , ode15s , ode23s , ode23t , ode23tb ) or the boundary value problem solver ( bvp4c) . A new ODE solver syntax returns the structure sol .
Additional Functions Use Qhull
These functions are now based on Qhull:
• delaunay — two-dimensional Delaunay triangulation
• convhull — two-dimensional convex hull
These functions call delaunay and therefore are now indirectly based on Qhull:
• voronoi — two-dimensional Voronoi diagrams
• griddata — data gridding and surface fitting
These functions are in addition to the Qhull-based functions introduced in
MATLAB 6.0 (Release 12.0): convhulln , delaunay3 , delaunayn , griddata3 , griddatan , and voronoin .
Math Function Summary Tables
This section summarizes:
• Functions with new or changed capabilities
Note See “Upgrading from an Earlier Release” on page 2-26 for information
2-5
2
MATLAB 6.1 Release Notes
New Math Functions
Function Purpose deval Evaluate the solution of a differential equation problem using the output of ode45 , ode23 , ode113 , ode15s , ode23s , ode23t , ode23tb , or bvp4c .
erfcinv tetramesh triplot
Inverse complementary error function.
Tetrahedron mesh plot for use with delaunayn .
2-D triangular plot for use with delaunay .
Math Functions with New or Changed Capabilities
Function Enhancement/Change bvpinit New syntax solinit = bvpinit(sol,[anew bnew]) extrapolates a solution sol as an initial guess for solving a
BVP on an extended interval. It can copy parameters from the previous iteration or let the user to provide new ones.
For more information, see “Boundary Value Problems for
ODEs” in the MATLAB documentation.
bvpset convhull convhulln
New Vectorized option lets you pass to the solver bvp4c an array of column vectors. This allows bvp4c to reduce the number of function evaluations, and may significantly reduce solution time. For more information see “Boundary
Value Problems for ODEs” in the MATLAB documentation.
New syntax [K,a] = convhull(x,y) returns the area a of the convex hull.
New syntax [K,v] = convhulln(X) returns the volume v of the convex hull.
2-6
New Features
Math Functions with New or Changed Capabilities
(Continued)
Function Enhancement/Change numel New syntax n = numel(A, varargin) returns the number of subscripted elements, n , in
A(index1,index2,...,indexn) , where varargin is a cell array whose elements are index1 , index2 , ...
, indexn .
ode45 , ode23 , ode113 , ode15s , ode23s , ode23t , ode23tb polyeig
New syntax sol = solver(odefun,[t0 tf],y0...) returns a structure that you can use with the new function deval to evaluate the solution at any point on the interval
[t0,tf] .
New syntax e = polyeig(A0,A1,..,Ap) returns only the eigenvalues of the specified eigenvalue problem. Use
[ X,e] = polyeig(A0,A1,...Ap) if you also want the eigenvectors. This capability is available in MATLAB 6.0
(Release 12.0).
ppval qz reshape svd
New syntax ppval(xx,pp) transposes the input arguments to enable you to use ppval with function functions.
New syntax [AA,BB,Q,Z,V,W] = qz(A,B) returns W , the left generalized eigenvectors of A and B .
New syntax reshape(A,...,[],...) calculates the length of the dimension specified by the placeholder [] .
Can now return only the first two outputs, U and S , where
S is a diagonal matrix of the same dimension as the input argument X , and U is a unitary matrix.
2-7
2
MATLAB 6.1 Release Notes
Programming and Data Types Features
Partial Evaluation of Expressions
Within the context of an if or while expression, MATLAB does not necessarily evaluate all parts of a logical expression. In some cases, it is possible, and often advantageous, to determine whether an expression is true or false through only partial evaluation. This is sometimes referred to as short-circuiting.
For example, if A equals zero in statement 1 below, then the expression evaluates to false , regardless of the value of B . In this case, there is no need to evaluate B and MATLAB does not do so. In statement 2, if A is nonzero, then the expression is true , regardless of B . Again, MATLAB does not evaluate the latter part of the expression.
1) if (A & B) 2) if (A | B)
You can use this property to your advantage to cause MATLAB to evaluate a part of an expression only if a preceding part evaluates to the desired state.
Note Partial evaluation of expressions in if and while was also available in
MATLAB 6.0, but was not documented.
New MATLAB Search String Function
strfind is a new character array function in MATLAB. It searches for all occurrences of a string pattern within another, longer string. Placement of the two string arguments in the argument list requires that you be specific about which string is the character pattern to search for and which is the string in which to search. This allows you more control over how the search is performed compared with the MATLAB findstr function, particularly when executing searches within a loop.
2-8
New Features
New File I/O Functions for Scientific Data Formats
There are six new MATLAB 6.1 functions that enable you to retrieve information and data from Common Data Format (CDF), Flexible Image
Transport System (FITS), and Hierarchical Data Format (HDF) files.
Function cdfinfo cdfread fitsinfo fitsread hdfinfo hdfread
Purpose
Return information about a CDF file
Read data from a CDF file
Return information about a FITS file
Read data from a CDF file
Return information about an HDF or HDF-EOS file
Read data from an HDF or HDF-EOS file
New Audio Functions
MATLAB 6.1 includes two new audio functions for 32-bit Windows platforms only.
Function audioplayer audiorecorder
Purpose
Create an audio object to play audio data
Create an audio object to record audio data
Date Conversion Changes
The datenum and datestr functions can now accept a date vector, as defined by datevec , as an input argument. For example, datestr(clock) returns the current date and time as string such as 27-Apr-2001 15:58:41 .
2-9
2
MATLAB 6.1 Release Notes
Graphics Features
Transparent Legend
You can now make the legend box transparent, enabling you to see the plotted data behind the legend. See legend for more information.
New Ghostscript Drivers
The following new Ghostscript drivers are available with MATLAB by using the device switch shown below.
Printer Driver
Canon Color BubbleJet BJC-800
HP LaserJet 4.5L and 5P
HP LaserJet 5 and 6
Device Switch
-dbjc800
-dljet4
-dpxlmono
New Ghostscript Output Filters for Exporting
The following new Ghostscript output filters are available with MATLAB by using the option switch shown below.
File Format
BMP Monochrome BMP
PDF Color file Format
Option Switch
-dbmpmono
-dpdf
Higher Resolution Metafiles
You can now set the resolution of a Windows Enhanced Metafile copied from a
MATLAB figure window with the print -dmeta command. Set the resolution using the -d option of the print command. For example, to copy a figure to a metafile having a resolution of 200 dpi, use print -dmeta -r200
MATLAB uses the screen resolution as the default.
2-10
New Features
Default PaperType and PaperUnits Set For International Users
The matlabrc.m
startup file now sets the default PaperType and PaperUnits properties based on ISO Country Codes. These default to 'a4' and
'centimeters' respectively for users in countries that normally default to these settings. Other countries still default to 'usletter' and 'inches' .
The same values are used for default Simulink PaperType and PaperUnits properties in the matlabrc.m
startup file.
You can still set default PaperType or PaperUnits values yourself by adding the following to startup.m
.
set(0, 'DefaultFigurePaperType', 'a4') set(0, 'DefaultFigurePaperUnits', 'centimeters')
OpenGL Renderer Feature — Microsoft Windows
If you do not want to use hardware OpenGL, but do want to use object transparency, you can issue the following command.
feature('UseGenericOpenGL',1)
This command forces MATLAB to use generic OpenGL on Microsoft Windows platforms. Generic OpenGL is useful if your hardware version of OpenGL does not function correctly and you want to use image, patch, or surface transparency, which requires the OpenGL renderer.
To re-enable hardware OpenGL, use the command feature('UseGenericOpenGL',0)
Note that the default setting is to use hardware OpenGL
To query the current state of the generic OpenGL feature, use the command feature('UseGenericOpenGL')
See the opengl reference page for additional information.
2-11
2
MATLAB 6.1 Release Notes
External Interfaces/API Features
Concatenation of Java Arrays
In MATLAB 6.1, you can concatenate arrays of Java objects that have unlike dimensions. The following example concatenates a 2-by-3 array of java.lang.Integer
with a 4-by-3 array of the same class.
A = java.lang.Integer[][]:
[ 1] [ 2] [ 3]
[ 4] [ 5] [ 6]
[17] [18] [19]
[20] [21] [22]
B = java.lang.Integer[][]:
[11] [12] [13]
[14] [15] [16]
The vertical concatenation [A;B] is simple since both arrays have the same number of columns. The horizontal concatenation [A B] merges the two arrays into an irregularly shaped array having six columns in the first and second rows and three columns in the third and fourth rows.
C = [A;B] C = [A B]
C = C = java.lang.Integer[][]: java.lang.Integer[][]:
[ 1] [ 2] [ 3] [6 element array]
[ 4] [ 5] [ 6] [6 element array]
[11] [12] [13] [3 element array]
[14] [15] [16] [3 element array]
[17] [18] [19]
[20] [21] [22]
Note “Concatenation of Java Objects” on page 2-30 discusses changes to how
Java objects are concatenated.
2-12
New Features
New Fortran MX, MEX, MAT, and ENG Functions
The following functions have been added to the Fortran MX, MEX, MAT, and
Engine external interface. Most of these functions already exist in the
MATLAB C language API.
Table 2-1: New Fortran MX Functions mxAddField mxClassIDFromClassName mxCopyComplex8ToPtr mxCopyInteger2ToPtr mxCopyPtrToInteger1 mxCopyPtrToReal4 mxCreateCellArray mxCreateCharArray mxCreateDoubleMatrix mxCreateNumericMatrix mxCreateStructArray mxDestroyArray mxGetCell mxGetClassName mxGetDimensions mxGetEps mxGetFieldByNumber mxGetFieldNumber mxGetInf mxGetNumberOfDimensions mxGetNumberOfFields mxCalcSingleSubscript mxClearLogical mxCopyInteger1ToPtr mxCopyPtrToComplex8 mxCopyPtrToInteger2 mxCopyReal4ToPtr mxCreateCellMatrix mxCreateCharMatrixFromStrings mxCreateNumericArray mxCreateScalarDouble mxCreateStructMatrix mxDuplicateArray mxGetClassID mxGetData mxGetElementSize mxGetField mxGetFieldNameByNumber mxGetImagData mxGetNaN mxGetNumberOfElements mxIsCell
2-13
2
MATLAB 6.1 Release Notes
Table 2-1: New Fortran MX Functions (Continued) mxIsChar mxIsEmpty mxIsFromGlobalWS mxIsInt8 mxIsInt32 mxIsNaN mxIsStruct mxIsUint16 mxMalloc mxRemoveField mxSetData mxSetField mxSetImagData mxIsClass mxIsFinite mxIsInf mxIsInt16 mxIsLogical mxIsSingle mxIsUint8 mxIsUint32 mxRealloc mxSetCell mxSetDimensions mxSetFieldByNumber mxSetLogical
Table 2-2: New Fortran MEX Functions mexFunctionName mexGetArray mexGetArrayPtr mexIsGlobal mexIsLocked mexMakeArrayPersistant mexPutArray mexWarnMsgTxt mexLock mexMakeMemoryPersistant mexUnlock
Table 2-3: New Fortran MAT Functions matDeleteArray matGetArray matGetArrayHeader matGetNextArray
2-14
New Features
Table 2-3: New Fortran MAT Functions (Continued) matGetNextArrayHeader matPutArray matPutArrayAsGlobal
Table 2-4: New Fortran Engine Functions engGetArray engPutArray
Property Added to ActiveX and Engine Interfaces
For ActiveX automation server applications and MATLAB Engine applications running on Windows, you can control whether the application windows appear on the Windows desktop with a new property called Visible .
When Visible is set, the ActiveX application or engine server window is visible on the desktop, thus enabling user interaction with the server. This is the default. When Visible is cleared, the application or engine window is removed from the desktop.
ActiveX.
This example disables the visibility of an ActiveX automation server application by setting h.visible
to 0 . It checks the visibility setting in line 3 by examining h.visible
.
h = actxserver('Matlab.Application'); h.visible = 0; h.visible
ans =
0
MATLAB Engine.
For a MATLAB engine session, use the engSetVisible and engGetVisible functions that are new in MATLAB 6.1. Line 4, below, disables the visibility of the MATLAB engine window using engSetVisible with an argument of 0 . Line 5 checks this setting with engGetVisible .
Engine *ep; bool vis; ep = engOpen(NULL); engSetVisible(ep, 0); engGetVisible(ep, &vis);
2-15
2
MATLAB 6.1 Release Notes
Serial I/O
MATLAB’s serial port interface provides direct access to peripheral devices such as modems, printers, and scientific instruments that you connect to your computer’s serial port. This interface is established through a serial port object, which you create with the serial function.
Freeing the Serial Port on Windows Platforms.
The serial port object uses the javax.comm
package to communicate with the serial port. However, due to a memory leak in javax.comm
, the serial port object is not released from memory.
You can use the freeserial function to release the MATLAB hold on the serial port.
freeserial is necessary only on Windows platforms. You should use freeserial only if you need to connect to the serial port from another application after a serial port object has been connected to that port, and you do not want to exit MATLAB.
Events, Callbacks, and Function Handles.
Action properties and action functions are now referred to as callback properties and callback functions. This new terminology is reflected in new names for the associated properties and functions. The general rule for the name changes is to change “Action” to “Fcn” for properties, and “action” to “callback” for functions. For example,
TimerAction has been renamed TimerFcn , and instraction has been renamed instrcallback .
Additionally, if you want to automatically pass the object and event information to the callback function, then you must specify the function as either a function handle or as a cell array. Note that you can also specify the callback function as a string. In this case, the callback is evaluated in the
MATLAB workspace and no requirements are made on the function’s input arguments.
Enhancements to Existing Properties.
•
Terminator Property – You can configure Terminator to a decimal value ranging from 0 to 127, to the equivalent ASCII character, to CR/LF or LF/CR , or to empty ('').
• Timer events – Some timer events may not be processed if your system is significantly slowed or if the TimerPeriod value is too small. The minimum
TimerPeriod value is now 0.01 second.
2-16
New Features
Creating Graphical User Interfaces — GUIDE
This section lists the changes made to GUIDE for Release 12.1:
• The Layout Editor Edit menu has Undo and Redo items. You can undo or redo layout actions and property settings (with the exception of the figure
FileName property).
• The Application Option dialog supports a new option for Command-line accessibility – Callback. This option is now the default.
• The Layout Editor displays the layout grid in the current figure color.
• The Layout Editor context menus have been reorganized.
• The Menu Editor enables you to rearrange the order of menu items.
• The Menu Editor adds callback function stubs to the application M-file.
See Creating Graphical User Interfaces in the MATLAB documentation for more information.
2-17
2
MATLAB 6.1 Release Notes
2-18
Major Bug Fixes
MATLAB 6.1 includes several bug fixes made since MATLAB 6.0. This section describes the particularly important bug fixes.
Also, MATLAB 6.1 includes several important MATLAB 6.0 bug fixes.
Development Environment
Help Browser Supports Mouse Wheel
For Windows platforms, the wheel on your mouse will now work in the Help browser.
UNIX Help Browser Search Results Now Highlighted
On UNIX systems, when you perform a full text search using the Help browser, the search terms are highlighted when you view a page.
UNIX Paste Problems Fixed
On some UNIX systems, pasting after a cut or copy would sometimes cause the system to hang. That problem has been fixed. However, due to issues with
UNIX itself, the paste does not always work and you might have to do it again.
Mathematics
Memory Leak Fixed in Matrix Multiply
Under certain conditions, matrix multiply (which includes matrix-vector multiply, vector-matrix multiply, and even vector inner products) leaked memory. For example, on a Pentium III under Linux or Windows, any vector inner product of length greater than 15,000 leaked memory. This was observed by MATLAB increasing its use of system resources that were never returned.
MATLAB 6.1 uses new ATLAS BLAS libraries that no longer leak memory.
Improved Convergence for eigs(A,k,
'
sm
'
) and eigs(A,k,0)
In MATLAB 6.0, eigs was reimplemented to use the ARPACK library of routines. Unfortunately, the smallest magnitude case, sigma = 'sm' and sigma = 0 , chose the wrong algorithm. For MATLAB 6.1, the correct ARPACK algorithm is used and convergence is much quicker.
Major Bug Fixes
This bug fix introduces a backwards incompatibility. When A is a function Afun and sigma = 'sm' , Afun must now return Y = A\x . Prior to MATLAB 6.1, eigs required Afun to return y = A*x for this case.
quad Sampling Improved
In MATLAB 6.0, quad('cos(4*n*x)',-pi,pi) returned 2*pi instead of 0 .
When quad initially sampled the function, it incorrectly assumed the function is the constant 1 over the interval [-pi,pi] and so returned 2*pi early. It now samples more carefully and returns 0 .
griddata3 Inner Matrix Error Message
In MATLAB 6.0, an internal error sometimes caused griddata3 to display the error message, Inner matrix dimensions must agree . This error has been corrected.
Improved Handling of Degenerate Triangulation
In MATLAB 6.0, there were sometimes problems associated with degenerate triangulation. For example, convhull could produce a convex hull that did not cover all the original data. MATLAB 6.1 corrects this problem by replacing the utility function delaunayc with Qhull.
Error Message Display for Qhull-Related Functions
In MATLAB 6.0, Qhull-related functions (e.g., delaunayn ) displayed error messages in standard error. For UNIX platforms, standard error is different from the command window. For MATLAB 6.1, error messages are displayed in the command window.
histc Computes First Two Bins Correctly
Prior to MATLAB 6.0, histc produced the wrong results for the first two bins for cases with extremely nonuniform bin edges. This problem was corrected in
MATLAB 6.0.
2-19
2
MATLAB 6.1 Release Notes
Platform Limitations
Note The Release 12.0 platform limitations for MATLAB for the HP and IBM platforms still apply to Release 12.1, with the exception of the specific differences highlighted below.
The MATLAB functionality described in these Release Notes and in the
MATLAB documentation applies to MATLAB 6.0 with the exception of the limitations listed below for the HP and IBM platform. For background
information, see “Platform Limitations” on page 1-17:
• “Patch Required for HP-UX 11.0” on page 2-20
• “Mathematics Limitations” on page 2-20
• “Graphics and Printing Limitations” on page 2-21
• “GUIDE Limitations” on page 2-21
Another platform limitation involves the use BLAS on certain processors. See
“You May Need to Overwrite the MATLAB Default Choice of BLAS” on page 2-22 for details.
Patch Required for HP-UX 11.0
To run MATLAB on HP-UX 11.0, you must install a patch available from
Hewlett-Packard. To get the patch, go to www.itrc.hp.com
, the IT Resource
Center page. The patch is available to registered customers from the individual patches link. The patch name is below.
PHSS_21959 1.0 X/Motif 32 bit
Runtime 2000 Periodic Patch.
Mathematics Limitations
The Basic Fitting interface is not supported. Instead, use curve fitting functions such as polyfit and spline . See also “Data Analysis and Statistics” in the MATLAB documentation for more information.
2-20
Platform Limitations
Graphics and Printing Limitations
Feature
Data
Statistics
Printing
Limitation and Alternatives
Not supported.
Property
Editor
Uses the Release 11 Page Setup, Print Setup, and Print dialog boxes. For information about these interfaces, see
“Printing MATLAB Graphics” in the online MATLAB documentation.
Not supported. Similar graphical user interfaces provide access to figure, line and text objects. Use the set and get functions to modify Handle Graphics object properties.
GUIDE Limitations
The Application Options dialog configures the M-file generated by GUIDE. If you comment out lines of code in this M-file, the Application Options dialog may not be able to represent the state of the generated code correctly. In addition, the M-file may not function correctly.
If you want to remove code that has been added due to the settings of the
Application Options dialog, you should make changes to the dialog. GUIDE updates the M-file the next time you save your layout.
If you want to prevent certain lines of generated code from executing, you should remove these lines from the M-file instead of making these lines into comments.
Note that these limitations apply only to code generated by GUIDE, not user-written code.
2-21
2
MATLAB 6.1 Release Notes
You May Need to Overwrite the MATLAB Default
Choice of BLAS
On the PC, under both Linux and Windows operating systems, MATLAB determines at startup time what processor your computer has, for example
Genuine Intel Pentium II, Pentium III, or AMD Athlon. MATLAB then automatically selects the most appropriate BLAS for your processor. The same is true on the SUN, where MATLAB distinguishes between UltraSPARCs and non-Ultra machines.
However, on the remaining platforms you get the default BLAS, which is usually targeted for a reasonably modern or common processor. Namely:
• ALPHA 21264
• HP700 PA-RISC1.1
• HPUX PA-RISC2.0
• IBM_RS Power3
• SGI R12000
If you have reason to believe that your processor is closer to another of the flavors of BLAS distributed with MATLAB, for example 21164 on the ALPHA or PA-RISC2.0 on the HP700, you might want to override the default choice of
BLAS. Look in your <MATLAB>/bin/$ARCH directory for libraries beginning with atlas_ to see your options.
Overriding the Default
The way to override the default choice is to set the environment variable
BLAS_VERSION before invoking MATLAB. For example (in csh ) setenv BLAS_VERSION atlas_21164.so
setenv LAPACK_VERBOSITY 1 matlab
The environment variable LAPACK_VERBOSITY simply confirms that your choice of BLAS is being loaded once you start up MATLAB.
Restoring the Default
If you would like to return to using the default provided by MATLAB, you may use the command (in csh ) unsetenv BLAS_VERSION
2-22
Platform Limitations
Determining Your Processor
This section indicates how you can determine what type of processor your computer has.
ALPHA.
Enter the command
/usr/sbin/psrinfo -v which returns something like
Status of processor 0 as of:05/03/01 17:16:55
Processor has been on-line since 04/20/2001 14:09:31
The alpha EV4.5 (21064) processor operates at 233 MHz,
and has an alpha internal floating point processor.
The number in parentheses on the third line, in above example (21064), is the number you are interested in.
GLNX86.
Enter the following command cat /proc/cpuinfo and look for the following fields in the output (values may vary from the example below) vendor_id :GenuineIntel cpu family :6 model :8 model name :Pentium III (Coppermine) stepping :1
Match up this information with the table in <MATLAB>\bin\glnx86\blas.spec
.
Note Some versions of glibc 2.1.x have problems with environment variables
(and the ability to reliably query them) from within shared library init functions. To take advantage of the BLAS_VERSION feature, you may need to upgrade your machine to glibc 2.2.
2-23
2
MATLAB 6.1 Release Notes
HP700.
Start with the System Administration Manager (SAM) and work your way to the Processor tab, as shown below:
System Administrator Manager (SAM) -> Performance monitors ->
System properties -> Processor tab
This provides information about the type of processor.
HPUX.
MATLAB only supports HPUX running on PA-RISC2.0.
IBM_RS.
Contact IBM Technical Support and request the document entitled
“Determining CPU Speed in AIX.” This is a table of machine types, processor types, and processor speeds.
SGI.
Enter the following command sysinfo -a which returns a lot of information. In the first few lines, look for information something like
CPU Type is mips R4400 5.0
The information starting with R is what you are interested in. MATLAB ships for the R5000 , R8000 , R10000 and R12000 (default).
SOL2.
Enter the following command uname -m which returns either sun4u for UltraSPARC or sun4m for the older, non-Ultra machines (e.g., Hyper and SuperSPARCs).
WIN32.
Start with the My Computer icon, and work your way to the General tab, as shown below:
My Computer -> Control Panel -> System -> General tab
This should list the family and model number for your computer. On Windows
NT and Windows 2000, the same information is on the Environment tab, under the System Variable PROCESSOR_IDENTIFIER . Match up this information with the table in <MATLAB>\bin\win32\blas.spec
.
2-24
Platform Limitations
Using Another BLAS
You may also use BLAS from other sources than the ones shipped with
MATLAB, provided they are in the correct format. This format is a shared library (as opposed to a static library) that exports all the double-precision
(starting with d) and double-precision complex (starting with z) BLAS routines from dasum to zupmtr . On HP, IBM_RS, and WIN32, the symbols must be exported without trailing underscores, while for ALPHA, GLNX86, SGI, and
SOL2, the symbols must be exported with trailing underscores (e.g., dgemm_ ).
If the shared library you provide also includes LAPACK symbols like dgefa (or dgefa_ ), then they will override the MATLAB default implementation, which is based on the Fortran LAPACK from Netlib at http://netlib.org
.
2-25
2
MATLAB 6.1 Release Notes
Upgrading from an Earlier Release
This section describes the upgrade issues involved in moving from MATLAB
6.0 (Release 12.0) to MATLAB 6.1 (Release 12.1).
For information about upgrading from an earlier version than MATLAB 6.0, see the Release Notes for Release 12.
This section about upgrading from an earlier release is organized into the following subsections:
• “Development Environment Issues” on page 2-26
• “Mathematics Issues” on page 2-27
• “Programming and Data Types Issues” on page 2-28
• “Graphics Issue” on page 2-29
• “External Interfaces/API Issues” on page 2-30
Development Environment Issues subscribe Function No Longer Supported
The subscribe function is no longer supported.
Command History, Preferences, and Favorites
If you uninstall Release 12.0, you will lose the Command History, preferences, and Help browser favorites from Release 12.0. For instructions to maintain
these files when uninstalling Release 12.0, see “Maintaining Preference Files
After Uninstalling” in Chapter 1 of the Release Notes.
Help Browser Favorites
If you use favorites you created for the documentation in the Release 12.0 Help browser, those favorites may point to an incorrect or invalid location in Release
12.1. You will need to delete any invalid favorites and add those favorites again.
2-26
Upgrading from an Earlier Release
Source Control
If you use Microsoft Visual SourceSafe with MATLAB’s source control features, you now need to specify the login information for SourceSafe using preferences.
Select File -> Preferences -> General -> Source Control from the desktop.
Specify the Username, Password, and Database.
Mathematics Issues
Finding Smallest Magnitude Eigenvalues
eigs(A,k,sigma) and eigs(A,B,k,sigma) return k eigenvalues based on sigma . For sigma = 'sm' , eigs returns the smallest magnitude eigenvalues.
In MATLAB 6.0, eigs was reimplemented to use the ARPACK library of routines. Unfortunately, the smallest magnitude case, sigma = 'sm' and sigma = 0 , chose the wrong algorithm. For MATLAB 6.1, the correct ARPACK algorithm is used and convergence is much quicker.
This bug fix introduces a backwards incompatibility. When A is a function Afun and sigma = 'sm' , Afun must now return Y = A\x . Prior to MATLAB 6.1, eigs required Afun to return y = A*x for this case.
Possible Changes in Results Returned by Matrix Functions
Starting in MATLAB 6.0 (R12.0), matrix computations are based on LAPACK, a large, multiauthor Fortran subroutine library for numerical linear algebra.
While this change has many benefits (see the Release Notes for Release 12) and matrix functions continue to operate in the same way in MATLAB 6.0, the results returned by matrix functions may differ. Changes in roundoff errors can be seen in most matrix computations. In cases where quantities are not uniquely determined mathematically, results may differ in order and in normalization.
For example:
• Eigenvalues may be returned in a different order.
• Eigenvectors may be normalized differently.
• The signs of columns of orthogonal matrices may differ.
• rcond is a better estimate of the reciprocal condition.
• lu can now be used to factor rectangular full matrices.
2-27
2
MATLAB 6.1 Release Notes
Obsolete Input Arguments
Certain input arguments to these functions have become obsolete. Using these arguments does not result in an error, but they are ignored.
Function delaunay convhull
Description
Now ignores the third argument fuzz , which specified a value for the fuzz standard deviation.
Now ignores the third argument 'sorted' . This argument indicated to delaunay that the given points x and y were sorted, and that duplicate points had been eliminated.
Now ignores the third argument TRI , which provided triangulation data previously computed using delaunay .
Obsolete Functions
The following MATLAB function has become obsolete. For backwards compatibility, it has not been removed from the language at this time.
However, this function may be removed in a future release, and you are encouraged to discontinue its use, or use the function that replaces it.
Function bvpval
Description
Evaluate the numerical solution of a boundary value problem (BVP). Replace with deval , which evaluates the solution of both initial value and boundary value differential equation problems.
Programming and Data Types Issues
Output from Background and Foreground Commands (UNIX)
In Release 12 on UNIX platforms, a background command (i.e., any system command after which you add a & ), such as
! cat startup.m &
2-28
Upgrading from an Earlier Release no longer produces any output. Prior to Release 12, a background command sent output to the command window.
If you need to see the output from a command, either do not make the command a background command (i.e., remove the & ), or run the background command in a separate xterm. To start another xterm, issue the following command.
! xterm &
In Release 12, foreground functions (i.e., nonbackground functions) send their output to the diary, if the diary function has been issued. The output is also displayed in the command window (prior to Release 12, foreground function output was only displayed in the command window).
matlab_helper Process
To make the !
and unix commands operate more efficiently, in Release 12
MATLAB creates a secondary process, called matlab_helper , at startup.
This matlab_helper contains those elements of MATLAB necessary to run the
!
and unix commands.
Graphics Issue
MATLAB No Longer Supports Terminal Mode
MATLAB no longer runs on nongraphics computer terminals.
2-29
2
MATLAB 6.1 Release Notes
External Interfaces/API Issues
Concatenation of Java Objects
When you concatenate Java objects, the class of the resultant object depends on the classes of the input objects, as follows:
• If the input objects are of the same class, MATLAB makes the output object of that class. This was true in Version 6.0 as well.
• If the input objects are of different classes, but all inherit from a common class, MATLAB makes the output object of the common parent class.
MATLAB selects the lowest common parent in the Java class hierarchy as the output class. This is new behavior for Version 6.1.
For example, concatenating objects of classes java.lang.Integer
and java.lang.Double
creates a new object of class java.lang.Number
.
• If the input objects are of different and unrelated classes, then MATLAB makes the output object of the java.lang.Object
class. This was true in
Version 6.0 as well.
Obsolete Fortran MX, MEX, MAT, and ENG Functions
The following Fortran MX, MEX, MAT, and ENG functions are considered to be obsolete as of Version 6.1. Support for these functions may be removed from a future MATLAB release.
Table 2-5: Obsolete Fortran MX Functions mxCreateFull mxFreeMatrix mxIsFull mxIsString
Table 2-6: Obsolete Fortran MEX Functions mexGetEps mexGetGlobal mexGetFull mexGetMatrix mexGetNaN mexGetInf mexGetMatrixPtr mexIsFinite
2-30
Upgrading from an Earlier Release
Table 2-6: Obsolete Fortran MEX Functions (Continued) mexIsInf mexIsNaN mexPutFull mexPutMatrix
Table 2-7: Obsolete Fortran MAT Functions matDeleteMatrix matGetFull matGetMatrix matGetString matPutMatrix matGetNextMatrix matPutFull matPutString
Table 2-8: Obsolete Fortran Engine Functions engGetFull engGetMatrix engPutFull engPutMatrix
2-31
2
MATLAB 6.1 Release Notes
2-32
Known Software and Documentation Problems
This section updates the MATLAB 6.1 documentation set, reflecting known
MATLAB 6.1 software and documentation problems. It is organized into the following subsections:
• “Development Environment Problems” on page 2-32
• “Documentation Updates” on page 2-33
Development Environment Problems
Displaying Results From lookfor Function
When you run the lookfor function, press Ctrl+C to display the results in the command window.
Many Open Windows Can Cause a Crash or Hang (Windows 95/98/Me)
On Microsoft Windows 95/98/Me platforms, if you keep many windows open,
MATLAB may crash or hang. For example, if you keep open 12 Stateflow windows, or 25 figure windows, or 50 Simulink windows, you may experience this problem. Note that these numbers are only estimates; the actual number of open windows that may cause this problem depends on the resources currently in use by other components and applications.
Cannot Go To Top Level of UNC Path
For Windows platforms, you cannot use cd or any directory tool in the
MATLAB desktop (including the Current Directory browser and Set Path dialog box) to access the top level of a UNC path.
Workspace Browser with Many Variables
If there are many variables in the workspace and the Workspace browser is open, you may experience performance problems. If you expect to have more than 1000 variables in the workspace, close the Workspace browser to avoid performance problems.
UNIX Display Problems When UNIX Client and Server Platforms Differ
If you use MATLAB on UNIX and the platform for the server is different than that for the client, there may be problems with the display of graphics on the
Known Software and Documentation Problems client. See the Technical Support Web page for a solution that lists the combinations tested and any known display problems with them.
Sun Solaris 16-Bit Display Not Supported
Sun's Java VM for Solaris does not support 16-bit displays. Therefore you cannot use this configuration with Release 12. Use another display mode instead.
Sun Solaris Arrow Keys Not Working
On some Sun Solaris systems, the arrow keys on the main keyboard are not working properly. Instead, try the arrow keys in the numeric keypad.
Alpha Shortcut Problems When Using Emacs Key Bindings in Editor
On the Alpha platform, if you set the Editor/Debugger preference for key bindings to Emacs, the shortcuts for Undo (Ctrl+_) and Copy (~+W) do not work.
Display Problems with Xoftware
If you use Xoftware on a PC to run MATLAB on a UNIX platform, you need to do the following to avoid display problems:
1 Go to the Xoftware Control Panel.
2 From the Options menu, select Configuration.
3 Select the Window tab.
4 From the Options listing, select Concurrent Window Manager.
5 Under Settings, select Off.
6 Click OK.
Documentation Updates
Editor/Debugger Example - Graphic and Information Incorrect
In the printed book Using MATLAB (Version 6), on page 7-19, the graph shown is incorrect. For the correct graph, see the same page in the Help browser at
2-33
2
MATLAB 6.1 Release Notes
MATLAB -> Using MATLAB -> Development Environment -> Editing and
Debugging M-Files -> Debugging M-Files -> Trial Run for Example .
On page 7-29, in “Correcting Problems and Ending Debugging, Completing the
Example,” step 3 is incorrect. It should instead read “In collatzplot.m
line 12, change the string plot_seq to seq_length(m) and save the file.”
interp1 Extrapolation of Out-of-Range Values
A new argument enables interp1 to perform extrapolation for out-of-range values for all methods. It also enables you to specify a scalar to be returned for out-of-range values.
The PDF version of the interp1 reference page incorrectly states that the default for all methods is for interp1 to perform extrapolation for out-of-range values. In fact, interp1 performs extrapolation as the default only for the
'spline' , 'pchip' , and 'cubic' methods. For all other methods, it returns NaN for out-of-range values. This behavior is unchanged from Version 5.
The HTML reference page for interp1 is correct.
2-34
Simulink 4.1 Release
Notes
New Features . . . . . . . . . . . . . . . . . . . 3-2
Simulink Editor . . . . . . . . . . . . . . . . . . . 3-2
Modeling Enhancements . . . . . . . . . . . . . . . 3-4
Simulink Debugger . . . . . . . . . . . . . . . . . . 3-7
Block Library . . . . . . . . . . . . . . . . . . . . 3-8
Bug Fixes . . . . . . . . . . . . . . . . . . . . . 3-10
Platform Limitations for HP and IBM . . . . . . . . 3-12
Upgrading from an Earlier Release . . . . . . . . . 3-13
Running Simulink 4.1 Models in Simulink 4.0 . . . . . . . 3-13
Simulink Block Library Reorganization . . . . . . . . . 3-13
Direct Feedthrough Compensation Deprecated . . . . . . 3-13
S-Functions Sorted Like Built-In Blocks . . . . . . . . . 3-14
Added Latched Triggered Subsystems . . . . . . . . . . 3-14
Self-Triggering Subsystems Are No Longer Allowed . . . . 3-14
Improved Invalid Model Configuration Diagnostics . . . . . 3-15
Known Software Problems . . . . . . . . . . . . . 3-16
Accelerator Mode Does Not Support Inline Parameters . . . 3-16
Turn the New Wrap Lines Option Off . . . . . . . . . . 3-16
3
3
Simulink 4.1 Release Notes
New Features
This section introduces the new features and enhancements added in Simulink
4.1 since Simulink 4.0 (Release 12.0).
For information about Simulink features that are incorporated from recent releases, see the Release Notes for Release 12.
Note For information about closely related products that extend Simulink, see the sections on the Simulink Performance Tools and the Real-Time
Workshop, as well as information about the blocksets from The MathWorks.
This section about new Simulink features is organized into the following subsections:
• “Simulink Editor” on page 3-2
• “Modeling Enhancements” on page 3-4
• “Simulink Debugger” on page 3-7
Simulink Editor
This section describes enhancements to the Simulink Editor.
Undo Move
In Simulink 4.1, the Undo command on the Simulink Edit menu restores blocks, annotations, lines, and nodes that have moved to their original locations (see “Undoing a Command” in Using Simulink).
Undo Subsystem Creation
In Simulink 4.1, the Undo command on the Simulink Edit menu restores blocks that have been grouped into a subsystem to their original level in the model (see “Undoing Subsystem Creation” in Using Simulink).
3-2
New Features
Autoconnecting Blocks
This version makes connecting blocks significantly easier. To connect a set of source blocks to a target block, simply select the source blocks, hold down the
Ctrl key and left--click the target block. Simulink draws connecting lines between the source blocks and the destination block, neatly routing lines around intervening blocks. To connect a source block to a set of target blocks, select the target blocks, hold down the Ctrl key and left--click the source block.
To connect two blocks, select the source block, and left-click the destination block while holding down the Ctrl key. Simulink connects as many ports on the two blocks as possible (see “Autoconnecting Blocks” in Using Simulink).
Autorouting Signal Lines
Simulink now routes signal lines around intervening blocks when you connect them either interactively (by dragging the connecting lines or using autoconnect) or programmatically via the add_line command’s new
'autorouting'
option (see “Autorouting Option Added to add_line Command” on page 3-4).
Displaying Storage Class on Lines
This version adds an item to the Format menu, which toggles the display of
(nonAuto) storage class on signal lines (see “RTW Storage Class” in Using
Simulink for more information).
Save Models in Release 11 Format
This release can save post-Release 11 models in Release 11 format. Simulink 3
(Release 11) can load and run converted models that do not use any post-Release 11 features of Simulink. Simulink 3 can load converted models that use post-Release 11 features but may not be able to simulate the model correctly. Use the Save as option from the Simulink File menu or the following command to save a model in Release 11 format. slsaveas(SYS)
See “Saving a Model in Simulink 3 (R11) format” in Using Simulink for more information.
3-3
3
Simulink 4.1 Release Notes
Modeling Enhancements
This section describes enhancements to Simulink’s dynamic system modeling tools.
Autorouting Option Added to add_line Command
The add_line command now optionally routes lines around intervening blocks and annotations. For example, the following command autoroutes a connection between two blocks in the vdp model.
add_line('vdp','Product/1','Mu/1','autorouting','on')
The autorouting option is off by default. See add_line in Using Simulink for more information.
S-Function Builder
The S-Function Builder generates an S-function from specifications that you enter in a dialog box. It provides an easy way for you to incorporate existing code into a Simulink model.
add_param, delete_param
With this version, you can add custom parameters to your block diagrams.
add_param('modelname','MyParameterName','value')
delete_param('modelname','MyParameterName')
You can also use the model handle in place of the model name. See add_param and delete_param in Using Simulink for more information.
Connection Callbacks
With this version, you can use set_param to set callbacks on ports that are triggered by changes in the ports’ connectivity. The callback function parameter is named ConnectionCallback . When the port’s connectivity changes (addition/deletion of line connected to the port, connection of new block to the port, etc.), Simulink invokes the callback function with the port handle as its argument. See “Port Callback Parameters” in Using Simulink for more information.
3-4
New Features
Saving Block User Data in Model Files
This version adds a new block parameter, named UserDataPersistent , that is off by default. Setting this parameter on , e.g., set_param(block-name,'UserDataPersistent','on') causes Simulink to include a block’s user data (i.e., the value of the block’s
UserData parameter) in the model file when you save a model. Simulink encodes the user data as ASCII characters and saves the encoded data in a new section of the model file called MatData . This mechanism works with all forms of MATLAB data, including arrays, structures, objects, and Simulink data objects. See “Associating User Data with Blocks” in Using Simulink for more information.
Absolute Tolerance Enhancements
This version adds a dialog item for setting the absolute tolerance for each state in the State-Space block, the Transfer Fcn block, and the Zero-Pole block. With this enhancement, you can now specify the absolute tolerance for solving every continuous state in your model.
Block Reduction Enhancements
S-functions may now request that they be eliminated from the compiled model.
To do this, call ssSetBlockReduction(true) inside the S-function. This is an advanced feature provided for customers writing S-functions who want to optimize the generated code produced for their S-function. Graphical connectivity is now remapped during block reduction, eliminating a source of error during reduction (e.g., a memory reference error used to occur if Simulink eliminated a block connected to a scope). Block reduction is now on by default, and a Simulink preference has been added for the option.
Boolean Logic Signals Preference
The Simulink Preferences dialog box now allows you to specify the use of
Boolean logic signals by default. See “Setting Simulink Preferences” in Using
Simulink for more information.
Subsystem Semantics Demos
Typing sl_subsys_semantics at the MATLAB prompt now displays a set of models that illustrate the semantics of various types of subsystem blocks. The demos include formal definitions of function-call subsystems.
3-5
3
Simulink 4.1 Release Notes
Enhanced Engine Model Demos
The top and bottom dead center detection in the engine and enginewc demo models now use a reset integrator. In previous versions, the models used a triggered subsystem to detect angular position. This method resulted in inefficiencies and a slower, less accurate solution. In addition, self-triggering subsystems are now illegal in Simulink.
Setting Block Sorting Priority on Virtual Subsystems
In Simulink 4.0, it was an error to specify a priority on a virtual subsystem. In
Simulink 4.1, you can specify priorities on virtual subsystems.
Using ~ in Filenames on UNIX
Now all filename fields in Simulink support the mapping of the ~ character in filenames. For example, in a To File block, you can specify ~/outdir/file.mat
.
On most systems, this will expand to /home/$USER/outdir/file.mat
.
Improved Warning About Slow Signals Feeding the Enable Port of an
Enabled Subsystem Containing Fast Blocks
In a multitasking environment, deterministic results cannot be guaranteed if a slow signal feeds the enable port of an enabled subsystem that contains fast blocks. In previous versions, Simulink did not issue a warning in some cases where this may occur.
Flagging Function-Call Subsystem Cycles
In previous versions, Simulink allowed you to build models containing function-call-cycles, i.e., function-call subsystems that directly or indirectly call themselves.
3-6
New Features
Such models cannot be correctly simulated. Accordingly, Simulink now displays an error message when you attempt to run or update a diagram containing function-call cycles.
Simulink Debugger
This section describes enhancements to the Simulink debugger.
Enhancement to Sorted List Display
The Simulink debugger ( sldebug ) sorted list command, slist , now displays the names of the S-functions residing inside S-function blocks.
Improved Messages in Accelerated Mode
The trace , break , zcbreak , nanbreak , and minor commands now indicate that they are disabled when in accelerator mode and you need to switch to normal mode to activate them. The spacing of several messages has been fixed so the text aligns correctly.
Breakpoints on a Function-Call Subsystem
You can now put a break point on a function-call subsystem. Simulink breaks when the subsystem is executed. In Release 12, entering the quit command while at a breakpoint within a function-call subsystem wouldn't always quit the debugger. Now the quit command ends the debugging session once the initiating (calling) Stateflow chart or S-function finishes executing its time step.
Displaying and Probing Virtual Blocks
The display and probe commands now work for virtual blocks.
Stepping Stateflow Charts
You can now step execution of a model into a Stateflow chart.
3-7
3
Simulink 4.1 Release Notes
Block Library
This section describes enhancements to the Simulink block libraries.
Unified Pulse Generator
This version merges the Discrete Pulse Generator block into the Pulse
Generator block. The combined block has two modes: time-based and sample-based (discrete). Time-based mode varies the step size when a variable step solver is being used to ensure that simulation steps occur at pulse on/off transitions. When a fixed step solver is used, the time-based mode computes a fixed step size that ensures that a simulation step occurs at every pulse transition. The Pulse Generator block also outputs a pulse of any real data type in sample-based as well as time-based mode.
Control Flow Blocks
Simulink 4.1 adds an If block and Switch Case block that can drive conditionally executed subsystems that contain instances of the new Action
Port block. Action subsystems are similar to enabled subsystems, except that all blocks must run at the same rate as the If or Switch Case block.
This version also adds a For Iterator block and a While Iterator block. When placed in a subsystem, these blocks cause all of the blocks in the system to run multiple cycles during a time step. The block cycle in a For Iterator subsystem runs a specified number of times. The block cycle in a While Iterator subsystem runs until a specified condition is false. A user can limit execution of a While
Iterator subsystem to a specified number of iterations to avoid infinite loops.
The new Assignment block allows a model to assign values to specified elements of a signal.
Bus Creator
Simulink 4.1 adds a Bus Creator block that combines the output of multiple blocks into a single signal bus. A model can use the existing Signal Selector block to extract signals from the bus. The block’s dialog box allows you to assign names to signals on the bus or allow the signals to inherit their names from their sources. When you double-click on a signal name in the block dialog, the source block is highlighted. There is no execution overhead in the use of bus creator/bus selector blocks.
3-8
New Features
Sine Wave Block Enhancements
The Sine Wave block now supports a bias factor that eliminates the need to sum with a Constant block. The Sine Wave block also has a new computational mode. This mode (called sample-based) eliminates the dependence on absolute time.
Enhanced Flip-Flop Blocks
Simulink Extras ( simulink_extras.mdl
) contains a set flip-flop blocks. These blocks now use the new triggered subsystem latching semantics. In addition, the S-R Flip-Flop block now models a physical NOR gate (i.e., S=1 , R=1 => Q=0 ,
Q!=0 , the undefined state).
Additional Data Type Support
The Discrete-Time Integrator and Rounding Function blocks now handle single as well as double values. The Transport Delay, Unit Delay, Variable
Transport Delay, Memory, Merge, and Outport blocks can specify nonzero initial conditions when operating on fixed-point signals.
Simulink Block Library Reorganization
The Simulink Block Library contains a new Subsystems sublibrary. The new library contains most of the new control flow blocks as well as subsystem and subsystem-related blocks that used to reside in the Signals & Systems library.
The subsystems in the new library each contain the minimum set of blocks needed to create a functioning subsystem, e.g., an input port and an output port.
Scope Enhancements
The Scope block includes the following enhancements:
• A floating version of the Scope added to the Sinks block library
• Floating Scope saves the signals selected for display in the model file
• The Scope’s toolbar buttons for toggling between floating/nonfloating mode, restoring saved axes, locking/unlocking axes, and displaying the Signal
Selector
3-9
3
Simulink 4.1 Release Notes
Bug Fixes
This section lists fixes to bugs that occurred in the previous version of
Simulink.
• Variable sample time S-functions
Simulink no longer crashes when an S-function with variable sample time is placed in an atomic subsystem.
• Bus selector detection of duplicated names
A bug related to the detection of a duplicated name in a bus that was feeding a Bus Selector block was fixed.
• Optimize block memory use
In Simulink 4.0, the Continuous and Discrete Transfer Function blocks and the Discrete Filter block used more memory than they needed to, particularly for the case of many poles. They now use an optimal amount of memory.
• Miscellaneous fixes to the model loader
Miscellaneous bug fixes have been performed on the model loader:
- The loader and saver now retain any comment lines (i.e., lines that begin with #) that are found at the top of the model file.
- The loader does not crash on Windows NT when file sizes are integer multiples of 4096.
- The loader does not hang on corrupt models in which blocks with duplicate names are found.
• Profiler fixes
The Simulink profiler now saves its files in the temporary directory. See the
MATLAB command tempdir . The help was also updated.
• Chirp block fix
The Chirp block now sweeps through frequencies correctly from the initial frequency at the simulation start time to the target frequency at the target time.
• Function-call subsystem bug fixes
This version fixes several bugs related to the execution orders of function-call subsystems.
3-10
Bug Fixes
• Sorting bug fix
Previous versions incorrectly computed the direct feedthrough setting for nonvirtual subsystems in triggered/function-call subsystems. This resulted in incorrect execution (sorting) orders. Now all nonvirtual subsystems within triggered subsystems have their direct feedthrough (needs input) flags set for all input ports. This is needed because a nonvirtual subsystem with a triggered sample time executes both its output and update methods together within the context of the model's output method.
• Fixed handling of grounded/unconnected inputs feeding certain blocks
Simulink 4.0 incorrectly handled grounded or unconnected inputs to level-1 and level-2 S-functions requiring contiguous inputs and to some Matrix blocks. This has been fixed in Simulink 4.1.
3-11
3
Simulink 4.1 Release Notes
Platform Limitations for HP and IBM
Note The Release 12 platform limitations for Simulink for the HP and IBM platforms still apply to Release 12.1. In addition, there are more limitations, described below.
The following Java-dependent Simulink features, introduced in Simulink 4.1, are not available on these platforms.
• Simulink Data Class Designer
• S-Function Builder
• Look-Up Table Editor
3-12
Upgrading from an Earlier Release
Upgrading from an Earlier Release
This section discusses upgrade issues in moving from Simulink 4.0 to Simulink
4.1.
See the Release Notes for Release 12 for upgrade issues involved in moving from
Simulink 3.0 (Release 11.0) to Simulink 4.1.
Running Simulink 4.1 Models in Simulink 4.0
Simulink 4.0 can run models created or saved by Simulink 4.1 as long as the models do not use features introduced in the new version, including new block types and block parameters. In particular, you should not attempt to use
Simulink 4.0 to simulate or even open models that use the new Simulink control flow blocks. Opening such models cause Simulink 4.0 to crash.
Simulink Block Library Reorganization
The Simulink Block Library contains a new Subsystems sublibrary. The new library contains most of the new control flow blocks as well as subsystem and subsystem-related blocks that used to reside in the Signals & Systems library.
The subsystems in the new library each contain the minimum set of blocks needed to create a functioning subsystem, e.g., an input port and an output port.
Direct Feedthrough Compensation Deprecated
If an S-function needs the current value of its input to compute its output, it must set its direct feedthrough flag to true. Previously, if a direct feedthrough
S-function failed to do this, Simulink tried to provide a valid signal to the
S-function’s mdlOutput (M-file flag=3 ) or mdlGetTimeOfNextVarHit (M-file flag=4 ) methods. This special compensation mode for S-functions was flawed.
For this reason, the current version deprecates the mode, though making it available as an option. In this version, by default, if an S-function sets its direct feedthrough flag to false during initialization, Simulink sets the S-function’s input signal to NULL (or a NaN signal for M-file S-functions) during the mdlOutput or mdlGetTimeOfNextVarHit methods. Thus, in this version, models with S-function(s) may produce segmentation violations. See matlabroot/ simulink/src/sfuntmpl_directfeed.txt
for more information.
3-13
3
Simulink 4.1 Release Notes
S-Functions Sorted Like Built-In Blocks
When sorting blocks, Simulink now treats S-function blocks the way it treats built-in blocks. This means that S-functions now work correctly in nonvirtual subsystems when there is a direct feedback connection (in Simulink 4.0 and prior, this wasn't the case). It also means that models compile (update diagram) faster. As a side effect, the execution order for S-functions that incorrectly set the direct feedthrough flag differs from that used in previous versions of Simulink. Consequently, models that contain invalid S-functions may produce different answers in this version of Simulink.
Added Latched Triggered Subsystems
Now triggered subsystems enable you to implement software triggering, hardware triggering, or a combination of the two. Software triggering is defined as if (trigger_signal_edge_detected) { out(t) = f(in(t));
}
Hardware triggering is defined as if (trigger_signal_edge_detected) { out(t) = f(in(t-h)); // h == last step size
}
Previous to this version, triggered subsystems provided software triggering and a form of hardware triggering when a cycle involving triggered subsystems existed. Now, you must explicitly specify whether or not you’d like software or hardware triggering. This is done by selecting 'Latch (buffer) input' on the
Inport blocks in a triggered subsystem.
Each input port of a triggered subsystem configures whether or not the input should be latched. A latched input provides the hardware-triggering semantics for that input port. Type sl_subsys_semantics at the MATLAB prompt for more information.
Self-Triggering Subsystems Are No Longer Allowed
Before this version, you could define the output of a triggered subsystem to directly feed back into the trigger port of the subsystem (with potentially other
3-14
Upgrading from an Earlier Release additive signals). This resulted in an implicit delay. Now you must explicitly define the delay by inserting a memory block.
Improved Invalid Model Configuration Diagnostics
This version of Simulink does a better job of detecting and flagging invalid modeling constructs in Simulink models. Consequently models that ran in previous versions of Simulink (sometimes producing incorrect results) may not run in the current release. The changes include:
• Direct feedthrough compensation no longer occurs by default for S-functions
(see “Direct Feedthrough Compensation Deprecated” on page 3-13).
• S-functions are now sorted like built-in blocks (see “S-Functions Sorted Like
Built-In Blocks” on page 3-14).
• Simulink no longer inserts implicit latches in triggered subsystems that
directly or indirectly trigger themselves (see “Self-Triggering Subsystems
Are No Longer Allowed” on page 3-14, above). Instead it signals an error
when it detects a triggered subsystem loop with unlatched inputs. To avoid the error, you must select the Latch option on the triggered subsystem’s input ports.
• Simulink now signals an error when it detects invalid configurations of function-call subsystems. See the Subsystem Examples block in the
Subsystems library for examples of illegal modeling constructs involving function-call subsystems. You can disable this diagnostic by setting the
Invalid FcnCall Connection parameter on the Diagnostics pane of the
Simulation Parameters dialog box to none or warning .
3-15
3
Simulink 4.1 Release Notes
Known Software Problems
This section updates the Simulink 4.1 documentation set, reflecting known
Simulink 4.1 software problems.
Accelerator Mode Does Not Support Inline
Parameters
Accelerator mode does not support the Inline parameters option on the
Advanced pane of the Simulation Parameters dialog box. Block outputs may appear at different times in accelerated mode than they do when the model is running in normal mode with the Inline parameters option selected.
Turn the New Wrap Lines Option Off
The MATLAB Command Window has a new Wrap lines option. Many of
Simulink’s error messages are very long. This can cause some display problems. Therefore, when using Simulink, you should turn the Wrap lines option off using the Preferences setting. For more information on this issue, see the Technical Support Solution 29082 from the MathWorks Web page.
3-16
Stateflow 4.1 Release
Notes
New Features . . . . . . . . . . . . . . . . . . . 4-2
Smart Transitions . . . . . . . . . . . . . . . . . . 4-2
Search & Replace Tool Enhancements . . . . . . . . . . 4-3
Stateflow Chart Notes . . . . . . . . . . . . . . . . 4-3
Model Coverage Tool . . . . . . . . . . . . . . . . . 4-3
Major Bug Fixes . . . . . . . . . . . . . . . . . . 4-4
Editing Crossing Transitions out of Grouped Subcharts . . . 4-4
Disabled and Restored Library Chart Links . . . . . . . . 4-4
Too Many Action Statements During Simulation . . . . . . 4-4
False State Inconsistency Runtime Error . . . . . . . . . 4-4
MATLAB Variables Improperly Overwritten . . . . . . . 4-4
Target Options Fields Overwritten . . . . . . . . . . . 4-5
Transitions Assertions . . . . . . . . . . . . . . . . 4-5
Build Failures with Custom Code . . . . . . . . . . . . 4-5
Upgrading from an Earlier Release . . . . . . . . . 4-6
Transition Actions into Junctions Disallowed . . . . . . . 4-6
4
4
Stateflow 4.1 Release Notes
New Features
This section introduces new features and enhancements added in Stateflow 4.1
(Release 12.1) since the Web-downloadable release of Stateflow 4.0.2 (Release
12).
For information about the features of Stateflow 4.1 added since the release of
Stateflow 4.0 (Release 12) and prior versions, see the What's New link from the
Stateflow product page at www.mathworks.com
.
Note For information on new features in Stateflow Coder 4.1, software that generates code for your Stateflow diagrams, see the Stateflow Coder 4.1
Release Notes.
Smart Transitions
Stateflow charts now include the graphical innovation of smart transitions whose ends slide around the surfaces of states and junctions. When the source and/or destination objects are moved and resized in the Stateflow chart, these transitions use sliding and other behaviors to enable users to produce an aesthetically pleasing diagram. See the section “Using Smart Transitions” in
Stateflow Help.
Note Transitions are automatically created with smart behavior on the assumption that this behavior is almost always desirable. However, self-loop transitions, must be created without smart transition behavior. See the section “Creating Self-Loop Transitions” in online Help for instructions.
4-2
New Features
Search & Replace Tool Enhancements
Stateflow’s Search & Replace tool has been modified with the following enhancements:
• Regular expression tokenized replacements
Allows you to dynamically choose replacement text based on matched text.
• Case insensitivity/case preservation
Replaces text with different sensitivities to the use of upper or lower case characters in the found text.
• Addition of a Search in: field
Now you can select any Stateflow chart in your Simulink model or select the entire Stateflow machine.
See the section “Searching and Replacing in Charts” in Chapter 6, “Exploring and Searching Charts” in the Stateflow documentation for a full description.
Stateflow Chart Notes
You can now enter annotations to your Stateflow charts that are similar to annotations in Simulink. See the section “Entering Chart Notes” in Stateflow
Help.
Model Coverage Tool
The Simulink Model Coverage tool has been modified to perform model coverage calculations for decisions and conditions of decision in the Stateflow machine and its charts, states, and transitions. This includes Condition and
MCDC coverage. See the section “Stateflow Chart Model Coverage” of Chapter
10, “Debugging and Testing” in the Stateflow documentation.
4-3
4
Stateflow 4.1 Release Notes
Major Bug Fixes
The following is a list of known bugs from previous Stateflow version 4.0.2
(Release 12.0) which are fixed in Stateflow 4.1. For information about bugs fixed for prior versions, see the online topic “What’s New in Stateflow
.”
Note For information on major bugs fixed in Stateflow Coder 4.1, software that generates code for your Stateflow diagrams, see the chapter on the
Stateflow Coder 4.1 in the Release Notes.
Editing Crossing Transitions out of Grouped
Subcharts
Editing crossing transitions out of grouped subcharts caused model corruptions in Stateflow versions 3.0 through 4.0.2.
Disabled and Restored Library Chart Links
Stateflow library chart links that are disabled and then restored caused model corruptions in Stateflow versions 3.0 through 4.0.2.
Too Many Action Statements During Simulation
Stateflow Debugger caused an error during simulation when a state has more than 255 action statements in Stateflow versions 1.0 through 4.0.2.
False State Inconsistency Runtime Error
Charts within a Simulink enabled subsystem produced a false state inconsistency runtime error when the subsystem was disabled in Stateflow versions 2.0 through 4.0.3.
MATLAB Variables Improperly Overwritten
Selecting Save final value to base workspace in the properties dialog for a data item caused unrelated MATLAB variables in the workspace to be overwritten in Stateflow versions 4.0 through 4.0.3.
4-4
Major Bug Fixes
Target Options Fields Overwritten
The Custom Initialization and Custom Termination fields in the Target
Options dialog box were overwritten by empty strings in the data dictionary in
Stateflow 4.0.3.
Transitions Assertions
Transitions containing a temporal trigger combined with other event triggers, such as after(3E)|E2|E3 , caused assertion errors during parsing in Stateflow
4.0.3.
Build Failures with Custom Code
When including custom code, build failures occurred due to DOS shell command line length limitations because all user-defined directories on the
MATLAB path were added to the include directory list in Stateflow 4.0.3.
4-5
4
Stateflow 4.1 Release Notes
Upgrading from an Earlier Release
This section describes the upgrade issues involved in moving from Stateflow
4.0.2 (Release 12.0) or earlier to Stateflow 4.1 (Release 12.1).
Transition Actions into Junctions Disallowed
Transition actions are now permitted only on transitions that terminate on states. For the following reasons, transition actions are no longer permitted on transitions that terminate on junctions; condition actions should be used instead:
• The semantics of transition actions for transitions into junctions are complex and easily misunderstood and misused.
• The complex semantics of these transition actions also result in generated code that is inefficient. Eliminating these transition actions not only simplifies Stateflow diagrams but also results in generated code that is much more efficient.
If your current model has these transition actions, they are flagged with an error that refers you to Appendix D of the online Stateflow User’s Guide,
“Obsolete Features,” for a workaround. In most cases, replacing these transition actions with condition actions gives identical chart behavior.
4-6
Real-Time Workshop 4.1
Release Notes
Release Summary . . . . . . . . . . . . . . . . . 5-2
New Features . . . . . . . . . . . . . . . . . . . 5-3
Bug Fixes . . . . . . . . . . . . . . . . . . . . . 5-11
Platform Limitations for HP and IBM . . . . . . . . 5-15
Upgrading from an Earlier Release . . . . . . . . . 5-16
Known Software Problem . . . . . . . . . . . . . . 5-19
5
5
Real-Time Workshop 4.1 Release Notes
Release Summary
Real-Time Workshop 4.1 includes significant new and enhanced features and many improvements in the quality of generated code, including:
• Expression folding, which increases code efficiency and decreases code usage
• External mode support for inlined parameters
• Block states can now be interfaced to externally written code, in a manner similar to signals
• New debugger for Target Language Compiler (TLC) programs
• Support for new Simulink blocks, including control flow constructs such as do-while, for, and if
• Numerous bug fixes
5-2
New Features
New Features
This section introduces the new features and enhancements added in the
Real-Time Workshop 4.1 since the Real-Time Workshop 4.0.
For information about Real-Time Workshop features that are incorporated from recent releases, see the Release Notes for Release 12.
Note For information about closely related products that extend the
Real-Time Workshop, see the sections about the Real-Time Workshop Ada
Coder, Real-Time Workshop Embedded Coder, and xPC Target.
Block Reduction Option On by Default
The Block reduction option (on the Advanced page of the Simulation
Parameters dialog box) is now turned on by default. In prior releases, this option was off by default.
Block reduction collapses certain groups of blocks into a single, more efficient block, or removes them entirely. This results in faster model execution during simulation and in generated code.
See “Block Reduction Option” in the Real-Time Workshop User’s Guide for further information.
Buffer Reuse Code Generation Option
The Buffer reuse option is now available via the General Code Generation
Options (cont.) category of the Real-Time Workshop page. When the Buffer reuse option is selected, signal storage is reused whenever possible.
In previous releases, this option was available only through MATLAB set_param and get_param commands, such as: set_param(gcs,'bufferreuse','on')
The set_param and get_param commands are still supported.
See “Buffer Reuse Option” and “Signals: Storage, Optimization, and
Interfacing” in the Real-Time Workshop User’s Guide for further information.
5-3
5
Real-Time Workshop 4.1 Release Notes
Build Directory Validation
The build process now disallows building programs in the MATLAB directory tree. If you attempt to generate code in the MATLAB directory tree, an error message will be displayed prompting you to change to a working directory that is not in the MATLAB directory tree. On a PC, you can continue to build in the directory matlabroot/Work .
The build process also prevents building programs when matlabroot has a dollar sign ( $ ) in its MATLAB directory name.
Build Subsystem Enhancements
The Build Subsystem feature, introduced in Real-Time Workshop 4.0, lets you generate code and build an executable from any nonvirtual subsystem within a model. In Real-Time Workshop 4.1, the Build Subsystem feature has been enhanced as follows:
• The Build Subsystem window now displays additional information about block parameters referenced by the subsystem.
• From the Build Subsystem window, you can now inline any parameter or set the storage class of any parameter.
See “Generating Code and Executables from Subsystems” in the Real-Time
Workshop User’s Guide for further information.
C API for Parameter Tuning Documented
The Real-Time Workshop provides data structures and a C API that enable a running program to access model parameters without use of external mode.
This API has now been fully documented.
To access model parameters via the C API, you generate a model-specific parameter mapping file, model_pt.c
. This file contains parameter mapping arrays containing information required for parameter tuning.
See “C API for Parameter Tuning” in the Real-Time Workshop User’s Guide for information on how to generate and use the parameter mapping file.
5-4
New Features
Code Readability Improvements
Improvements to the readability of generated code include:
• Elimination of redundant parentheses.
• Long C statements in the generated code are now split across multiple lines.
• Block comments are more informative.
Control Flow Blocks Support
Simulink 4.1 implements a number of blocks that support logic constructs such as if-else and switch, and looping constructs such as do-while, for, and while.
The Real-Time Workshop 4.1 supports code generation from these blocks.
For further information on the flow control blocks, see “Control Flow
Statements” in Using Simulink.
Expression Folding
Expression folding is a code optimization technique that minimizes the computation of intermediate results at block outputs, and the storage of such results in temporary buffers or variables. Wherever possible, the Real-Time
Workshop collapses, or “folds,” block computations into single expressions, instead of generating separate code statements and storage declarations for each block in the model.
Expression folding dramatically improves the efficiency of generated code, frequently achieving results that compare favorably to hand-optimized code. In many cases, model computations fold into a single highly optimized line of code.
Most Simulink blocks support expression folding.
For further information, see “Expression Folding” in the Real-Time Workshop
User’s Guide.
5-5
5
Real-Time Workshop 4.1 Release Notes
External Mode Enhancements
Inline Parameters Support
The Real-Time Workshop now lets you use the Inline parameters code generation option when building an external mode target program. When you inline parameters, you can use the Model Parameter Configuration dialog to remove individual parameters from inlining and declare them to be tunable.
This allows you to improve overall efficiency by inlining most parameters, while at the same time retaining the flexibility of run-time tuning for selected parameters that are important to your application. In addition, the Model
Parameter Configuration dialog offers you options for controlling how parameters are represented in the generated code.
Each time Simulink connects to a target program that was generated with
Inline parameters on, the target program uploads the current value of its tunable parameters (if any) to the host. These values are assigned to the corresponding MATLAB workspace variables. This procedure ensures that the host and target are synchronized with respect to parameter values.
All targets that support external mode (i.e., grt , grt_malloc , and Tornado) now allow inline parameters.
See “Overview of External Mode Communications” in the Real-Time Workshop
User’s Guide for further information.
Status Bar Display
When Simulink is connected to a running external mode target program, the simulation time and other status bar information is now displayed and updated just as it would be in normal mode.
Generate Comments Option
This option lets you control whether or not comments are written in the generated code. See “Generate Comments” in the Real-Time Workshop User’s
Guide for further information.
5-6
New Features
Include System Hierarchy in Identifiers
When this option is on, the Real-Time Workshop inserts system identification tags in the generated code (in addition to tags included in comments). The tags help you to identify the nesting level, within your source model, of the block that generated a given line of code.
See “Include System Hierarchy in Identifiers” in the Real-Time Workshop
User’s Guide for further information.
Rapid Simulation Target Supports Inline Parameters
The Rapid Simulation Target now works with Inline parameters on. Note that when Inline parameters is on, the storage class for all parameters and signals is silently forced to auto .
S-Function Target Enhancements
The S-Function Target Generate S-function feature, introduced in Real-Time
Workshop 4.0, lets you generate an S-function from a subsystem. This feature has been enhanced as follows:
• The Generate S-function window now displays additional information about block parameters referenced by the generating subsystem.
• If you have installed and licensed the Real-Time Workshop Embedded
Coder, the Generate S-function window lets you invoke the Embedded
Coder to generate an S-function wrapper.
See “Automated S-Function Generation” in the Real-Time Workshop User’s
Guide for details.
Storage Classes for Block States
For certain block types, the Real-Time Workshop lets you control how block states in your model are stored and represented in the generated code. Using the State Properties dialog, you can:
• Control whether or not states declared in generated code are interfaceable
(visible) to externally written code. You can also specify that signals are to be stored in locations declared by externally written code.
• Assign symbolic names to block states in generated code.
5-7
5
Real-Time Workshop 4.1 Release Notes
For further information, see “Block States: Storing and Interfacing” in the
Real-Time Workshop User’s Guide.
Support for tilde (~) in Filenames on UNIX Platforms
All filename fields in Simulink now support the mapping of the tilde (~) character in filenames. For example, in a To File block you can specify
<code>~/outdir/file.mat</code> . On most systems, this will expand to / home/$USER/outdir/file.mat
. The Real-Time Workshop uses the expanded names.
Target Language Compiler 4.1
This section summarizes changes that have been made to the Target Language
Compiler in this release. See also “TLC Compatibility Issues” on page 5-17.
New TLC Debugger
The TLC debugger helps you identify programming errors in your TLC code.
The debugger lets you set breakpoints in your TLC code, execute TLC code line-by-line, examine and change variables, and perform many other useful operations.
The TLC debugger operates during code generation, incurring almost no overhead in the code generation process. You can invoke the debugger:
• By selecting options in the TLC debugging options category of the
Real-Time Workshop page
• By including %breakpoint statements in your TLC file.
• By using the MATLAB tlc command, as in tlc -dc <options>
• By using the
-dc build option in the System target file field of the
Real-Time Workshop page.
For further information, see “Debugging TLC” in the Target Language
Compiler Reference Guide.
model.rtw File Format Changes
The format of the model.rtw
file has changed. See “TLC Compatibility Issues” on page 5-17.
5-8
New Features
Cleanup of Block I/O Connection Handling in TLC
The handling of signal connections in rtw/c/tlc/blkiolib.tlc
and rtw/ada/ tlc/blkiolib.tlc
was reworked. See the discussion of LibBlockInputSignal in “TLC Function Library Reference” in the Target Language Compiler
Reference Guide.
Literal String Support
If a string constant is prefixed by the L format specifier, then no escape character processing is performed on that string. This is useful for specifying
PC style path or directory names, as in this example.
%addincludepath L"C:\mytlc"
New TLC Library Functions
The following functions have been added to the TLC Function Library:
• LibBlockInputSignalConnected
•
LibBlockInputSignalLocalSampleTimeIndex
• LibBlockInputSignalOffsetTime
•
LibBlockInputSignalSampleTime
• LibBlockInputSignalSampleTimeIndex
•
LibBlockOutputSignalOffsetTime
• LibBlockOutputSignalSampleTime
•
LibBlockOutputSignalSampleTimeIndex
• LibBlockMatrixParameterBaseAddr
•
LibBlockParameterBaseAddr
• LibBlockNonSampledZC
See “TLC Function Library Reference” in the Target Language Compiler
Reference Guide for information on these functions.
TLC Bug Fixes
• Fixed a bug where local variables of calling functions were sometimes incorrectly visible to called functions.
• The
ISINF , ISNAN , and ISFINITE functions now work for complex values.
• The %filescope directive now works as documented.
5-9
5
Real-Time Workshop 4.1 Release Notes
• Zero indexing on complex numbers is now supported.
In prior releases, the Target Language Compiler allowed 0 indexing for integer and real values, but not for complex values. This restriction has been removed in the Target Language Compiler 4.1, as shown in the following example.
%assign a = 1.0 + 3.0i
%assign b = a[0] %% zero index now allowed
• Fixed a crash that occurred if ROLL_ITERATIONS was called outside of a %roll construct. ROLL_ITERATIONS returns NULL if called outside of a %roll construct.
• TLC now allows use of any path separator character independent of operating system. You can use either \ or / as a path separator character on
Unix or Windows).
• Fixed a bug in the compare for equality operation.
0.0
now compares equal to -0.0
.
5-10
Bug Fixes
Bug Fixes
The Real-Time Workshop 4.1 includes the bug fixes described in this section.
See also “TLC Bug Fixes” on page 5-9 for bug fixes specific to the Target
Language Compiler.
Block Reduction Crash Fixed
A problem that crashed MATLAB due to a segmentation fault during the block reduction process has been fixed. This problem occurred only if the Block
Reduction option was on, and if a Scope block was connected to a block that was removed due to block reduction.
Build Subsystem Gives Better Error Message for
Function Call Subsystems
The Build Subsystem feature does not currently support triggered function-call subsystems. The Real-Time Workshop now gives a a more informative error message when a Build Subsystem is attempted with a triggered function-call subsystem.
Check Consistency of Parameter Storage Class and
Type Qualifier
The Real-Time Workshop now checks for consistency of parameter storage class and type qualifier when a parameter is specified by both the Model
Parameter Configuration dialog box and a referenced Simulink data object.
Code Optimization for Unsigned Saturation and
DeadZone Blocks
When the lower limit of a Saturation or DeadZone block is a zero and is nontunable, and the data type is unsigned, the comparison against the lower limit is omitted from the code. Similarly, if the upper or lower limit of the
Saturation block is nontunable and nonfinite, the comparison against the infinite limit is omitted.
5-11
5
Real-Time Workshop 4.1 Release Notes
Correct Code Generation of Fixed-Point Blockset
Blocks in DSP Blockset Models
A code generation bug involving some DSP Blockset blocks (see list below) was fixed. When these blocks were driven by a block from the Fixed-Point Blockset, generated code would write outside array memory bounds. The following DSP
Blockset blocks generated incorrect code:
• Delay Line
• Frame Status Conversion
• Matrix Multiply
• Multiport Selector
• Pad
• Submatrix
• Window Function
• Zero Pad
Correct Compilation with Green Hills and DDI
Compilers
Compilation errors for files associated with matrix inversion in the
matlabroot/rtw/c/libsrc directory were fixed. These errors occurred with the Green Hills and DDI compilers.
Fixed Build Error with Models Having Names
Identical to Windows NT Commands
This fix prevents an error that occurred when building models having names identical to Windows NT internal commands. Examples would be models named verify or path . Such model names are now allowed.
Fixed Error Copying Custom Code Blocks
An error in the Custom Code block Copyfcn callback was fixed. The problem caused an error when copying a custom code block within a model.
5-12
Bug Fixes
Fixed Error in commonmaplib.tlc
A typo in rev 1.17 of commonmap.tlc
was fixed. This typo caused an error during code generation, when using the grt_malloc target with External mode selected.
Fixed Name Clashes with Run-Time Library
Functions
The Real-Time Workshop now uses the macros rt_min and rt_max to avoid clashing with run-time library min and max functions.
Improved Handling of Sample Times
The sample time handling for the S-function and ERT targets has been improved to use the compiled sample time instead of the user specified sample time on the input port blocks.
Look-Up Table (n-D) Code Generation Bug Fix
The Real-Time Workshop now generates correct code for Look-Up Table (n-D) blocks having 5 or more dimensions with different dimension sizes.
Parenthesize Negative Numerics in Fcn Block
Expressions
Fcn block expressions in the generated code failed to compile in the case of a unary operator preceding a workspace variable with a negative value, such as the expression
-v*u
Such expressions are now enclosed in parentheses, as in
(-v) * u
5-13
5
Real-Time Workshop 4.1 Release Notes
Removed Unnecessary Warnings and Declarations from Generated Code
Several unnecessary warnings and declarations in the generated code have been removed. These include:
• In functions where the tid argument is not referenced, the declaration
(void)tid is no longer generated. (The tid argument is required because the function
API is predefined.)
• Warnings involving const casts were suppressed in some of the rtw/c/libsrc modules.
Retain .rtw File Option Now Works in Accelerator
Mode
In previous releases, the Retain .rtw file option (on the TLC Debugging
Options page of the Simulation Parameters dialog box) was ignored if
Simulink was in Accelerator mode. Now, you can retain the model.rtw
file during a build, regardless of the simulation mode.
S-Function Target Memory Allocation Bug Fix
A segmentation fault during generation of S-functions was removed by fixing the memory management of the port data structure.
5-14
Platform Limitations for HP and IBM
Platform Limitations for HP and IBM
Note The Release 12.0 platform limitations for Real-Time Workshop for the
HP and IBM platforms still apply to Release 12.1. That limitation is described below.
Tunable Parameters Dialog Box
On the HP and IBM platforms, the Real-Time Workshop opens the Release 11
Tunable Parameters dialog box in place of the Model Parameter
Configuration dialog box. Although they differ in appearance, both dialogs present the same information and support the same functionality.
5-15
5
Real-Time Workshop 4.1 Release Notes
Upgrading from an Earlier Release
This section describes the upgrade issues involved in moving from the
Real-Time Workshop 4.0 (Release 12.0) to the Real-Time Workshop 4.1.
For information about upgrading from a release earlier than 4.0, see the
Release Notes for Release 12.
RTWInfo Property Changes
If you use the Simulink Data Object classes Simulink.Signal
or
Simulink.Parameter
, or have implemented classes derived from these, note the following information concerning the RTWInfo properties.
In Release 12.0, the RTWInfo class had a TypeQualifier property, corresponding to the RTW storage type qualifier field of signal ports and parameters.
Real-Time Workshop 4.1 now supports creation of custom storage classes, removing the need for the TypeQualifier property. We recommend that you
use custom storage classes when type qualification is needed. See “Custom
Storage Classes for Data Objects” on page 26-3 for further information.
By default, the TypeQualifier property of RTWInfo objects is no longer visible in the Simulink Data Explorer. Also, the TypeQualifier property is no longer written to ObjectProperties records in the model.rtw
file. For backward compatibility, the TypeQualifier property remains active. The property can be set and retrieved through a direct reference. For example,
Kp.RTWInfo.TypeQualifier = 'const' or tq = Kp.RTWInfo.TypeQualifier
You can make the TypeQualifier property visible in the Simulink Data
Explorer for the duration of a MATLAB session. To do this, execute the following command prior to opening the Simulink Data Explorer), feature('RTWInfoTypeQualifier',1)
The above command also directs the Real-Time Workshop to include the
TypeQualifier property in ObjectProperties records in the model.rtw
file.
5-16
Upgrading from an Earlier Release
For further information see “Simulink Data Objects and Code Generation” in the Real-Time Workshop User’s Guide.
S-Function Target MEX-Files Must Be Rebuilt
S-function MEX-files generated by the S-function target under Release 11 are not compatible with Release 12. The incompatibilities are due to new features, such as parameter pooling, introduced in Release 12.0.
If you have built S-function MEX-files with the S-function target under Release
11, you must rebuild them. See “The S-Function Target” in the Real-Time
Workshop User’s Guide for further information.
TLC Compatibility Issues model.rtw File Format Changes
The format of the model.rtw
file has changed. For further information, see
“model.rtw Changes Between Real-Time Workshop 4.0 and 4.1” in the Target
Language Compiler Reference Guide.
Reordering of BlockTypeSetup and BlockInstanceSetup Calls
During the initialization phase of code generation, the Target Language
Compiler makes a pass over all blocks in the model and executes several functions, including:
• Each block’s
BlockTypeSetup function the first time that block type is encountered.
• Each block’s
BlockInstanceSetup function. BlockInstanceSetup is called for all instances of a given block type in the model.
The order in which these calls are made is significant, because the
BlockInstanceSetup function may depend upon global variables that are initialized by the BlockTypeSetup function.
In Release 12.1, the BlockTypeSetup function is called before the
BlockInstanceSetup . This corrects a problem in previous releases, where
BlockInstanceSetup was erroneously called first. You may need to change your S-functions or block implementations if they depend upon the previous behavior.
5-17
5
Real-Time Workshop 4.1 Release Notes
Obsolete Code Generation Variables
The code generation variables FunctionInlineType and PragmaInlineString are now obsolete. These variables controlled the generation of inlined functions. In the current release, you can generate inlined functions from subsystems, as described in “Nonvirtual Subsystem Code Generation” in the
Real-Time Workshop User’s Guide.
5-18
Known Software Problem
Known Software Problem
This section updates the Real-Time Workshop 4.1 documentation set, reflecting a known software problem.
Turn the New Wrap Lines Option Off
The MATLAB Command Window has a new Wrap lines option. Real-Time
Workshop frequently displays very long message lines as a build progresses.
This can cause some display problems. Therefore, when using Real-Time
Workshop, you should turn the Wrap lines option off using the Preferences setting. For more information on this issue, see the Technical Support Solution
29082 from the MathWorks Web page.
5-19
5
Real-Time Workshop 4.1 Release Notes
5-20
CDMA Reference Blockset
1.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 6-2
Frame-Based Signal Support . . . . . . . . . . . . . . 6-2
Upgrading from an Earlier Release . . . . . . . . . 6-3
6
6
CDMA Reference Blockset 1.1 Release Notes
New Features
This section introduces the new features added in the CDMA Reference
Blockset 1.1 since the CDMA Reference Blockset 1.0.2 (Release 12).
Frame-Based Signal Support
The CDMA Reference Blockset 1.1 supports frame-based signals and matrix signals. As a result, it is no longer necessary to change the signal attributes of blocks from the Communications Blockset or the DSP Blockset in order to use them in models with blocks from the CDMA Reference Blockset. This makes it even easier to use the CDMA Reference Blockset with those blocksets.
All of the blocks in Version 1.1 allow both frame-based and sample-based signals, with the exception of the following blocks, which allow only frame-based signals:
• IS-95A Fwd Ch Base Station Transmitter Interface
• IS-95A Fwd Ch Descrambler
• IS-95A Fwd Ch Detector
• IS95A Long Code Generator
• IS-95A Rev Ch Detector
• IS-95A Rev Ch Rake Finger
• IS-95 A Rev Ch Walsh Modulation and Spreading
• IS95A Short Code Generator
• IS95A Walsh Code Generator
You can open the new Version 1.1 libraries by typing cdmalibv1p1 at the
MATLAB prompt, or by using the Simulink Library Browser.
6-2
Upgrading from an Earlier Release
Upgrading from an Earlier Release
If you are upgrading from the CDMA Reference Blockset Version 1.0.2 to
Version 1.1, models built with Version 1.0.2 will continue to work in Version
1.1.
However, you may encounter problems if you combine old blocks from Version
1.0.2 in a model with the following new Version 1.1 code generators:
• IS95A Long Code Generator
• IS95A Short Code Generator
• IS95A Walsh Code Generator
The Version 1.0.2 blocks that do not support frames, and so cannot be used with the Version 1.1 code generators, are:
• IS-95A Fwd Ch Base Station Transmitter Interface
• IS-95A Fwd Ch Descrambler
• IS-95A Fwd Ch Detector
• IS-95A Rev Ch Detector
• IS-95A Rev Ch Rake Finger
• IS-95 A Rev Ch Walsh Modulation and Spreading
If you continue to add blocks to a model built with Version 1.0.2, we recommend that you use blocks from the Version 1.0.2 libraries. You can open the Version
1.0.2 libraries by typing cdmalib at the MATLAB prompt.
6-3
6
CDMA Reference Blockset 1.1 Release Notes
6-4
Communications Blockset
2.0.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 7-2
Setting Simulink Preferences Automatically . . . . . . . 7-2
Converting Between Bipolar and Unipolar Signals . . . . . 7-2
Choosing Seeds for Random-Output Blocks . . . . . . . . 7-2
Using Error Counts to Control Simulation Duration . . . . 7-3
Choosing the Algorithm for Integrator Blocks . . . . . . . 7-3
Major Bug Fixes . . . . . . . . . . . . . . . . . . 7-4
Bug Fixes Incorporated from Release 12.0 . . . . . . . . 7-4
Upgrading from an Earlier Release . . . . . . . . . 7-5
Known Software and Documentation Problems . . . . 7-6
Code Generation Limitations . . . . . . . . . . . . . . 7-6
Limited Frame and Matrix Support . . . . . . . . . . . 7-6
Errors in Printed Version of Documentation . . . . . . . . 7-7
7
7
Communications Blockset 2.0.1 Release Notes
New Features
Note The Communications Blockset was a new product that was introduced with Release 12.0. The Communications Blockset incorporates the functionality of the blocks that were included in the Communications Toolbox
1.4 (Release 11), with the addition of the new features summarized below. The
Communications Toolbox is described in the Release Notes for Release 12.
This section introduces the new features and enhancements added in the
Communications Blockset 2.0.1 since the Communications Blockset 2.0
(Release 12.0).
For information about Communications Blockset features that are incorporated from recent releases, see the Release Notes for Release 12.
Setting Simulink Preferences Automatically
The new commstartup.m
script sets certain Simulink preferences to values that are most appropriate for the simulation of communication systems. To use this script, type the command commstartup in your startup.m
file or in the
MATLAB Command Window.
Converting Between Bipolar and Unipolar Signals
The Utility Functions library contains new blocks that convert between bipolar and unipolar signals. The blocks are Bipolar to Unipolar Converter and
Unipolar to Bipolar Converter.
Choosing Seeds for Random-Output Blocks
The randseed function is a new function that generates prime numbers for use as Initial seed parameters in blocks that produce random output. Compared to composite seeds, prime seeds yield output that has better statistical properties.
7-2
New Features
Using Error Counts to Control Simulation Duration
You can now configure the Error Rate Calculation block so that it automatically stops the simulation upon detecting a specified number of errors.
You do not need to know in advance how long it will take to accumulate that many errors.
Choosing the Algorithm for Integrator Blocks
The Discrete Modulo Integrator block now allows you to choose the integration method using a mask parameter. The corresponding mask parameter in the
Windowed Integrator block has changed its name from Method to Integration method for consistency with other integration blocks.
7-3
7
Communications Blockset 2.0.1 Release Notes
Major Bug Fixes
The Communications Blockset 2.0.1 includes several bug fixes, including the following:
• The M-FSK Baseband Modulator, M-FSK Baseband Demodulator, M-FSK
Passband Modulator, and M-FSK Passband Demodulator blocks now use the correct tone spacing.
• The PN Sequence Generator block now generates only binary values, and the numbers in the sequence do not depend on the frame status or size.
Bug Fixes Incorporated from Release 12.0
The Communications Blockset 2.0.1 includes several bug fixes that were made in Release 12.0.
7-4
Upgrading from an Earlier Release
Upgrading from an Earlier Release
If you are upgrading from an earlier release to the Communications Blockset
2.0.1, then note these issues:
• The Binary Symmetric Channel block dialog box now omits the Input vector length and Sample time parameters because the block now determines these quantities automatically. However, if you open a model in Release 12.1 that contains the Release 12.0 Binary Symmetric Channel block, then the
Command Window might display warnings about block parameters. To suppress these warnings in the future, simply save the model from Release
12.1.
• In the Communications Blockset 2.0.1, any model that includes a digital passband modulator block or a digital passband demodulator block must use a variable-step solver rather than a fixed-step solver. To configure a model so that it uses a variable-step solver, select Simulation parameters from the model window’s Simulation menu and then set the Type parameter on the
Solver panel to Variable-step.
See the Release Notes for Release 12 for upgrade issues involved in moving from the Communications Toolbox 1.4 (Release 11) to the Communications Blockset
2.0.1.
7-5
7
Communications Blockset 2.0.1 Release Notes
Known Software and Documentation Problems
This section updates the Communications Blockset 2.0.1 documentation set, reflecting known Communications Blockset 2.0.1 software and documentation problems.
Code Generation Limitations
Several Communications Blockset blocks are incompatible with Real-Time
Workshop. As a result, Real-Time Workshop cannot generate code for models that include these blocks:
• Continuous-Time Eye and Scatter Diagrams block
• Multipath Rayleigh Fading Channel block
• Rician Fading Channel block
• Triggered Read from File block
• Triggered Write to File block
• Voltage-Controlled Oscillator block
• Blocks in the Analog Passband and Digital Passband sublibraries of the
Modulation library
• Blocks in the CPM sublibrary of the Digital Baseband sublibrary of the
Modulation library
Limited Frame and Matrix Support
The Communications Blockset provides limited support for matrix and frame-based signals. In a future release, more blocks will support multichannel behavior, and more blocks will be optimized for faster frame-based processing.
Release 12.1 strives to be forward-compatible in the sense that future signal support modes should not invalidate current modes and should minimize the difficulty of upgrading from Release 12.1 to a future release.
As a consequence of this view, some blocks now use strict guidelines to determine the kinds of signals that they accept. One consideration is that if a block will ultimately support frame-based multichannel signals, then a sample-based vector input might potentially represent either a frame of data from a single channel or a set of samples from multiple channels. Therefore, even if such a block does not currently provide such comprehensive signal
7-6
Known Software and Documentation Problems support, it accepts only frame-based vectors, whose interpretation is unambiguous.
Errors in Printed Version of Documentation
The printed version of the Communications Blockset User’s Guide contains these errors:
• In the example, “Passband Digital Modulation,” the instructions on page
2-82 for configuring the Mean block should say, “Set Reset port to None” instead of “Uncheck the Reset port check box.” The electronic version of the instructions is correct.
• Reference pages for some blocks in the CPM modulation libraries omit the
Symbol prehistory and/or Phase offset parameters. The electronic versions of the reference pages are correct. The affected blocks are:
- CPM Demodulator Baseband
- GMSK Demodulator Baseband
- MSK Demodulator Baseband
- CPFSK Demodulator Baseband
- CPM Demodulator Passband
- GMSK Demodulator Passband
7-7
7
Communications Blockset 2.0.1 Release Notes
7-8
Control System Toolbox
5.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 8-2
SISO Design Tool Enhancements . . . . . . . . . . . . 8-2
Algorithmic Enhancements . . . . . . . . . . . . . . 8-3
Platform Limitations for HP and IBM . . . . . . . . 8-4
Preference and Property Editors . . . . . . . . . . . . 8-4
SISO Design Tool . . . . . . . . . . . . . . . . . . 8-4
8
8
Control System Toolbox 5.1 Release Notes
New Features
This section introduces the new features and enhancements added in the
Control System Toolbox 5.1 since the Control System Toolbox 5.0 (Release
12.0).
For information about Control System Toolbox features that are incorporated from recent releases, see the Release Notes for Release 12.
SISO Design Tool Enhancements
Enhancements to the SISO Design Tool include the following:
• Save/load session — You can now save the state of the SISO Design Tool before exiting and restore it at a later time.
• Graphical design constraints — You can use a new set of design constraints that you move and shape with the mouse or specify by typing their parameter values. For example, the design constraints for root locus include damping ratios, settling time, natural frequency, and percent overshoot.
• Interactive open-loop Nichols plot — You can use a new view to graphically tune the parameters of the feedback compensator. The open-loop Nichols plot contains the same functionality as the open-loop Bode diagram and root locus.
• Interactive Prefilter Design view — You can now interactively shape the prefilter compensator. Both interactive graphics and a right-click menu are available.
• New compensator format — You can display compensator transfer functions in the natural frequency format, which is of the form dcgain
×
(
(
1 + s
⁄ ω )
1 + s
⁄ ω
p1
)
… where
ω z1
,
ω z2
, ... and
ω p1
,
ω p2
, ..., are the natural frequencies of the zeros and poles, respectively.
For detailed examples of how to use the SISO Design Tool, see “Designing
Compensators” in Getting Started with the Control System Toolbox.
8-2
New Features
Algorithmic Enhancements
Enhancements to controls algorithms include:
• M-circle grid for Nyquist plots
• A new function, bandwidth , that calculates the bandwidth of SISO systems
• LTI models with complex data — You can now specify transfer functions or state-space models with complex coefficients. Most commands work on such models, except for the following:
- Time response commands
rlocus
margin , allmargin
• New LTI method conj for use with LTI models with complex data (works for
TF, ZPK, SS objects)
8-3
8
Control System Toolbox 5.1 Release Notes
Platform Limitations for HP and IBM
Note The Release 12.0 platform limitations for the HP and IBM platforms still apply to Release 12.1. Those limitations are described below.
Preference and Property Editors
The Toolbox Preferences Editor and Response Property Editor are not supported. The LTI Viewer Preferences Editor is supported with a reduced set of features (no tools to set preferences for grids, fonts, colors, or phase wrapping).
SISO Design Tool
The following features are not supported for the SISO Design Tool:
• Preference and property editing
• Compensator format editing
• Storing and retrieving compensators
• Design Constraints
In addition, the SISO Tool Export window has fewer export options.
8-4
Data Acquisition Toolbox
2.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 9-2
Additional National Instruments Hardware Support . . . . 9-2
High Resolution Sound Card Support . . . . . . . . . . 9-2
Upgrading from an Earlier Release . . . . . . . . . 9-3
Events, Callbacks, and Function Handles . . . . . . . . . 9-3
Vendor Drivers . . . . . . . . . . . . . . . . . . . 9-3
Removed and Obsolete Functions . . . . . . . . . . . . 9-4
Two daqhwinfo Fields Removed . . . . . . . . . . . . . 9-4
Known Software and Documentation Problems . . . . 9-5
High Resolution Sound Cards . . . . . . . . . . . . . 9-5
The putdata Function . . . . . . . . . . . . . . . . . 9-5
The daqread Function . . . . . . . . . . . . . . . . . 9-5
Vendor Limitations . . . . . . . . . . . . . . . . . . 9-5
9
9
Data Acquisition Toolbox 2.1 Release Notes
New Features
This section introduces the new features and enhancements added in the Data
Acquisition Toolbox 2.1 since the Data Acquisition Toolbox 2.0 (Release 12.0).
For information about Data Acquisition Toolbox features that are incorporated from recent releases, see the Release Notes for Release 12.
Additional National Instruments Hardware Support
These additional National Instruments boards are supported:
• 445x Dynamic Signal Acquisition (DSA) Series boards
• Analog output boards
• Digital I/O boards (no streaming)
High Resolution Sound Card Support
High resolution (greater than 16-bit) sound cards are supported. You configure the resolution of your sound card with the BitsPerSample property.
BitsPerSample can be 8 or any value between 16 and 32 .
Note Some sound card drivers may not support this feature because they are still in beta.
9-2
Upgrading from an Earlier Release
Upgrading from an Earlier Release
Note The following issue is involved in upgrading from the Data Acquisition
Toolbox 2.0 to Data Acquisition Toolbox 2.1.
Events, Callbacks, and Function Handles
Action properties and action functions are now referred to as callback properties and callback functions. This new terminology is reflected in new names for the associated properties and functions. The general rule for the name changes is to change “Action” to “Fcn” for properties, and “action” to
“callback” for functions. For example, TimerAction has been renamed
TimerFcn , and daqaction has been renamed daqcallback .
Additionally, if you want to automatically pass the object and event information to the callback function, then you must specify the function as either a function handle or as a cell array. Note that you can also specify the callback function as a string. In this case, the callback is evaluated in the
MATLAB workspace and no requirements are made on the function’s input arguments.
Note The following issues are involved in upgrading from the Data
Acquisition Toolbox 1.0.1 to the Data Acquisition Toolbox 2.1.
Vendor Drivers
If you are not using the latest drivers for your hardware, and you experience problems with the toolbox, then you should upgrade your drivers:
• For National Instruments hardware, you should use NI-DAQ 6.7.0 ( http:// www.ni.com/nidaq ). Note that you should be able to use NI-DAQ 6.8, although the toolbox has not been fully tested against this driver version.
• For Agilent Technologies hardware, you should use VXI Plug and Play
Drivers version A.06.04 ( http://www.tm.agilent.com
).
9-3
9
Data Acquisition Toolbox 2.1 Release Notes
Removed and Obsolete Functions
The nidaq , winsound , and hpe1432 functions have been removed.
The obj2code function has been renamed to obj2mfile . obj2code will still work but it now produces a warning.
Two daqhwinfo Fields Removed
The ConversionExtraScaling and ConversionOffset fields of the daqhwinfo function have been removed. You can use the NativeScaling and
NativeOffset properties to convert native data to doubles.
9-4
Known Software and Documentation Problems
Known Software and Documentation Problems
This section updates the Data Acquisition Toolbox 2.1 documentation set, describing known software problems.
High Resolution Sound Cards
To use the high resolution capabilities for some sound cards, you may need to configure BitsPerSample to 32 even if your device does not use that number of bits.
The putdata Function
You should not modify the BitsPerSample , InputRange , SensorRange , and
UnitsRange properties after calling putdata . If these properties are modified, all data is deleted from the data acquisition engine. If you add a channel after calling putdata , then all data will be deleted from the buffer.
The daqread Function
Property values specified as a cell array are not returned from a .daq
file.
Vendor Limitations
Limitations associated with the supported vendors are described in the Release
Notes for Release 12.
9-5
9
Data Acquisition Toolbox 2.1 Release Notes
9-6
Database Toolbox 2.2
Release Notes
New Features . . . . . . . . . . . . . . . . . . . 10-2
Retrieve Data as numeric or structure Format . . . . . . . 10-2
Export Numeric or Structure Data . . . . . . . . . . . 10-2
Specify Error Handling Preference . . . . . . . . . . . 10-2
LONGCHAR Data Type Supported . . . . . . . . . . . 10-3
No HP 10.2 Support . . . . . . . . . . . . . . . . . 10-4
10
10
Database Toolbox 2.2 Release Notes
New Features
This section introduces the new features and enhancements in the Database
Toolbox 2.2, added since the Database Toolbox 2.1 (Release 12.0).
For information about Database Toolbox features that are incorporated from recent releases, see the Release Notes for Release 12.
Retrieve Data as numeric or structure Format
You can specify as a preference the format in which data is retrieved from a database, called the DataReturnFormat . Options are numeric , structure , and cellarray . Previous versions of the Database Toolbox only supported the cellarray format.
You can use the numeric format when all data to be retrieved is numeric or when non-numeric data is not relevant. Any strings in the data are converted as specified in the NullNumberRead preference, for example, NaN . The numeric format allows for a significant reduction in memory usage. The structure format allows you to access the retrieved data as a MATLAB structure.
To set the preference, use the setdbprefs function. In the Visual Query
Builder, set the format using the Query -> Preferences menu. For details on the options, see the reference page for setdbprefs .
Export Numeric or Structure Data
Using insert and update , you can export data that is a numeric matrix, a structure, or a cell array. Previous versions only supported data in a cell array for export. There is no specific action you take to specify the format for exported data; the data is exported in its current MATLAB format.
Specify Error Handling Preference
You can specify the behavior for handling errors when retrieving data from a database, called the ErrorHandling preference. The options are store , report , and empty . Previous versions of the Database Toolbox only supported the store option, meaning the error message is stored in the returned data. The report option immediately displays any error messages in the Command Window. For the empty option, the error message is in the returned data, but it returns objects that could not be created as empty handles.
10-2
New Features
To set the preference, use the setdbprefs function. In the Visual Query
Builder, set the preference using the Query -> Preferences menu. For details on the options, see the reference page for setdbprefs .
LONGCHAR Data Type Supported
The LONGCHAR data type is supported. This is called the Memo data type in
Microsoft Access.
10-3
10
Database Toolbox 2.2 Release Notes
Platform Limitations for HP and Linux
logintimeout Not Supported on Linux
On LINUX platforms, logintimeout is not supported.
Note The Release 12.0 platform limitation for the HP platform still applies to
Release 12.1. That limitation is described below.
No HP 10.2 Support
The Database Toolbox is not supported on the Hewlett-Packard 10.2 platform.
10-4
Datafeed Toolbox 1.3
Release Notes
New Features . . . . . . . . . . . . . . . . . . . 11-2
Hyperfeed Support Added . . . . . . . . . . . . . . . 11-2
Hyperfeed Function Summary . . . . . . . . . . . . . 11-2
FT Interactive Data Server . . . . . . . . . . . . . 11-3
11
11
Datafeed Toolbox 1.3 Release Notes
New Features
This section introduces the new features and enhancements added in the
Datafeed Toolbox 1.3 since Datafeed Toolbox 1.2 (Release 12.0).
For information about Datafeed Toolbox features that are incorporated from recent releases, see the Release Notes for Release 12.
Hyperfeed Support Added
The Datafeed Toolbox Version 1.3 adds the Hyperfeed data server to the list of previously supported servers (i.e., Bloomberg, FT Interactive Data, and
Yahoo). Version 1.3 provides functions to obtain price, profile, historical and tick data from Hyperfeed.
Hyperfeed Function Summary
Table 11-1: Datafeed Toolbox Hyperfeed Functions
Function Purpose close connection fetch data get hyperfeed
Get connection properties
Connect to Hyperfeed isconnection True if valid connection
11-2
FT Interactive Data Server
FT Interactive Data Server
The default location for installing FT Interactive Data client software is
C:\RPLUS .
For successful operation after installation, add this directory to the Windows system path:
• For Windows 95/98, enter this directory in the autoexec.bat
file.
• For Windows NT, use the System Control Panel to add this directory to the path.
11-3
11
Datafeed Toolbox 1.3 Release Notes
11-4
12
Developer’s Kit for Texas
Instruments™ DSP 1.1 Release Notes
Introduction to Developer’s Kit for
Texas Instruments™ DSP . . . . . . . . . . . . 12-2
New Features . . . . . . . . . . . . . . . . . . . 12-4
New Link Functions for CCS IDE . . . . . . . . . . . . 12-4
New Interface Between the Developer’s Kit and FDATool . . 12-5
Unified CCS IDE and C6701 EVM Targeting . . . . . . . 12-5
New Run-Time Libraries . . . . . . . . . . . . . . . 12-6
Architecture Change in CCSDSP Object . . . . . . . . . 12-6
Updated Function writemsg Help Text . . . . . . . . . . 12-7
Major Bug Fixes . . . . . . . . . . . . . . . . . . 12-8
Upgrading from an Earlier Release . . . . . . . . . 12-9
New Libraries at Run-Time . . . . . . . . . . . . . . 12-9
CCSDSP Changes . . . . . . . . . . . . . . . . . . 12-9
Unified Targeting . . . . . . . . . . . . . . . . . . 12-9
Known Software and Documentation Problems . . . 12-10
Operating Systems . . . . . . . . . . . . . . . . . 12-10
Linking . . . . . . . . . . . . . . . . . . . . . 12-10
Targeting . . . . . . . . . . . . . . . . . . . . . 12-12
Demos . . . . . . . . . . . . . . . . . . . . . . 12-14
Datatypes . . . . . . . . . . . . . . . . . . . . . 12-14
General Target Operations . . . . . . . . . . . . . . 12-15
Documentation . . . . . . . . . . . . . . . . . . 12-15
12
Developer’s Kit for Texas Instruments™ DSP 1.1 Release Notes
12-2
Introduction to Developer’s Kit for Texas Instruments™ DSP
The Developer’s Kit for Texas Instruments™ DSP 1.1 is a new product that is included on our product CD for the first time in Release 12.1
Note The Developer’s Kit for Texas Instruments™ DSP 1.0 was released as a Web-downloadable product prior to Release 12.1. Version 1.1 of this product
includes some important updates to Version 1.0, as summarized in “New
Composed of three component collections, the Developer’s Kit lets you develop signal processing systems for the C6701 EVM, and use MATLAB to access and load data to and from the digital signal processor on a target signal processor.
The three libraries are shown below.
Product Name
Target for C6701 EVM
Library Name c6701evmlib
Link for Code Composer
Studio IDE tiddk/@ccs/ccsdsp
Link for RTDX
Interface tiddk/@ccs/rtdx
Description
Contains the blockset needed to use Simulink and Real-Time Workshop to create applications for the C6701 EVM. Use this set of four blocks to configure the coder-decoder
(codec) and LEDs on the C6701 EVM. Also lets you target Code Composer Studio to build new projects from Real-Time
Workshop.
Contains the Code Composer Studio IDE
(CCS IDE) interface software. Includes functions that enable you to use MATLAB to communicate with the CCS IDE.
Contains MATLAB objects and methods for communicating with target digital signal processors on boards installed in your PC, such as the C6701 EVM. With RTDX you can read and write data in real time to your target.
Introduction to Developer’s Kit for Texas Instruments™ DSP
The Developer’s Kit lets you use Simulink to model floating-point digital signal processing algorithms from blocks in the DSP Blockset, and then use the
Real-Time Workshop to build ANSI C code targeted to the TMS320C6701 EVM
(C6701 EVM). The Developer’s Kit takes the generated C code and uses Texas
Instruments (TI) tools to build C6701 EVM-specific machine code. The build process downloads the targeted machine code to the evaluation module and runs the executable on the TMS320C6701 Digital Signal Processor.
After downloading the code to the board, your digital signal processing application or algorithm runs automatically on the evaluation module. You have the option of compiling your model in CCS IDE without downloading the code to the target.
Texas Instruments produces the C6701 EVM to help you create DSP applications for the Texas Instruments TMS320C6701 processor. You can create, test, and deploy your signal processing algorithms or filters on the target processor without the difficulties inherent in starting with the digital signal processor itself and building the support hardware to test the application on the processor. Instead, the C6701 EVM provides the input hardware, output hardware, timing circuitry, memory, and power for the
C6701 digital signal processor. Texas Instruments provides the software tools, such as the C compiler, linker, and assembler, and Code Composer Studio
(CCS), for you to use your PC to develop, download, and test your algorithms and applications on their C6701 EVM. You can launch Code Composer Studio
Integrated Development Environment (CCS IDE) directly from the Developer’s
Kit. When you use the targeting option, the Developer’s Kit launches the integrated development environment and populates a new development project with the files from your Real-Time Workshop build process. You select whether the process downloads your code to the target, or stops after it builds the new project.
12-3
12
Developer’s Kit for Texas Instruments™ DSP 1.1 Release Notes
New Features
Note The Developer’s Kit for Texas Instruments™ DSP 1.0 was released as a Web-downloadable product prior to Release 12.1. Version 1.1 of this product includes some important updates to Version 1.0, as summarized below.
New Link Functions for CCS IDE
Version 1.1 of the Developer’s Kit adds five functions that extend the program debugging and project management capabilities of the tool.
Function add delete insert isrtdxcapable remove
Description
Places a file in the current CCS project. Use this function to add the specified file in your current project in CCS. Supports adding C/C++ files, ASM files, object and library files, linker command files, and DSP/BIOS files.
Removes debug points in CCS. You can remove breakpoints, probe points, and profile points. To identify the point to delete you specify either the address or line number.
Adds debug points in CCS. You can add breakpoints, probe points, and profile points. To identify the location and type of point to insert you specify either the address or line number.
Determines and returns whether the target associated with a CCSDSP object supports RTDX communications.
Removes files from the current CCS project. With this function you can remove any type of file contained in the project.
12-4
New Features
New Interface Between the Developer’s Kit and
FDATool
If you own the Filter Design Toolbox or the Signal Processing Toolbox, you can design filters in Filter Design and Analysis Tool (FDATool) and export those filter designs directly to CCS IDE and to your target. You do not need to export the filters to your MATLAB workspace first.
With this link, you can design filters, export them to your target, and test them in your signal processing application. In addition, you can tune your filter performance in FDATool, and repeatedly export the modified filter to your target to test its new capability. Using FDATool with the Developer’s Kit takes your filter design capabilities to a new level of flexibility and efficiency.
Unified CCS IDE and C6701 EVM Targeting
In Version 1.1, the separate CCS target has been eliminated. To target CCS
IDE is the same as targeting the C6701 EVM, without compiling, linking, or writing the program to the target. Removing the separate target results in cleaner processing using a common code path. As a result of unifying the targets, the Simulation Parameters dialog contains a new option on the
Real-Time Workshop page.
Instead of selecting the CCS target file ccs.tlc
for the Target Configuration to target CCS, you select Create_CCS_Project for the Build Action under the
Category: TI C6701EVM runtime. When you click Make Project, the
Developer’s Kit uses Real-Time Workshop to create ANSI C code from your model and uses the code to populate a new project in CCS IDE.
Note Models that you built in Version 1.0 of the Developer’s Kit use the ccs.tlc
target TLC file. In Version 1.1, that file is no longer on the list of available targets in Real-Time Workshop. When you try to build models you developed in Version 1.0 in Version 1.1, you get an error that Real-Time
Workshop cannot find the file ccs.tlc
. To correct the error, browse for the ti_c6701evm.tlc
target file to replace the missing file. Then rebuild your target.
12-5
12
Developer’s Kit for Texas Instruments™ DSP 1.1 Release Notes
New Run-Time Libraries
To reduce the size of the generated .out
files when you build models for targeting, and to improve the efficiency of the resulting file, the Developer’s Kit now uses run-time libraries to include many block functions in the .out
file.
When your model uses one of a number of DSP blocks, the .out
file generated by the compile uses the .obj
file for the block from the run-time library that is appropriate for the target. In Version 1.0. the .out
file included all versions of the block algorithm, rather than just the one required for the specified target.
For example, now when you use the FFT block in a model targeted to a 16-bit processor, only the 16-bit FFT code appears in the .out
file, instead of all 48 variants of FFT.
One side effect of this architectural change shows up in the Simulink simulation parameters. When you build a model with the default settings, compiling the model operates as before. If you change one or more of the parameters from the default setting, such as switching to little-endian from big-endian, the compile time can grow somewhat. Compiling a model with simulation parameter settings that are not the defaults can raise the compile time to as much as ten minutes or more for complex models.
Architecture Change in CCSDSP Object
To more easily support future target development and to speed up the processing associated with ccsdsp objects (created when you use the function ccsdsp ), the ccsdsp object does not include user-accessible ActiveX handles, such as dspuser . Removing the handles reduces the risks associated with using handles and the housekeeping required in managing your handles to ensure that handles do not cause problems if they are left unattended.
To use the handles as they existed in the earlier product release, for example to perform additional ActiveX/COM interactions with CCS IDE, you can regenerate the handles. The following MATLAB script recreates the handles for a specified board and processor.
% h = structure that will hold the CCS/RTDX handles boardnum = 0 % Supplied desired board number procnum = 0 % and processor number
% Create activeX handles to Code Composer h.app = actxserver('CodeComposer.Application'); h.dspboards = get(h.app,'DspBoards');
12-6
New Features h.dspboard = invoke(h.dspboards,'Item',boardnum); h.dsptasks = get(h.dspboard,'DspTasks'); h.dsptask = invoke(h.dsptasks,'Item',procnum); invoke(h.dsptask,'OpenDebugControlWindow'); h.dspuser = invoke(h.dsptask,'createdspuser');
Updated Function writemsg Help Text
The new, faster code in MATLAB Release 12.1 exposes an explicit timeout feature that was not included in Release 12.0. Refer to the Help browser entry for writemsg for details.
12-7
12
Developer’s Kit for Texas Instruments™ DSP 1.1 Release Notes
Major Bug Fixes
The following problems identified in Version 1.0 have been fixed in this release:
• Your C6701 EVM no longer has to be the first board in your computer. In
Version 1.0, your evaluation module had to be board 0, with its processor as processor 0. In this release, you can install your C6701 EVM in any position, and identify it specifically when you use it as your target. Use the Real-Time
Workshop page of the Simulation Parameters dialog to specify the target board.
• You do not need to close CCS IDE when you target your C6701 EVM.
• Resetting your board and closing CCS IDE are not required when you switch between targeting and linking or linking and targeting operations.
12-8
Upgrading from an Earlier Release
Upgrading from an Earlier Release
Version 1.1 of the Toolbox incorporates significant changes to the targeting options, the CCSDSP object, and the way Simulink blocks are generated.
New Libraries at Run-Time
The Developer’s Kit now uses run-time libraries to include many block functions in the .out
file. Refer to “New Run-Time Libraries” on page 12-6 for
more information about how this change affects your existing models.
CCSDSP Changes
To support future development, ccsdsp objects no longer use ActiveX handles
Unified Targeting
With the Version 1.1 release, the separate CCS target is no longer available.
Models developed with the 1.0 release generate an error when you try to build them in Version 1.1. For information about resolving the RTW error when you
build, refer to “Unified CCS IDE and C6701 EVM Targeting” on page 12-5.
12-9
12
Developer’s Kit for Texas Instruments™ DSP 1.1 Release Notes
Known Software and Documentation Problems
This section updates the Developer’s Kit for Texas Instruments DSP 1.1 documentation, presenting the known problems with the software and documentation. Each entry in the following sections describes a situation you may encounter when you use the Developer’s Kit.
Operating Systems
Windows 98
When you create a link to Texas Instruments Code Composer Studio (CCS) immediately after you reboot your Microsoft Windows 98 machine, it may take a very long time to create the link. To avoid the wait, launch CCS from your desktop before you create the link.
Unsupported Platforms
The Developer’s Kit, Version 1.1, is not supported on Microsoft Windows 2000 or Code Composer Studio 2.0.
Linking
• Having CCS visible on your desktop during CCS read or write operations slows down the data transfer process. Generally, transfer rates fall by a factor of four when CCS IDE is visible. When you do not need to interact with
CCS IDE, use visible to force CCS to the background to avoid the slowdown.
cc = ccsdsp; cc.visible(0); % Pushes CCS IDE to the background.
If your work requires that you interact with CCS IDE during linking operations, place CCS IDE in the background temporarily when your program transfers large amounts of data either direction. For example, the following code demonstrates changing the CCS IDE visibility state before and after large read and write operations.
12-10
Known Software and Documentation Problems cc = ccsdsp:
.
.
.
% Interact with CCS IDE.
.
vstate = cc.isvisible; % Store visibility state for CCS.
cc.visible(0); % Force CCS to the background.
x = cc.read('FF00','int32',[20 20],20); % Large read transfer.
.
.
cc.write('FF00',int32(randn(20)),20); % Large write transfer.
cc.visible(vstate); % Return CCS to its previous visibility state.
.
. % Continue to interact with CCS IDE.
• CCS limits memory read and write data transfers to 32 KB. This restriction does not affect RTDX.
• Before you use the links, run the GEL initialization that is appropriate for your target processor. For RTDX communications to work properly on the
C5402 DSK, you must initialize the board. To initialize your DSK, select
C54x submenu --> C5402_DSK_Init from the GEL option on the CCS menu bar.
To automate this process as part of GEL reset, edit C5000.gel
as follows: a In the .gel
file, locate the section beginning hotmenu C5402_DSK_Init .
b In the section, highlight and copy all instructions between the braces,
{ } . c Paste your copied text into the startup function at the beginning of the
.
gel file.
Subsequent GEL resets will run the DSK initialization.
• During memory transfer operations, you may receive a timeout error telling you that the time allowed for the operation expired. In most cases, the transfer has been successful in spite of the error message. Once the transfer operation starts, it cannot be stopped or changed. Time may expire if the transfer completes but the completion message is delayed. Try setting the timeout value to a large number of seconds to avoid the error message.
12-11
12
Developer’s Kit for Texas Instruments™ DSP 1.1 Release Notes
• When you configure your target code to perform RTDX write operations
(write data from the target to the host) on the C5402 DSK, you must poll the
‘successful emptying of the write buffer’ status. The C6000, which allows polling or host-initiated interrupts, does not require polling.
The following code provides an example of the polling syntax, where ochan is the write channel. write(&ochan, &data, sizeof(data)); while ( RTDX_writing != NULL ) {
#if RTDX_POLLING_IMPLEMENTATION
RTDX_Poll();
#endif
}
• On some occasions, CCS opens information dialogs in the background. You must respond to the dialogs before you can continue to work in MATLAB or
CCS. Until you respond to the dialogs, MATLAB will not respond to input.
Targeting
• For reasons related to the Texas Instruments C compiler, you cannot use three blocks in your Simulink model for targeting. They are:
- Singular Value Decomposition block in the library dspfactors
- Pseudoinverse block in the library dspinverses
- SVD Solver block in the library dspsolvers
These blocks are not included in the run-time libraries and do not build when you build your model.
• CCS cannot open some header files (files with the
.h
extension) when you use the Developer’s Kit to build a project in CCS IDE. When you try to view the header files in CCS, you get an error “ filename.h was not found ,” telling you that CCS could not find the files. Although CCS reports the error, the header files are being used in the compile and build process. To make CCS
IDE aware of the files, perform the following steps to update the include file paths in your CCS project.
1 Locate the file modelname.bld
, where modelname is the name of your
Simulink model.
12-12
Known Software and Documentation Problems
2 Open modelname.bld
for editing in MATLAB.
3 Within modelname .
bld , find the section /* add include paths*/ .
4 Highlight and copy the paths listed in the section. You are going to use these paths to update the path definition for your project in CCS IDE.
5 Switch to CCS IDE.
6 Select Project->Options from the menubar. Click Compiler on the Build
Options dialog to see the dialog shown here.
Include path area
12-13
12
Developer’s Kit for Texas Instruments™ DSP 1.1 Release Notes
7 In the Include path area marked in the figure, append the text you copied from modelname.bld
to the end of the existing path. Do not overwrite the existing path entries.
8 Click OK to close the Build Options dialog.
9 Select Project->Scan All Dependencies... from the CCS IDE menubar.
CCS IDE scans the new include paths and updates the file information. Now you can view all of the header files in the Include directory in CCS IDE.
Note After you update the search path, save the project as a CCS workspace with the .wks
extension by selecting File->Workspace->Save workspace… from the CCS menubar if you plan to rebuild your model or project. If you do not save your project, when you build again with this model you lose the updated file path information.
Demos
In MATLAB Demos, the link for the RTDX demonstration program named
LMS Adaptive Filtering runs slowly on DSP Starter Kit (DSK) boards. Design features of the board cause the slow processing. Using the Texas Instruments
XDS 510 JTAG/PC Controller, or an equivalent emulator, to connect your host to the DSK can alleviate the problem.
Datatypes
C5000 and C6000 family processors handle integer datatypes differently. On
C5000 family processors, 8-bit values do not have unique addresses. The C5000 family processors use 16-bit addresses natively. When you read and write to
C5000 family processors, 8-bit integers in MATLAB are stored as 16-bit integers on the processor. In detail, the differences are:
• When you write an 8-bit integer from MATLAB to a C5000 family processor,
MATLAB pads the value to 16 bits and the processor stores the value as a
16-bit integer.
12-14
Known Software and Documentation Problems
• When you read an 8-bit integer from the processor into MATLAB, the read function takes 16 bits from processor memory, discards the eight most significant bits, and returns the remaining eight bits to MATLAB as the integer value.
For these reasons, scripts that run on C6000 family processors may not run without modification on C5000 family processors.
General Target Operations
When your target digital signal processor is running, CCS uses up to 99% of the
CPU cycles on your PC. Consequently, some other operations may be very slow, such as running the MATLAB help system or processing other applications.
Documentation
The Help browser does not provide online documentation for the following functions:
• add
• delete
• insert
• isrtdxcapable
• remove
Access help information by entering helpwin ccsdsp/functionname at the MATLAB prompt. For example, for information about insert, type helpwin ccsdsp/insert
12-15
12
Developer’s Kit for Texas Instruments™ DSP 1.1 Release Notes
12-16
DSP Blockset 4.1 Release
Notes
New Features . . . . . . . . . . . . . . . . . . . 13-2
New Digital Filter Design Block . . . . . . . . . . . . 13-2
Major Individual Block Enhancements . . . . . . . . . . 13-3
Blocks with Enhanced Data Type Support . . . . . . . . 13-5
Blocks with Tunability Enhancements . . . . . . . . . . 13-7
Enhancements to Blocks Implemented with S-Functions . . 13-7
Real-Time Workshop Generated C Code Enhancements . . . 13-8
Changes to Filtering Block Libraries . . . . . . . . . . . 13-9
New and Renamed DSP Blockset Directories . . . . . . 13-10
Major Bug Fixes . . . . . . . . . . . . . . . . . 13-11
Real-Time Workshop C Code Generated from DSP Blockset 13-11
Nontunable Block Parameters . . . . . . . . . . . . 13-11
Chirp Block . . . . . . . . . . . . . . . . . . . . 13-11
Matrix Viewer Block . . . . . . . . . . . . . . . . 13-11
Random Source Block . . . . . . . . . . . . . . . . 13-12
Stack and Queue Blocks . . . . . . . . . . . . . . . 13-12
Window Function Block . . . . . . . . . . . . . . . 13-12
Platform Limitations for HP and IBM . . . . . . . 13-13
Upgrading from an Earlier Release . . . . . . . . 13-14
Known Software Problems . . . . . . . . . . . . 13-15
Real-Time Workshop C Code Generation Limitations . . . 13-15
Nonzero Simulation Start Times Not Supported . . . . . 13-15
Triggered and Enabled Subsystem Support . . . . . . . 13-16
Digital Filter Design Block Limitations . . . . . . . . 13-16
Magnitude FFT Block Limitations . . . . . . . . . . . 13-17
13
13
DSP Blockset 4.1 Release Notes
New Features
This section introduces the new features and enhancements added in the DSP
Blockset 4.1 (Release 12.1) since DSP Blockset 4.0 (Release 12.0).
For information about the DSP Blockset features incorporated in recent releases, see the following documents:
• Release Notes for Release 12
• DSP Blockset
Readme.m
file — Open by typing whatsnew dspblks or info dspblks at the MATLAB command line.
The DSP Blockset 4.1 new features are discussed in detail in the following sections:
• “New Digital Filter Design Block” on page 13-2
• “Major Individual Block Enhancements” on page 13-3
• “Blocks with Enhanced Data Type Support” on page 13-5
• “Blocks with Tunability Enhancements” on page 13-7
• “Enhancements to Blocks Implemented with S-Functions” on page 13-7
• “Real-Time Workshop Generated C Code Enhancements” on page 13-8
• “Changes to Filtering Block Libraries” on page 13-9
• “New and Renamed DSP Blockset Directories” on page 13-10
New Digital Filter Design Block
The new Digital Filter Design block integrates the Filter Design and Analysis
Tool graphical user interface (FDATool) with the DSP Blockset.
Double-clicking the block opens FDATool, which you can use to quickly design, import, or directly specify a digital FIR or IIR filter. Using the specified filter, the block filters the input signal and outputs the result.
Currently, the Digital Filter Design block only supports direct-form II transposed filter structures, so the block converts the structures of all imported filters to direct-form II transposed. In addition, the block does not support the
Set Quantization Parameters tab, which is usually available in FDATool when you install the Filter Design Toolbox.
13-2
New Features
The Digital Filter Design block replaces many of the blocks from DSP Blockset
4.0 (Release 12). For details, see “Changes to Filtering Block Libraries” on page 13-9.
Major Individual Block Enhancements
The following sections summarize the major individual block enhancements for
DSP Blockset 4.1:
• “Overlap-Add FFT Filter and Overlap-Save FFT Filter Blocks”
FFT Block
• You can now set the block to compute twiddle factors by table lookup or by calling trigonometric math library functions. In table lookup mode, the block precomputes and stores a table that you can optimize for memory or speed.
For an N-point FFT, a table optimized for speed yields a length-3N/4 table, and a table optimized for memory yields a length-N/4 table.
• A new option lets you set the block to output in bit-reversed or linear order.
Outputting in bit-reversed order reduces computation time by eliminating the output data descrambling step.
• The block processes real-valued inputs using more efficient algorithms.
• The block generates smaller Real-Time Workshop C code with improved run-time efficiency through use of in-place algorithms.
• The block now supports single-precision (32-bit) floating-point input and output signals (in table lookup mode) for both simulation and Real-Time
Workshop C code generation.
For more information, see the FFT block reference page.
13-3
13
DSP Blockset 4.1 Release Notes
IFFT Block
• You can now set the block's twiddle factor computation method as in the FFT
block (see the earlier FFT block enhancement description).
• A new option lets you provide inputs in both linear and bit-reversed order.
Using inputs in bit-reversed order reduces block computation time by eliminating the initial input data scrambling step.
• You can now explicitly specify conjugate-symmetric input signals to significantly increase processing efficiency and to get a real-valued output signal.
• You can now skip normalization by the IFFT length, N, when you do not need to output a normalized signal, increasing processing efficiency.
• The block generates smaller Real-Time Workshop C code with improved run-time efficiency through use of in-place algorithms.
• The block now supports single-precision (32-bit) floating-point input and output signals (in table lookup mode) for both simulation and Real-Time
Workshop C code generation.
For more information, see the IFFT block reference page.
Magnitude FFT Block
• You can now set the block to compute the magnitude FFT or magnitude squared FFT
• The block uses the new, more efficient FFT block algorithms.
For more information, see the Magnitude FFT block reference page.
Overlap-Add FFT Filter and Overlap-Save FFT Filter Blocks
By using the enhanced FFT and IFFT blocks, the Overlap-Add FFT Filter and
Overlap-Save FFT Filter blocks are more efficient. (Both blocks now skip data descrambling and scrambling operations by processing data in bit-reversed order, and use specialized, more efficient algorithms for real-valued input signals.)
13-4
New Features
Random Source Block
• You can now set the repeatability of the block output to Not repeatable,
Repeatable , or Specify seed. The default mode is Not repeatable, so that when you add new Random Source blocks from the block library to a model, the blocks automatically generate different outputs (without requiring you to specify a seed).
• The block now uses Simulink run-time parameters, greatly enhancing its
Real-Time Workshop generated C code (see “Enhancements to Blocks
Implemented with S-Functions” on page 13-7).
Sine Wave Block
You can now optimize the Sine Wave block’s table lookup computation method for speed or memory. For speed optimization, the block uses a full-length table, while for memory optimization, it uses a 1/4-length table.
Unwrap Block
You can now set the Unwrap block to phase unwrap across successive inputs for both frame-based and sample-based input signals.
Window Function Block
• The Window Function block now generates smaller, more efficient Real-Time
Workshop C code by using run-time parameters (see “Enhancements to
Blocks Implemented with S-Functions” on page 13-7).
• The block now supports single-precision (32-bit) floating-point input and output signals.
Blocks with Enhanced Data Type Support
All DSP Blockset 4.1 blocks support the double data type in both simulation and in Real-Time Workshop C code generation. Many blocks now support all
Simulink built-in data types, as well as the fixed-point data type and properly defined Simulink custom data types in both simulation and in Real-Time
Workshop C code generation. To see which data types a particular block supports, check the “Supported Data Types” section of its reference page.
13-5
13
DSP Blockset 4.1 Release Notes
The data signal input and output ports (noncontrol input and output ports) of the following blocks now support all built-in, fixed-point, and other properly defined Simulink custom data types:
• Buffer
• Check Signal Attributes
• Contiguous Copy
• Convert 1-D to 2-D
• Convert 2-D to 1-D
• Delay Line
• Display
• Downsample
• Extract Diagonal
• Extract Triangular Matrix
• Flip
• Frame Status Conversion
• Inherit Complexity
• Integer Delay
• Matrix Viewer
• Multiport Selector
• Pad
• Permute Matrix (also, index input port accepts signed and unsigned integer and double- and single-precision floating-point)
• Repeat
• Sample and Hold
• Signal To Workspace
• Spectrum Scope
• Submatrix
• Time Scope
• Toeplitz
• Transpose
• Triggered Delay line
• Triggered To Workspace
• Unbuffer
• Upsample
• Variable Integer Delay
• Variable Selector (also, index input port accepts signed and unsigned integer and double- and single-precision floating-point)
• Vector Scope
• Zero Pad
The data signal input and output ports (noncontrol input and output ports) of the following blocks now support all Simulink built-in data types:
• Constant Diagonal Matrix
• DSP Constant
• Signal From Workspace
• Triggered Signal From Workspace
13-6
New Features
The data signal input and output ports (noncontrol input and output ports) of the following blocks now support the single-precision (32-bit) floating-point data type:
• dB Gain
• Discrete Impulse
• FFT (in table lookup mode)
• IFFT (in table lookup mode)
• Matrix Multiply
• Matrix Sum
• Maximum
• Polynomial Stability Test
• Quantizer
• Uniform Decoder
• Uniform Encoder
• Window Function
Blocks with Tunability Enhancements
The following blocks have enhanced tunability:
• Chirp — Target time parameter is now tunable.
• Counter — Maximum count parameter is now tunable.
• Mean — Reset port parameter is now tunable.
• Pad — Value parameter is now tunable.
Enhancements to Blocks Implemented with
S-Functions
Many of the DSP Blockset blocks are S-function blocks (implemented with
Simulink S-functions). The following sections summarize some of the major
DSP Blockset 4.1 enhancements that improve S-function block performance and help you to write better S-functions.
Use of Simulink Run-Time Parameters
Many S-function blocks now generate better optimized Real-Time Workshop
C code by using Simulink run-time parameters (RTPs) for both mask dialog and internal parameters. Blocks that use RTPs include those with filter coefficient parameters and initial condition parameters.
13-7
13
DSP Blockset 4.1 Release Notes
Better Memory Management for Simulation and Code Generation
Memory management enhancements for S-function block simulation and code generation now provide simulation code requiring less memory, and smaller
Real-Time Workshop generated C code that is more efficient at run-time.
Memory management enhancements include the use of contiguous input and output arrays, reusable inputs, overwritable arrays, and in-place algorithms.
New S-Function Simulation Support Directories
Various extensible C-callable library functions, macros, and definitions are now included in the following directories:
• toolbox/dspblks/include — header files (prototypes and definitions)
• toolbox/dspblks/src/sim — simulation library source code
• toolbox/dspblks/lib — prebuilt library ( .lib
) files for certain combinations of platforms and compilers only
Real-Time Workshop Generated C Code
Enhancements
DSP Blockset 4.1 enhancements that provide better Real-Time Workshop generated C code include the following:
• DSP Blockset can now build and link C-callable run-time libraries, providing for smaller, more efficient Real-Time Workshop generated C code.
• The use of run-time parameters in blocks implemented with S-functions (see
“Enhancements to Blocks Implemented with S-Functions” on page 13-7)
provides for the following Real-Time Workshop generated C code enhancements for blocks implemented using S-functions:
- Parameter values are organized in a common structure.
- Parameter values are located in a common header file (for example,
<model>_prm.h
).
- Redundant copies of parameter values are reused or “pooled” in
<model>_prm.h
(when there are multiple instances of a block with the same run-time parameter values).
13-8
New Features
Changes to Filtering Block Libraries
This section describes the changes to the contents and names of the DSP
Blockset filtering block libraries.
Replaced Filtering Block Libraries
The new Filter Designs block library in DSP Blockset 4.1 replaces the old
Filter Structures and Filter Designs block libraries in DSP Blockset 4.0, and contains the following blocks:
• Analog Filter Design
• Biquadratic Filter
• Digital Filter Design
• Direct-Form II Transpose Filter
• Filter Realization Wizard
• Overlap-Add FFT Filter
• Overlap-Save FFT Filter
• Time-Varying Lattice Filter
• Time-Varying Direct-Form II Transpose Filter
Replaced Filtering Blocks
The new Digital Filter Design block in the Filter Designs block library (see
“New Digital Filter Design Block” on page 13-2) replaces the following DSP
Blockset 4.0 blocks:
• Digital FIR Filter Design
• Digital FIR Raised Cosine Filter Design
• Digital IIR Filter Design
• Least Squares FIR Filter Design
• Remez FIR Filter Design
You can still access these blocks by typing dspddes3 at the MATLAB command line, but they are no longer in the DSP Blockset Filter Designs block library.
13-9
13
DSP Blockset 4.1 Release Notes
New and Renamed DSP Blockset Directories
New and renamed DSP Blockset 4.1 product directories and their contents are summarized in the following table. (The directories in the table are all in the toolbox/dspblks directory.)
Directory Name include lib src/rt src/sim src/v2 src/v3 src/v4
Directory Contents
DSP Blockset simulation and run-time support function prototypes, macros, definitions, etc.
Prebuilt DSP Blockset simulation and run-time support libraries
DSP Blockset run-time support library source code
DSP Blockset S-function simulation support library source code
Selected DSP Blockset Version 1.x and Version
2.x S-function source code
Selected DSP Blockset Version 3.x S-function source code
Selected DSP Blockset Version 4.x S-function source code
13-10
Major Bug Fixes
Major Bug Fixes
The following sections describe some of the major DSP Blockset 4.1 bug fixes:
• “Real-Time Workshop C Code Generated from DSP Blockset”
• “Nontunable Block Parameters”
Real-Time Workshop C Code Generated from DSP
Blockset
• Real-Time Workshop C code generated from the blockset now uses the sizeof function rather than hard-coding word sizes for nonstandard code generation targets (such as those that do not treat characters as 8-bit bytes).
• The generated C code for most blocks no longer generates compiler warnings for most supported targets.
Nontunable Block Parameters
All nontunable block parameters are now uneditable in the Simulink mask UI during simulations.
Chirp Block
The Chirp block now has correct behavior in bidirectional sweep mode, and correctly interprets target frequency and sweep time parameters.
Matrix Viewer Block
The Matrix Viewer block now displays the color bar.
13-11
13
DSP Blockset 4.1 Release Notes
Random Source Block
The Random Source block seed initialization better supports multiple copies of the block in one Simulink model.
Also, the block no longer sets the seed of the MATLAB random number generator function during block initialization.
Stack and Queue Blocks
The Stack and Queue blocks now correctly handle simultaneously triggered control ports (such as the Push and Pop ports).
Window Function Block
The Window Function block now errors out for non-floating-point inputs to avoid possible segmentation violations.
13-12
Platform Limitations for HP and IBM
Platform Limitations for HP and IBM
On the HP and IBM platforms, the DSP Blockset has the same simulation
limitations as Simulink, and the same code generation limitations as
13-13
13
DSP Blockset 4.1 Release Notes
Upgrading from an Earlier Release
There are no issues for upgrading from DSP Blockset 4.0 (Release 12) to
DSP Blockset 4.1 (Release 12.1).
For information about upgrading from an earlier version than
DSP Blockset 4.0, see the Release Notes for Release 12.
13-14
Known Software Problems
Known Software Problems
The following sections describe some of the known DSP Blockset problems and limitations:
• “Real-Time Workshop C Code Generation Limitations”
• “Nonzero Simulation Start Times Not Supported”
• “Triggered and Enabled Subsystem Support”
• “Digital Filter Design Block Limitations”
• “Magnitude FFT Block Limitations”
Real-Time Workshop C Code Generation Limitations
C code generated from DSP Blockset blocks using Real-Time Workshop has the following limitations:
• DSP Blockset generally does not support the Loop rolling threshold parameter (visible when the Category parameter is set to General code generation options ) in the Real-Time Workshop tab of the Simulink
Simulation Parameter s dialog.
• Currently, the DSP Blockset run-time library dsp_rt.lib
does not always rebuild when you change compiler or linker options. Thus, before changing compiler and linker options, you should delete dsp_rt.lib
and all associated object files. You can change compiler and linker options in the Simulink
Simulation Parameters dialog’s Real-Time Workshop tab by setting make command arguments such as OPTS or OPT_OPTS in the Make command parameter (for example, make_rtw OPTS="-DMYDEFINE=1" ).
Nonzero Simulation Start Times Not Supported
The DSP Blockset does not support nonzero simulation start times. When running a simulation with DSP Blockset blocks, you must set the Start time option in the Simulink Simulation Parameters dialog’s Solver tab to 0 .
13-15
13
DSP Blockset 4.1 Release Notes
Triggered and Enabled Subsystem Support
Triggered or enabled subsystems currently do not support the following blocks:
• Buffer
• Counter
• Downsample
• Dyadic Analysis Filter
Bank
• Dyadic Synthesis Filter
Bank
• FIR Decimation
• FIR Interpolation
• Histogram
• Kalman Adaptive Filter
• LMS Adaptive Filter
• LU Solver
• Maximum
• Mean
• Minimum
• N-Sample Enable
• N-Sample Switch
• Overlap-Add FFT Filter
• Overlap-Save FFT Filter
• Permute Matrix
• Queue
• Repeat
• RLS Adaptive Filter
• RMS
• Stack
• Standard Deviation
• Time-Varying Direct-Form II Transpose Filter
• Time-Varying Lattice Filter
• Unbuffer
• Upsample
• Variable Fractional Delay
• Variable Integer Delay
• Variable Selector
• Variance
• Wavelet Analysis
• Wavelet Synthesis
Digital Filter Design Block Limitations
The Digital Filter Design block has the following limitations:
• The Filter Design and Analysis Tool graphical user interface (FDATool), opened from the Digital Filter Design block, currently only supports direct-form II transposed filter structures. Thus, the Digital Filter Design block’s FDATool converts the structures of all imported filters to direct-form
II transposed.
13-16
Known Software Problems
• When you install the Filter Design Toolbox, FDATool, opened from the
MATLAB command line, gets a new tab, Set Quantization Parameters.
However, the Digital Filter Design block’s FDATool does not currently support the Set Quantization Parameters tab.
• The Digital Filter Design block currently allows you to edit nontunable
FDATool filter specification parameters. When you edit nontunable parameters during a simulation, the filter still updates in FDATool to reflect your changes. However, during simulation, FDATool only updates the block icon (which displays the frequency response of the updated filter). FDATool sends the new filter coefficients to the block only after the simulation stops running.
For details about the Digital Filter Design block, see the previous section, “New
Digital Filter Design Block” on page 13-2.
Magnitude FFT Block Limitations
The Magnitude FFT block currently does not support 2-D sample-based 1-by-N row vector inputs.
13-17
13
DSP Blockset 4.1 Release Notes
13-18
Excel Link 1.1.3 Release
Notes
New Features . . . . . . . . . . . . . . . . . . . 14-2
License Manager Control . . . . . . . . . . . . . . . 14-2
Additional Error Detection . . . . . . . . . . . . . . . 14-2
Known Software Problems . . . . . . . . . . . . . 14-3
Enabling the MATLAB Desktop . . . . . . . . . . . . 14-3
14
14
Excel Link 1.1.3 Release Notes
New Features
This section introduces the new features and enhancements added to Excel
Link 1.1.3.
License Manager Control
As with other MATLAB-related products, Excel Link installation is now under control of the FLEXlm license manager. Implementation of license manager control has necessitated a change in the directory location of several files created during the installation process.
Note The notation <matlab> represents the MATLAB root directory, the directory where MATLAB is installed on your system.
File excllink.xla
ExliSamp.xls
Purpose
Excel Link add-in
Excel Link samples
Previous Location
<matlab>\exlink
<matlab>\exlink
New Location
<matlab>/toolbox/exlink
<matlab>/toolbox/exlink
Additional Error Detection
Excel Link now produces a cell error message if your matrix exceeds the Excel limit of 256 columns or 65536 rows.
14-2
Known Software Problems
Known Software Problems
Enabling the MATLAB Desktop
Excel Link uses MATLAB as an ActiveX automation server. Consequently, when started from Excel Link, MATLAB comes up minimized with the
MATLAB desktop disabled.
To enable the MATLAB desktop, you can execute the MATLAB command desktop directly in the command window or execute it indirectly using the
Excel Link function MLEvalString .
To enable the MATLAB desktop from Excel, type the following in any cell.
=mlevalstring("desktop")
14-3
14
Excel Link 1.1.3 Release Notes
14-4
Filter Design Toolbox 2.1
Release Notes
New Features . . . . . . . . . . . . . . . . . . . 15-2
New Adaptive Filtering Functions . . . . . . . . . . . . 15-2
New FIR Filter Design Functions . . . . . . . . . . . . 15-3
New Filter Transformation Functions . . . . . . . . . . 15-3
Transformations Option in FDATool . . . . . . . . . . . 15-4
New Analysis Method . . . . . . . . . . . . . . . . . 15-4
New Context-Sensitive Help for Quantization . . . . . . . 15-5
Platform Limitations for HP 10.2 . . . . . . . . . . . 15-6
Upgrading from an Earlier Release . . . . . . . . . 15-7
Obsolete Functions in Version 2.0 . . . . . . . . . . . . 15-7
Known Software and Documentation Problems . . . . 15-8
Help for Filter Transformations in FDATool . . . . . . . 15-8
15
15
Filter Design Toolbox 2.1 Release Notes
15-2
New Features
This section introduces the new features and enhancements added in the Filter
Design Toolbox 2.1 since Filter Design Toolbox 2.0 (Release 12).
For information about Filter Design Toolbox features that are incorporated from recent releases, see the Release Notes for Release 12.
New Adaptive Filtering Functions
The Filter Design Toolbox 2.1 includes these new filter design functions:
• adaptkalman — Use a Kalman filtering algorithm in an adaptive filter role
• adaptlms – Use an LMS-based adaptive algorithm in an adaptive filter role
• adaptnlms – Use a normalized LMS-based adaptive algorithm in an adaptive filter role
• adaptrls – Use an RLS-based adaptive algorithm in an adaptive filter role
• adaptsd – Use the sign-data variant of the LMS-based adaptive algorithm in an adaptive filter role
• adaptse – Use the sign-error variant of the LMS-based adaptive algorithm in an adaptive filter role
• adaptss — Use the sign-sign variant of the LMS-based adaptive algorithm in an adaptive filter role
To support you when you use these new functions, the Toolbox includes corresponding functions for initializing the associated adaptive filter algorithm.
• initkalman — Initialize the input argument s for the Kalman-based algorithm adaptive filter function
• initlms — Initialize the input argument s for the LMS-based adaptive filter function
• initnlms — Initialize the input argument s for the normalized LMS-based adaptive filter function
• initrls — Initialize the input argument s for the RLS-based adaptive filter function
• initsd — Initialize the input argument s for the sign-data variant of the
LMS-based adaptive filter function
New Features
• initse — Prepare the input arguments for the sign-error variant of the
LMS-based adaptive filter function
• initss — Prepare the input arguments for the sign-sign variant of the
LMS-based adaptive filter function
New FIR Filter Design Functions
In addition to the new adaptive filtering capabilities, this version of the toolbox has four new filter design functions.
• firhalfband — Design Lth-band filters where L=2. About half of the filter coefficients are zero so the filters are very efficient to calculate
• firminphase — Calculate the minimum-phase FIR spectral factor of a linear-phase FIR filter
• firnyquist — Design lowpass filters with certain specified coefficients in the transfer functions set to zero by design
• ifir — Design an interpolated FIR filter
FDATool includes Halfband and Nyquist entries under Filter Type so you can design and analyze these kinds of filters within FDATool.
New Filter Transformation Functions
The Filter Design Toolbox 2.1 includes several new filter transformation functions. Each transformation maintains the ripple characteristics and passband/stopband shapes of the source filter while transforming to the new specification.
• firlp2lp — Transforms lowpass FIR filters to lowpass FIR filters with different passband width or cutoff specifications
• firlp2hp — Transforms lowpass FIR filters to highpass FIR filters
• iirlp2bp — Transforms lowpass IIR filters to bandpass IIR filters
• iirlp2bs — Transforms lowpass IIR filters to bandstop IIR filters
• iirlp2hp — Transforms lowpass IIR filters to highpass IIR filters
• iirlp2lp — Transforms lowpass IIR filters to lowpass IIR filters
The new Transformations option (refer to the next entry in this section) in
FDATool provides access to these transformations from the GUI.
15-3
15
Filter Design Toolbox 2.1 Release Notes
Transformations Option in FDATool
When you use Filter Design and Analysis Tool (FDATool) with Filter Design
Toolbox 2.1, the Toolbox adds a new menu to the FDATool menu bar. Named
Transformations , the new selection provides direct access to the new FIR and
IIR filter transformation functions added to the Toolbox in this release (refer
to “New Filter Transformation Functions”). Transformations appears as
shown in this figure only when you have installed the Filter Design Toolbox.
With this new option, FIR and IIR filters whose characteristics are particularly valuable become the sources for other FIR and IIR filters that share the same desirable features in a different passband configuration. Transforming a filter saves you from repeating the filter design process. For more information, refer to Transforming Filters in your Filter Design Toolbox User’s Guide.
In the figure, the Targets option is available only when you have the
Developer’s Kit for Texas Instruments DSP installed.
New Analysis Method
Filter Design Toolbox 2.1 includes one new analysis method — zerophase — that returns the zero-phase response of a linear-phase FIR filter.
[hr,w] = zerophase(b) , and the other available syntax options for zerophase , returns the zero-phase response hr and the frequency vector w (in rad/sample) at which hr is computed, given a linear-phase FIR filter b . The zero-phase response is evaluated at 512 equally spaced points on the upper half of the unit circle.
Note that the zero-phase response is always real, but it is not equivalent to the magnitude response. In particular, the zero-phase response can be negative; the magnitude response is always positive.
15-4
New Features
New Context-Sensitive Help for Quantization
FDATool Quantization mode now includes context sensitive or What’s This? help. For each option on the Set Quantization Parameters page, right-click to use the What’s This? option to open a brief text description of the option.
15-5
15
Filter Design Toolbox 2.1 Release Notes
Platform Limitations for HP 10.2
Filter Design Toolbox 2.1 is not supported on the Hewlett-Packard 10.2 (HP
700) platform.
Note This is the same platform limitation that existed in the Filter Design
Toolbox 2.0 (Release 12.0).
15-6
Upgrading from an Earlier Release
Upgrading from an Earlier Release
There are no upgrade issues moving from the Filter Design Toolbox 2.1 from the Filter Design Toolbox 2.0.
Note The following upgrade information is the same as appeared in the
Release Notes for Release 12.
Obsolete Functions in Version 2.0
Filter Design Toolbox 2.0 makes obsolete the following functions that were part of Quantized Filter Design Toolbox:.
Obsolete Function propinfo qfiltlog qhelp
Suggested Replacement
Use help constructor/propertyname to get help about a function. Or use the Help browser.
Use qreport to get information about quantized filters, quantized FFTs, and quantizers.
Use help constructor/propertyname to get help about a function. Or use the Help browser.
15-7
15
Filter Design Toolbox 2.1 Release Notes
Known Software and Documentation Problems
This section updates the Filter Design Toolbox 2.1 documentation, reflecting known Filter Design Toolbox 2.1 software or documentation problems.
Switching Between Design and Quantization Modes in FDATool
After you scale a quantized filter, or convert a quantized filter to second-order sections, do not switch between quantized mode and filter design mode in
FDATool. Selecting and clearing the Turn quantization on option (to shift between the quantization and design modes) after you have scaled or converted a quantized filter can corrupt the coefficients for your reference filter and your quantized filter.
To recover your reference filter design and quantized filter design if they have been corrupted, either:
• Import the filter from your workspace again
• Use FDATool to repeat the filter design
Help for Filter Transformations in FDATool
Option Transformations in FDATool does not have What’s This? help available. Use helpwin functionname for information about the transformation functions or use the Help browser to search the online documentation.
15-8
Financial Time Series
Toolbox 1.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 16-2
New Functions . . . . . . . . . . . . . . . . . . . 16-2
Financial Time Series GUI . . . . . . . . . . . . . . . 16-2
Major Changes to Functions . . . . . . . . . . . . . 16-3
16
16
Financial Time Series Toolbox 1.1 Release Notes
New Features
Note The Financial Time Series Toolbox 1.1 was released in
Web-downloadable format prior to Release 12.1. Version 1.1 of this product includes some important updates to Version 1.0, as summarized below. The
Financial Time Series Toolbox 1.1 distributed on the Release 12.1 CD is the same as the version of the product distributed via the Web prior to Release
12.1.
New Functions
Function bar barh bar3 bar3h ftsgui ftsinfo log2
Purpose
Plot bar chart
Plot horizontal bar chart
Plot 3-D bar chart
Plot horizontal 3-D bar chart
Display financial time series graphical user interface main window
Display information about a financial time series object
Base 2 logarithm
Financial Time Series GUI
The new Financial Time Series GUI provides complete access to the full functionality of the Financial Time Series Toolbox.
16-2
Major Changes to Functions
Major Changes to Functions
Candle plots are now correctly filled or open depending upon price movements.
The Combine Axes and Zoom operations of chartfts have been enhanced.
16-3
16
Financial Time Series Toolbox 1.1 Release Notes
16-4
Fixed-Point Blockset 3.1
Release Notes
New Features . . . . . . . . . . . . . . . . . . . 17-2
New Libraries . . . . . . . . . . . . . . . . . . . . 17-2
New Blocks . . . . . . . . . . . . . . . . . . . . . 17-3
Renamed Blocks . . . . . . . . . . . . . . . . . . . 17-8
New Functions . . . . . . . . . . . . . . . . . . . 17-9
Data Type Support . . . . . . . . . . . . . . . . . 17-10
Changes to Functionality . . . . . . . . . . . . . . 17-10
Known Documentation Problem . . . . . . . . . . 17-11
Error in Printed Version of Documentation . . . . . . . 17-11
17
17
Fixed-Point Blockset 3.1 Release Notes
17-2
New Features
This section introduces the new features and enhancements added in the
Fixed-Point Blockset 3.1 (Release 12.1) since the Fixed-Point Blockset 3.0
(Release 12).
For information about Fixed-Point Blockset features that are incorporated from recent releases, see the Release Notes for Release 12.
This section is organized into these subsections
• “New Libraries” on page 17-2
• “Renamed Blocks” on page 17-8
• “New Functions” on page 17-9
• “Data Type Support” on page 17-10
• “Changes to Functionality” on page 17-10
New Libraries
The blocks in the Fixed-Point Blockset are now organized into twelve libraries:
• Bits
• Calculus
• Data Type
• Delays & Holds
• Edge Detect
• Filters
• Logic & Comparison
• LookUp
• Math
• Nonlinear
• Select
• Sources
To open the main Fixed-Point Blockset library, which contains the libraries listed above, type fixpt_lib_3p1 at the MATLAB prompt.
New Features
Compare To Zero
Cosine
Counter Free
Counter Limited
New Blocks
The Fixed-Point Blockset 3.1 includes the new blocks listed below.
Block Name
Accumulator
Library
Calculus
Accumulator Resettable Calculus
Accumulator Resettable
Limited
Bit Clear
Calculus
Bits
Bit Set
Compare To Constant
Bits
Logic &
Comparison
Logic &
Comparison
LookUp
Sources
Sources
Data Type Duplicate
Dead Zone Dynamic
Decrement Real World
Data Type
Nonlinear
Math
Description
Compute a cumulative sum.
Compute a cumulative sum with external
Boolean reset.
Compute a limited cumulative sum with external Boolean reset.
Set the specified bit of the stored integer to zero.
Set the specified bit of the stored integer to one.
Determine if a signal is equal to the specified constant.
Determine if a signal is equal to zero.
Implement a sine wave in fixed-point using a lookup table approach that exploits quarter wave symmetry.
Count up and overflow back to zero after the maximum value possible is reached for the specified number of bits.
Count up, and wrap back to zero after outputting the specified upper limit.
Set all inputs to the same data type.
Set the input within the bounds to zero.
Decrease the real world value of the signal by one
17-3
17
Fixed-Point Blockset 3.1 Release Notes
17-4
Block Name
Decrement Stored
Integer
Decrement Time To
Zero
Decrement To Zero
Derivative
Detect Change
Detect Decrease
Detect Fall Negative
Detect Fall Nonpositive Edge Detect
Detect Increase
Detect Rise
Nonnegative
Detect Rise Positive
Difference
Filter Direct Form I
Filter Direct Form I
Time Varying
Library
Math
Math
Math
Calculus
Edge Detect
Edge Detect
Edge Detect
Edge Detect
Edge Detect
Edge Detect
Calculus
Filters
Filters
Description
Decrease the stored value of a signal by one
Decrease the real world value of the signal by the sample time, but only to zero.
Decrease the real world value of a signal by one, but only to zero.
Compute a discrete time derivative.
Detect a change in a signal’s value.
Detect a decrease in a signal’s value.
Detect a falling edge when the signal’s value decreases to a strictly negative value, and its previous value was nonnegative.
Detect a falling edge when the signal’s value decreases to a nonpositive value, and its previous value was strictly positive.
Detect an increase in a signal’s value.
Detect a rising edge when a signal’s value increases to a nonnegative value, and its previous value was strictly negative.
Detect a rising edge when a signal’s value increases to a strictly positive value, and its previous value was nonpositive.
Calculate the change in a signal over one time step.
Implement a Direct Form I realization of a filter.
Implement a time varying Direct Form I realization of a filter.
New Features
Block Name
Filter Direct Form II
Filter Direct Form II
Time Varying
Filter First Order
Filter Lead or Lag
Filter Real Zero
Increment Real World
Increment Stored
Integer
Integrator Backward
Integrator Backward
Resettable
Integrator Backward
Resettable Limited
Library
Filters
Filters
Filters
Filters
Filters
Math
Math
Calculus
Calculus
Calculus
Integrator Forward
Integrator Forward
Resettable
Integrator Forward
Resettable Limited
Calculus
Calculus
Calculus
Description
Implement a Direct Form II realization of a filter.
Implement a time varying Direct Form II realization of a filter.
Implement a discrete-time first order filter.
Implement a discrete-time lead or lag filter.
Implement a discrete time filter that has a real zero and no pole.
Increase the real world value of the signal by one.
Increase the stored integer value of a signal by one.
Perform discrete-time integration of a signal using the backward method.
Perform discrete-time integration of a signal using the backward method, with external
Boolean reset.
Perform discrete-time limited integration of a signal using the backward method, with external Boolean reset.
Perform discrete-time integration of a signal using the forward method.
Perform discrete-time integration of a signal using the forward method, with external
Boolean reset.
Perform discrete-time limited integration of a signal using the forward method, with external
Boolean reset.
17-5
17
Fixed-Point Blockset 3.1 Release Notes
Block Name
Integrator Trapezoidal
Library
Calculus
Integrator Trapezoidal
Resettable
Calculus
Integrator Trapezoidal
Resettable Limited
Calculus
Interval Test
Interval Test Dynamic
Logic &
Comparison
Logic &
Comparison
Math MinMax Running
Resettable
Rate Limiter
Rate Limiter Dynamic
Repeating Sequence
Interpolated
Repeating Sequence
Stair
Sample Time Multiply
Saturation Dynamic
Scaling Strip
Sine
Nonlinear
Nonlinear
Sources
Sources
Calculus
Nonlinear
Data Type
LookUp
State-Space Filters
Description
Perform discrete-time integration of a signal using the trapezoidal method.
Perform discrete-time integration of a signal using the trapezoidal method, with external
Boolean reset.
Perform discrete-time limited integration of a signal using the trapezoidal method, with external Boolean reset.
Determine if a signal is in a specified interval.
Determine if a signal is in a specified interval.
Determine the minimum or maximum of a signal over time.
Limit the rising and falling rates of the signal.
Limit the rising and falling rates of the signal.
Output a discrete-time sequence and repeat, interpolating between data points
Output a discrete time sequence and repeat.
Support calculations involving sample time.
Bound the range of the input.
Remove scaling and map to a built in integer.
Implement a sine wave in fixed-point using a lookup table approach that exploits quarter wave symmetry.
Implement discrete-time state space.
17-6
New Features
Block Name
Unit Delay
Unit Delay Enabled
Unit Delay Enabled
External IC
Unit Delay Enabled
Resettable
Unit Delay Enabled
Resettable External IC
Unit Delay External IC
Unit Delay Resettable
Unit Delay Resettable
External IC
Unit Delay With
Preview Enabled
Unit Delay With
Preview Enabled
Resettable
Unit Delay With
Preview Enabled
Resettable External RV
Unit Delay With
Preview Resettable
Unit Delay With
Preview Resettable
External RV
Wrap To Zero
Library
Delays & Holds
Delays & Holds
Delays & Holds
Delays & Holds
Delays & Holds
Delays & Holds
Delays & Holds
Delays & Holds
Delays & Holds
Delays & Holds
Delays & Holds
Delays & Holds
Delays & Holds
Nonlinear
Description
Delay a signal one sample period.
Delay a signal one sample period.
Delay a signal one sample period.
Delay a signal one sample period.
Delay a signal one sample period.
Delay a signal one sample period.
Delay a signal one sample period.
Delay a signal one sample period.
Support calculations that have feedback and depend on the current input.
Support calculations that have feedback and depend on the current input.
Support calculations that have feedback and depend on the current input.
Support calculations that have feedback and depend on the current input.
Support calculations that have feedback and depend on the current input.
Set output to zero if input is above threshold.
17-7
17
Fixed-Point Blockset 3.1 Release Notes
Renamed Blocks
All of the Fixed-Point Blockset blocks have been renamed for Version 3.1. Old models built with Version 3.0 will continue to work in Version 3.1.
Version 3.0 Block Name
FixPt Absolute Value
FixPt Bitwise Operator
FixPt Constant
FixPt Conversion
FixPt Conversion Inherited
FixPt Data Type Propagation
FixPt Dead Zone
FixPt Dot Product
FixPt Dynamic Look-Up Table
FixPt FIR
FixPt Gain
FixPt Gateway In
FixPt Gateway In Inherited
FixPt Gateway Out
FixPt Integer Delay
FixPt Logical Operator
FixPt Look-Up Table
FixPt Look-Up Table (2D)
FixPt Matrix Gain
FixPt MinMax
Version 3.1 Block Name
Abs
Bitwise Operator
Constant
Conversion
Conversion Inherited
Data Type Propagation
Dead Zone
Dot Product
Look-Up Table Dynamic
FIR
Gain
Gateway In
Gateway In Inherited
Gateway Out
Integer Delay
Logical Operator
Look-Up Table
Look-Up Table (2D)
Matrix Gain
MinMax
17-8
New Features
Version 3.0 Block Name
FixPt Multiport Switch
FixPt Product
FixPt Relational Operator
FixPt Relay
FixPt Saturation
FixPt Sign
FixPt Sum
FixPt Switch
FixPt Tapped Delay
FixPt Unary Minus
FixPt Unit Delay
FixPt Zero-Order Hold
Version 3.1 Block Name
Multiport Switch
Product
Relational Operator
Relay
Saturation
Sign
Sum
Switch
Tapped Delay
Unary Minus
Unit Delay
Zero-Order Hold
New Functions
The Fixed-Point Blockset 3.1 includes the new functions listed below.
Function Name fixpt_look1_func_approx fixpt_look1_func_plot
Description
Optimize for a fixed-point function, the x values, or breakpoints, that are generated from a lookup table.
Plot a function with x values generated by the fixpt_look1_func_approx function.
17-9
17
Fixed-Point Blockset 3.1 Release Notes
Data Type Support
All the Fixed-Point Blockset 3.1 now accept matrix and frame-based signals, except for the following two blocks, which accept only sample-based signals:
• Dot Product
• FIR
If you want to update a model built with Version 3.0 to take advantage of the additional data type support, you should replace all the old blocks in the model
blocks.
Changes to Functionality
The following changes have been made to the functionality of the Fixed-Point
Blockset 3.1 since Version 3.0:
• The Doubles Override parameter in the Fixed-Point Blockset Interface has been renamed to Datatype Override, and now includes more options.
• The MultiPort Switch block has a new parameter called Use zero based indexing .
• The Switch block has a new parameter called Criteria for passing first input , which enables you to control the conditions under which the first input is passed.
17-10
Known Documentation Problem
Known Documentation Problem
This section updates the Fixed-Point Blockset 3.1 documentation set, reflecting a known Fixed-Point Blockset 3.1 documentation problem.
Error in Printed Version of Documentation
The Fixed-Point Blockset 3.1 supports floating-point types, except for custom floating-point types.
In the appendix “Code Generation” of the Fixed-Point Blockset User’s Guide, the section “Storage Class of Variables,” in “Code Generation Support,” contains the following incorrect reference to data type support in the blockset:
• No floating-point support except for the fixed-point gateway blocks.
This should be corrected as follows:
• Floating-point types are supported, except for custom floating-point types.
17-11
17
Fixed-Point Blockset 3.1 Release Notes
17-12
Image Processing Toolbox
3.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 18-2
Morphology . . . . . . . . . . . . . . . . . . . . . 18-3
Spatial Transformations . . . . . . . . . . . . . . . . 18-4
Image Registration . . . . . . . . . . . . . . . . . . 18-5
Integer Image Arithmetic . . . . . . . . . . . . . . . 18-6
Integer Image Filtering . . . . . . . . . . . . . . . . 18-7
Deconvolution/Deblurring . . . . . . . . . . . . . . . 18-7
Support for DICOM Files . . . . . . . . . . . . . . . 18-8
Miscellaneous . . . . . . . . . . . . . . . . . . . . 18-8
New Demos . . . . . . . . . . . . . . . . . . . . . 18-9
Major Bug Fixes . . . . . . . . . . . . . . . . . 18-11
18
18
Image Processing Toolbox 3.1 Release Notes
New Features
This section describes the new features and enhancements of the Image
Processing Toolbox, Version 3.0, and the Version 3.1 update, both introduced since the Image Processing Toolbox 2.2.2 (Release 12.0).
Note The Image Processing Toolbox 3.0 was made available in
Web-downloadable form after Release 12.0. The Image Processing Toolbox 3.1 is part of Release 12.1.
The new features introduced in the Image Processing Toolbox, Version 3.0, include:
• Many new morphology functions
• New spatial transformation functions
• New image registration functions, with a new graphical user interface
• New integer image arithmetic functions
• New Integer image filtering function
• New image deblurring (deconvolution) functions
The new features introduced in the Image Processing Toolbox, Version 3.1, include:
• New deblurring function, deconvblind , that implements the blind deconvolution algorithm
• New utility function, label2rgb , that converts a label matrix into an RGB color image
For information about Image Processing Toolbox features that are incorporated from recent releases, see the Release Notes for Release 12.
18-2
New Features
Morphology
Version 3.0 adds a broad suite of new mathematical morphology tools open up broad new classes of applications in segmentation and image enhancement.
The existing dilation and erosion operators have been extended to work with grayscale images. New functions range from additional basic operators
(opening, closing, tophat) to advanced tools useful for segmentation (distance transforms, reconstruction-based operators, and the watershed transform).
The functions use advanced techniques for high performance, including automatic-structuring element decomposition, 32-bit binary image packing, and queue-based algorithms.
Function bwareaopen bwdist bwhitmiss bwlabeln bwpack bwulterode bwunpack conndef imbothat imclearborder imclose imdilate imerode imextendedmax imextendedmin
Description
Binary area open (remove small objects)
Distance transform
Binary hit-miss operation
Label-connected components in N-D binary image
Pack binary image
Ultimate erosion
Unpack binary image
Default connectivity array
Perform bottom-hat filtering
Suppress light structures connected to image border
Close image
Dilate image
Erode image
Extended-maxima transform
Extended-minima transform
18-3
18
Image Processing Toolbox 3.1 Release Notes
Function imfill imhmax imhmin imimposemin imopen imreconstruct imregionalmax imregionalmin imtophat strel strel/getheight strel/getnhood strel/getsequence strel/isflat strel/reflect strel/translate watershed
Description
Fill image regions and holes
H-maxima transform
H-minima transform
Impose minima
Open image
Morphological reconstruction
Regional maxima
Regional minima
Tophat filtering
Create morphological structuring element
Get structuring element height
Get structuring element neighborhood
Get sequence of decomposed structuring elements
Return true for flat structuring element
Reflect structuring element about its center
Translate structuring element
Find image watershed regions
Spatial Transformations
Version 3.0 adds functions for applying a variety of spatial transformations to images and to points. This is a core computational capability. Supported transform types include affine, projective, and user-defined custom transformations. Multidimensional transformations are supported, where you can control which dimensions are the transform dimensions. For example, you can apply a two-dimensional transform to an RGB image, and each color plane is automatically transformed the same way. You can even control the type of
18-4
New Features interpolation independently along each dimension, and specify interpolants that you define.
Function Description checkerboard Create checkerboard image findbounds fliptform imtransform makeresampler maketform tformarray tformfwd tforminv
Find output bounds for geometric transformation
Flip the input and output roles of a TFORM struct
Apply geometric transformation to image
Create resampler structure
Create geometric transformation structure (
Geometric transformation of a multidimensional array
Apply inverse geometric transformation
Apply forward geometric transformation
TFORM )
Image Registration
Version 3.0 adds several functions useful for registering (aligning) two images.
This is critical in remote sensing and medical imaging, for example. There are functions for inferring various spatial transformations from control-point pairs, for the subpixel adjustment of control-point pair locations, and for normalized cross-correlation. There is also a graphical user interface (GUI) for selecting control-point pairs in a pair of images.
Function cp2tform cpcorr cpselect
Description
Infer spatial transformation from control-point pairs
Tune control-point locations using cross-correlation
Control-point selection tool (graphical user interface)
18-5
18
Image Processing Toolbox 3.1 Release Notes
Function cpstruct2pairs normxcorr2
Description
Convert CPSTRUCT to valid pairs of control points
Normalized two-dimensional cross-correlation
Integer Image Arithmetic
The Image Processing Toolbox 3.1 includes new functions for performing arithmetic on image arrays without converting them to double-precision. In addition to the basic operations (add, subtract, multiply, and divide), there are several key functions (absolute difference, linear combination, and complementation) that cannot readily be implemented in terms of the basic operations.
Function imabsdiff imadd imcomplement imdivide imlincomb immultiply imsubtract
Description
Absolute difference of two images
Add two images, or add constant to image
Complement image
Divide two images, or divide image by constant
Linear combination of images
Multiply two images, or multiply image by constant
Subtract two images, or subtract constant from image
18-6
New Features
Integer Image Filtering
Version 3.0 added a function for performing filtering on image arrays without converting them to double precision, a significant memory savings in a common operation. You can specify several different boundary padding options. You can also perform higher dimensional filtering.
Function Description imfilter Filter 2-D and N-D images
Deconvolution/Deblurring
Version 3.0 added support for several fundamental algorithms for the deconvolution (deblurring) of images. All of the functions support multidimensional problems.
Function deconvblind deconvlucy deconvreg deconvwnr edgetaper fspecial otf2psf psf2otf
Description
Deblur image using blind deconvolution algorithm
[New with Version 3.1]
Deblur image using Lucy-Richardson algorithm
Regularized deconvolution
Wiener deconvolution
Taper image edges according to PSF
Existing function; added 'disk' and 'motion' options
Convert optical transfer function to point-spread function
Convert point-spread function to optical transfer function
18-7
18
Image Processing Toolbox 3.1 Release Notes
Support for DICOM Files
Version 3.0 adds functions for reading image data and metadata from DICOM files. DICOM is an important file and network interchange standard in the area of medical imaging.
Function dicomread dicominfo
Description
Read image data from DICOM file
Read metadata from DICOM file
Miscellaneous
Version 3.1 included several new utility functions or previously undocumented utility functions. Most of these were created to support functions in the key feature categories, such as deconvolution.
Function circshift graythresh im2mis imnoise label2rgb padarray regionprops stretchlim
Description
Shift array circularly
Compute global image threshold using
Otsu's method (image enhancement)
Convert image to Java
MemoryImageSource
Added support for new noise types:
'poisson' and 'localvar'
Convert label matrix to RGB image [New for Version 3.1]
Pad array
Renamed from existing function imfeature; extended to N-D
Find limits to contrast stretch an image
18-8
New Features
New Demos
The Image Processing Toolbox 3.1 includes the 15 new extended example demos, presented in HTML form.
Demo Name ipexconformal ipexdeconvblind ipexdeconvlucy ipexdeconvreg ipexdeconvwnr ipexgranulometry ipexmri ipexnormxcorr2 ipexregaerial
Brief Description
Explore a Conformal Mapping: illustrates how to use spatial- and image-transformation functions to perform a conformal mapping.
Deblurring Images Using the Lucy-Richardson algorithm: illustrates use of the deconvlucy function. [New with Version 3.1]
Deblurring Images Using the Lucy-Richardson algorithm: illustrates use of the deconvlucy function.
Deblurring Images Using a Regularized Filter: illustrates use of the deconvreg function.
Deblurring Images Using the Wiener Filter: illustrates use of the deconvwnr function.
Finding the Granulometry of Stars in an Image: illustrates how to use morphology functions to perform granulometry.
Extracting Slices from a 3-Dimensional MRI Data
Set: illustrates how to use the image transformation functions to interpolate and reslice a three-dimensional MRI data set, providing a convenient way to view a volume of data.
Registering an Image Using Normalized
Cross-correlation: illustrates how to use translation to align two images.
Registering an Aerial Photo to an Orthophoto: illustrates how to use the Control Point Selection
Tool to align two images.
18-9
18
Image Processing Toolbox 3.1 Release Notes ipexrotate ipexsegcell ipexsegmicro ipexsegwatershed ipexshear ipextform
Finding the Rotation and Scale of a Distorted
Image: illustrates how to use the cp2tform function to get the rotation angle and scale factor of a distorted image.
Detecting a Cell Using Image Segmentation: illustrates how to use dilation and erosion to perform edge detection.
Detecting Microstructures Using Image
Segmentation: illustrates how to use morphological opening and closing to extract large objects from an image.
Detecting Touching Objects Using Watershed
Segmentation: illustrates use of morphology functions to perform marker-control watershed segmentation.
Padding and Shearing an Image Simultaneously: illustrates how to use the padding options of the image transformation functions.
Creating a Gallery of Transformed Images: illustrates how to use the imtransform function to perform many types of image transformations.
18-10
Major Bug Fixes
Major Bug Fixes
This section describes major bug fixes included in the Image Processing
Toolbox, Version 3.0 and Version 3.1.
For information about additional bug fixes that are incorporated from recent releases, see the Release 12 Release Notes.
• fspecial — Fixed incorrect normalization for the Gaussian filter option.
• improfile — Fixed an occasional indexing problem caused by round-off error.
• rgb2ind — Fixed a problem that caused rgb2ind to produce bad results for very large images.
• Functions that operate on binary input images now treat
NaN s in a consistent manner. When an input array that is expected to be a binary image contains
NaN values, the NaN value is always treated as 1.
18-11
18
Image Processing Toolbox 3.1 Release Notes
18-12
Instrument Control
Toolbox 1.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 19-2
VXI Block and FIFO Read Operations . . . . . . . . . . 19-2
Freeing the Serial Port on Windows Platforms . . . . . . . 19-2
Data Parsing . . . . . . . . . . . . . . . . . . . . 19-2
binblock Data Transfer . . . . . . . . . . . . . . . . 19-3
Tektronix VISA Support . . . . . . . . . . . . . . . . 19-3
Enhancements to Existing Functions and Properties . . . . 19-3
Vendor Driver Requirements and Limitations . . . . 19-4
Tektronix VISA Limitations . . . . . . . . . . . . . . 19-4
Upgrading from an Earlier Release . . . . . . . . . 19-5
Events, Callbacks, and Function Handles . . . . . . . . . 19-5
19
19
Instrument Control Toolbox 1.1 Release Notes
New Features
This section introduces the new features and enhancements in the Instrument
Control Toolbox 1.1, added since the Instrument Control Toolbox 1.0 (Release
12.0). For a brief introduction to the Instrument Control Toolbox 1.0, refer to the Release Notes for Release 12.
VXI Block and FIFO Read Operations
For VISA-VXI and VISA-GPIB-VXI objects, you can specify if the VXI register offset increments after data is transferred with the MemoryIncrement property.
You can configure MemoryIncrement to be block or FIFO . If MemoryIncrement is block , the memread and memwrite functions increment the offset after every read and write operation, and data is transferred from consecutive memory elements. If MemoryIncrement is FIFO , the memread and memwrite functions always read from or write to the same memory element. Note that the
Instrument Control Toolbox 1.0 supported only block data transfer.
Freeing the Serial Port on Windows Platforms
The serial port object uses the javax.comm
package to communicate with the serial port. However, due to a memory leak in javax.comm
, the serial port object is not released from memory. You can use the freeserial function to release
MATLAB's hold on the serial port.
freeserial is necessary only on Windows platforms. You should use freeserial only if you need to connect to the serial port from another application after a serial port object has been connected to that port, and you do not want to exit MATLAB.
Data Parsing
You can parse formatted data read from your instrument with the scanstr function. The data is parsed according to the specified delimiters, and is stored in a cell array as either a double or a string.
19-2
New Features
binblock Data Transfer
The binary-block (binblock) format is defined as #<N><D><A> where:
•
N specifies the number of digits D that follow.
• D specifies the number of data bytes A that follow.
• A is the data to written to the instrument.
You can transfer binblock data between MATLAB and your instrument with the binblockread and binblockwrite functions.
Tektronix VISA Support
Tektronix VISA is supported for serial and GPIB interfaces.
Enhancements to Existing Functions and Properties
Terminator and EOSCharCode Properties
For serial port and VISA-serial objects, you can configure Terminator to a decimal value ranging from 0 to 127, to the equivalent ASCII character, or to empty (''). For serial port objects, you can also set Terminator to CR/LF or LF/
CR .
For GPIB- and VXI-related objects, you can configure EOSCharCode to a decimal value ranging from 0 to 255, or to the equivalent ASCII character.
Timer Events
Some timer events may not be processed if your system is significantly slowed or if the TimerPeriod value is too small. The minimum TimerPeriod value is now 0.01 second.
VXI Register Read and Write Functions
The memread , memwrite , mempeek and mempoke functions now handle single precision values.
CompareBits Property
For VISA-GPIB, VISA-VXI, and VISA-GPIB-VXI objects, the CompareBits property no longer exists since its only supported value is 8.
19-3
19
Instrument Control Toolbox 1.1 Release Notes
Vendor Driver Requirements and Limitations
Driver requirements and limitations associated with the vendors supported by the Instrument Control Toolbox 1.0 are described in the Release Notes for
Release 12.
Tektronix VISA Limitations
The Tektronix VISA driver has these known limitations:
• Only serial port and GPIB objects are supported.
• Asynchronous read and write operations for the VISA-GPIB object are not supported. Therefore, the following toolbox functionality is not supported:
- The readasync function
- The async flag for the fprintf and fwrite functions
- The BytesAvailableFcn and OutputEmptyFcn properties
Note The driver limitations described in this section are restricted to the limitations directly associated with using the Instrument Control Toolbox.
19-4
Upgrading from an Earlier Release
Upgrading from an Earlier Release
This section describes the upgrade issues involved in moving the Instrument
Control Toolbox 1.0 (Release 12.0) to the Instrument Control Toolbox 1.1
(Release 12.1).
Events, Callbacks, and Function Handles
Action properties and action functions are now referred to as callback properties and callback functions. This new terminology is reflected in new names for the associated properties and functions. The general rule for the name changes is to change “Action” to “Fcn” for properties, and “action” to
“callback” for functions. For example, TimerAction has been renamed
TimerFcn , and instraction has been renamed instrcallback .
Additionally, if you want to automatically pass the object and event information to the callback function, then you must specify the function as either a function handle or as a cell array. Note that you can also specify the callback function as a string. In this case, the callback is evaluated in the
MATLAB workspace and no requirements are made on the function’s input arguments.
19-5
19
Instrument Control Toolbox 1.1 Release Notes
19-6
MATLAB C/C++ Math
Library 2.2 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 20-2
New Math Library Functions . . . . . . . . . . . . . . 20-2
Upgrading from an Earlier Release . . . . . . . . . 20-4
Recompile Your Programs . . . . . . . . . . . . . . . 20-4
Changed Features . . . . . . . . . . . . . . . . . . 20-4
Known Software and Documentation Problems . . . . 20-6
Documentation Error . . . . . . . . . . . . . . . . . 20-6
20
20
MATLAB C/C++ Math Library 2.2 Release Notes
New Features
This section introduces the new features and enhancements added in the
MATLAB C/C++ Math Library 2.2 since the MATLAB C/C++ Math Library 2.1
(Release 12.0).
For information about MATLAB C/C++ Math Library features that are incorporated from recent releases, see the Release Notes for Release 12.
New Math Library Functions
The following new and modified Math Library functions are available in
Version 6.1.
New Math Library Functions
Function Purpose deval, mlfDeval
Evaluate the solution of a differential equation problem using the output of ode45 , ode23 , ode113 , ode15s , ode23s , ode23t , ode23tb , or bvp4c .
Math Library Functions with New or Changed Capabilities
Function Enhancement ode45 , ...
mlfOde45 , ...
New MATLAB syntax sol = solver(odefun,[t0 tf], y0...) returns a structure that you can use with the new deval and mlfDeval functions to evaluate the solution at any point on the interval [t0,tf] .
polyeig, mlfPolyeig qz, mlfQz
New MATLAB syntax e = polyeig(A0,A1,..,Ap) returns only the eigenvalues of the specified eigenvalue problem.
Use [ X,e] = polyeig(A0,A1,...Ap) if you also want the eigenvectors. This capability is available in MATLAB 6.0.
New MATLAB syntax [AA,BB,Q,Z,V,W] = qz(A,B) returns W , the left generalized eigenvectors of A and B .
20-2
New Features
Math Library Functions with New or Changed Capabilities
(Continued)
Function Enhancement reshape, mlfReshape
New MATLAB syntax reshape(A,...,[],...) calculates the length of the dimension specified by the placeholder [] .
svd, mlfSvd
You now have the option of specifying just the first two output arguments for svd .
20-3
20
MATLAB C/C++ Math Library 2.2 Release Notes
Upgrading from an Earlier Release
There are no upgrade issues moving from the MATLAB C/C++ Math Library
2.1 (Release 12.0) to the MATLAB C/C++ Math Library 2.2 (Release 12.1).
The following issues are involved in upgrading from the MATLAB C/C++ Math
Library 2.0 (Release 11) to the MATLAB C/C++ Math Library 2.2.
Recompile Your Programs
Existing C/C++ Math Library Version 2.0 hand-written source code is compatible with the Version 2.2 library, but you must recompile your code.
Additionally, any M-files which were compiled with Version 2.0 of the
MATLAB Compiler must be recompiled with Version 2.2 of the MATLAB
Compiler before using them with the Version 2.2 library. If you do not recompile your program, it will produce a run-time error.
Changed Features
Empty Arrays
In Version 2.0 of the C++ Math Library, any empty array could be used as an indexed deletion operator. In Version 2.2, you must use the empty() function for indexed deletion.
mbuild Function Now Returns Accurate Error Status
The mbuild syntax mbuild myprog.c
now throws an error when it encounters an error condition.
The mex syntax stat = mbuild('myprog.c') now returns a nonzero value to stat when it encounters an error condition.
In the past, on Microsoft Windows platforms, mbuild always either successfully exited or returned zero (indicating success), regardless of whether an error had actually occurred.
20-4
Upgrading from an Earlier Release
To ensure code from before Release 12 works properly in Release 12, either use try/catch logic to deal with error conditions, or use a form of mbuild that returns an error status instead of throwing an error. Specifically try
mbuild something.c
catch
disp( something failed ); end or status = mbuild( something.c ); if status ~= 0
disp( something failed ); end
20-5
20
MATLAB C/C++ Math Library 2.2 Release Notes
Known Software and Documentation Problems
This section updates the MATLAB C/C++ Math Library documentation set, reflecting a known documentation problem.
Documentation Error
In the section “Creating Structures” in the Using the C Math Library documentation, the examples use a routine named mlfDestroyArray . The name of this routine should be mxDestroyArray .
20-6
MATLAB Runtime Server
6.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 21-2
Configuration File Generation Tool . . . . . . . . . . . 21-2
Upgrading from an Earlier Release . . . . . . . . . 21-3
Repeat Compiling, Packaging, and Testing Process . . . . . 21-3
Known Documentation Problems . . . . . . . . . . 21-4
21
21
MATLAB Runtime Server 6.1 Release Notes
New Features
This section introduces a new feature added in the MATLAB Runtime Server
6.1 since the MATLAB Runtime Server 6.0 (Release 12.0).
For information about MATLAB Runtime Server features that are incorporated from recent releases, see the Release Notes for Release 12.
Configuration File Generation Tool
The MATLAB Runtime Server now includes a new tool, makeconfig, for generating the configuration file for packaging an application.
21-2
Upgrading from an Earlier Release
Upgrading from an Earlier Release
There are no upgrade issues moving from the MATLAB Runtime Server 6.0 to the MATLAB Runtime Server 6.1.
Note The upgrade issue described below is involved in moving from the
MATLAB Runtime Server 5.0 (Release 11.0) to the MATLAB Runtime Server
6.1.
Repeat Compiling, Packaging, and Testing Process
If you are upgrading a runtime application that you built using the MATLAB
Runtime Server 5.0 so that it uses the MATLAB Runtime Server 6.0, then you need to repeat the process of compiling, packaging, and testing the application to ensure that it works properly with MATLAB 6.0. Refer to the MATLAB
Runtime Server Application Developer’s Guide for details.
21-3
21
MATLAB Runtime Server 6.1 Release Notes
Known Documentation Problems
This section updates the MATLAB Runtime Server 6.1 documentation set, reflecting known documentation problems.
These errors occur in the printed, but not the electronic, version of the
MATLAB Runtime Server Application Developer’s Guide:
• The list of files in “Manually Packaging Files for Shipping (PC)” (pages 4-6 and 4-7) is incorrect. Use the electronic version instead.
• If your application uses Java classes, then the discussion about packaging a runtime application (pages 4-3 through 4-7) is incomplete. Use the electronic version of the instructions for automatically or manually packaging your application.
• Pages 3-10 and 3-11 incorrectly refer to the directories toolbox\runtime\examples\engine\activex and toolbox\runtime\examples\engine , respectively. Both should instead refer to the directory toolbox\runtime\examples\activex , which is the actual location of the files for the ActiveX Automation example.
• The electronic version of the “Testing with the Runtime Server Variant” section for runtime engine applications recommends a more robust method, compared to the corresponding section (page 3-8) of the printed version. Also, see the updated procedure for testing the example runtime engine application, and compare with page 3-28 of the printed version.
• The following information about file structures has been added to the electronic version of the “Developing a MATLAB Runtime GUI Application” chapter:
When creating your deployment structure, you must use the -inplace flag with pcode or the default 'develStruct' option of buildp to have the
P-files mirror the directory structure of the M-files.
• The following information about the packaging utility has been added to the electronic version of the “Shipping a MATLAB Runtime Application” chapter:
The packaging utility is intended to be used only with the MATLAB portion of your application, however, you can integrate the packaging utility into your overall installation suite.
21-4
Neural Network Toolbox
4.0.1 Release Notes
Major Bug Fixes . . . . . . . . . . . . . . . . . . 22-2
Proper Use of Validation and Test Data . . . . . . . . . 22-2
Correct Version 3 Object Loading . . . . . . . . . . . . 22-2
22
22
Neural Network Toolbox 4.0.1 Release Notes
Major Bug Fixes
The Neural Network Toolbox 4.0.1 added several bug fixes, including the following descriptions of particularly important bug fixes.
For information about Neural Network Toolbox 4.0.1 features and bug fixes that are incorporated from recent releases, see the Release Notes for Release 12.
Proper Use of Validation and Test Data
The Neural Network Tool now uses the optional validation and test data properly when training.
Correct Version 3 Object Loading
Neural network objects saved under Version 3 now load correctly under
Version 4.
22-2
Optimization Toolbox 2.1.1
Release Notes
New Features . . . . . . . . . . . . . . . . . . . 23-2
Support for Large Problems that Are Not Well-Scaled . . . . 23-2
Major Bug Fixes . . . . . . . . . . . . . . . . . . 23-3
Upgrading from an Earlier Release . . . . . . . . . 23-4
23
23
Optimization Toolbox 2.1.1 Release Notes
New Features
This section introduces the new features and enhancements added in the
Optimization Toolbox 2.1.1 since the Optimization Toolbox 2.1 (Release 12.0).
For information about Optimization Toolbox features that are incorporated from recent releases, see the Release Notes for Release 12.
Support for Large Problems that Are Not
Well-Scaled
In Version 2.1.1, large-scale finite differencing is improved numerically to handle cases when an optimization problem is not well-scaled. These changes potentially improve the speed and accuracy of results when using the large-scale versions of lsqnonlin , lsqcurvefit , fsolve , fmincon and fminunc , particularly if the objective function is not well-scaled.
23-2
Major Bug Fixes
Major Bug Fixes
The Optimization Toolbox includes several bug fixes, including the following descriptions of particularly important bug fixes for both Version 2.1
(Release 12.0) and Version 2.1.1 (Release 12.1).
23-3
23
Optimization Toolbox 2.1.1 Release Notes
Upgrading from an Earlier Release
There are no upgrade issues moving from the Optimization Toolbox 2.1 to the
Optimization Toolbox 2.1.1.
See the Release Notes for Release 12 for upgrade issues involved in moving from the Optimization Toolbox 2.0 (Release 11.0) to the Optimization Toolbox 2.1
(Release 12.0).
23-4
Power System Blockset 2.2
Release Notes
New Features . . . . . . . . . . . . . . . . . . . 24-2
Powergui Enhancements . . . . . . . . . . . . . . . 24-2
New powerlib_extras Documentation . . . . . . . . . . 24-2
24
24
Power System Blockset 2.2 Release Notes
New Features
This section introduces the new features and enhancements added in the
Power System Blockset 2.2 since the Power System Blockset 2.1 (Release 12.0).
For information about Power System Blockset features that are incorporated from recent releases, see the Release Notes for Release 12.
Powergui Enhancements
The Powergui tool in Power System Blockset 2.2 now includes the Display spectrum of Signal feature previously available only on certain demos. This feature displays the fast Fourier transform (FFT) of a specified signal.
New powerlib_extras Documentation
The powerlib_extras block library of Power System Blockset 2.2 consists of miscellaneous, previously undocumented, power blocks. Fifteen of these blocks now have online block reference pages. The other blocks have short block descriptions or block documentation in their masks.
24-2
Real-Time Workshop Ada
Coder 4.1 Release Notes
Release Summary . . . . . . . . . . . . . . . . . 25-2
25
25
Real-Time Workshop Ada Coder 4.1 Release Notes
Release Summary
This section introduces the new features and enhancements added in the
Real-Time Workshop Ada Coder 4.1 since the Real-Time Workshop Ada Coder
4.0 (Release 12.0).
Note The Real-Time Workshop Ada Coder 4.1 requires the Real-Time
Workshop.
The Real-Time Workshop Ada Coder 4.1 supports all applicable new features
added to the Real-Time Workshop 4.1. These features are described in Chapter
5, “Real-Time Workshop 4.1 Release Notes.”
25-2
Real-Time Workshop
Embedded Coder 2.0
Release Summary . . . . . . . . . . . . . . . . . 26-2
New Features . . . . . . . . . . . . . . . . . . . 26-3
Custom Storage Classes for Data Objects . . . . . . . . . 26-3
Enhanced Code Generation Options . . . . . . . . . . . 26-4
Virtualized Output Ports Optimization . . . . . . . . . . 26-4
Improved HTML Code Generation Report . . . . . . . . 26-4
26
26
Real-Time Workshop Embedded Coder 2.0
Release Summary
Release 2.0 of the Real-Time Workshop Embedded Coder is a major upgrade, incorporating:
• Significant improvements in efficiency and readability of generated code.
Many improvements in Real-Time Workshop code generation technology are especially applicable to embedded systems development. These include expression folding and buffer optimizations. For further information on
these features, see Chapter 5, “Real-Time Workshop 4.1 Release Notes.”
• Custom storage classes for signal, state, and parameter objects, for embedded systems development.
• Additional and enhanced code generation options.
• Improved HTML code generation report.
See “The Real-Time Workshop Embedded Coder” in the Real-Time Workshop
User’s Guide for full documentation of the Real-Time Workshop Embedded
Coder.
26-2
New Features
New Features
This section introduces the new features and enhancements added in the
Real-Time Workshop Embedded Coder 2.0, since the Real-Time Workshop
Embedded Coder 1.0.
For information about Real-Time Workshop Embedded Coder features that are incorporated from Version 1.0, see the Release Notes for Release 12.
Custom Storage Classes for Data Objects
The Real-Time Workshop Embedded Coder 2.0 implements a number of predefined custom storage classes that are useful in embedded systems development. These classes extend the built-in storage classes provided by the
Real-Time Workshop. The built-in classes provide limited control over the form of the code generated for references signals, parameters, and other types of data. These storage classes are suitable for a simulation or rapid prototyping environment, but embedded system designers often require greater control over the representation of data.
Using Real-Time Workshop Embedded Coder custom storage classes, you can define and generate constructs such as bit fields or structs from your model, and easily interface data structures to externally written code.
See “Custom Storage Classes” in the Real-Time Workshop User’s Guide for further information.
Note To create Simulink data objects with custom storage classes from
M-code, you must have a Real-Time Workshop Embedded Coder license. To share data objects of this type with users who do not have the required license, save the objects in a MAT-file which the users can load into the MATLAB workspace.
26-3
26
Real-Time Workshop Embedded Coder 2.0
Enhanced Code Generation Options
Initialize Floats and Doubles to 0.0
This option lets you control how internal storage for floats and doubles is initialized. You can initialize floats and doubles to the integer bit pattern 0 (all bits off) or set float and double storage explicitly to the value 0.0
.
See “Initialize Floats and Doubles to 0.0” in the Real-Time Workshop User’s
Guide for further information.
MAT-File Logging Off by Default
In prior releases, the MAT-file logging option was on by default. In Real-Time
Workshop Embedded Coder 2.0, the MAT-file logging option is off by default.
We recommend this setting because it eliminates the extra code and memory usage required to maintain logging variables.
See “MAT-file Logging and Code Efficiency” in the Real-Time Workshop User’s
Guide for further information.
Virtualized Output Ports Optimization
The virtualized output ports optimization lets you eliminate code and data storage associated with root output ports under certain conditions.
See “Virtualized Output Ports Optimization” in the Real-Time Workshop User’s
Guide for further information.
Improved HTML Code Generation Report
The format of the Real-Time Workshop Embedded Coder code generation report has been enhanced for readability. The “Optimizations” section lists additional options that will better optimize your code. Links from the report to the online Real-Time Workshop Embedded Coder documentation have been expanded.
See “Generating a Code Generation Report” in the Real-Time Workshop User’s
Guide for further information.
26-4
Requirements
Management Interface
1.0.2 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 27-3
Support for the Latest DOORS Release . . . . . . . . . 27-3
27
27
Requirements Management Interface 1.0.2 Release Notes
New Features
This section introduces the new features added in the Requirements
Management Interface 1.02 since the initial release of the Requirements
Management Interface, Version 1.01 (Release 12.0).
For information about the initial release of the Requirements Management
Interface, see the Release Notes for Release 12.
Support for the Latest DOORS Release
Version 1.02 works with the latest DOORS release, Version 5.1.
27-2
Signal Processing Toolbox
5.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 28-2
Filter Visualization Tool . . . . . . . . . . . . . . . . 28-2
New Windows . . . . . . . . . . . . . . . . . . . . 28-3
New Signal Demo . . . . . . . . . . . . . . . . . . 28-4
Enhancements . . . . . . . . . . . . . . . . . . . 28-5
FDATool Enhancements . . . . . . . . . . . . . . . . 28-5
SPTool Enhancement . . . . . . . . . . . . . . . . . 28-5
Enhanced Functions . . . . . . . . . . . . . . . . . 28-6
Major Bug Fixes . . . . . . . . . . . . . . . . . . 28-7
Bug Fixes Incorporated from Release 12.0 . . . . . . . . 28-7
Platform Limitations . . . . . . . . . . . . . . . . 28-8
FDATool — 640 x 480 Resolution . . . . . . . . . . . . 28-8
Upgrading from an Earlier Release . . . . . . . . . 28-9
Changes to remez . . . . . . . . . . . . . . . . . . 28-9
Known Software Problem . . . . . . . . . . . . . 28-10
FDATool and FVTool Pole/Zero Plot . . . . . . . . . . 28-10
FDATool and FVTool Magnitude and Phase Plot . . . . . 28-10
28
28
Signal Processing Toolbox 5.1 Release Notes
New Features
This section introduces the new features added in the Signal Processing
Toolbox 5.1 since the Signal Processing Toolbox 5.0 (Release 12.0).
Enhancements are described in the next section.
For information about Signal Processing Toolbox features that are incorporated from recent releases, see the Release Notes for Release 12.
The Signal Processing Toolbox 5.1 provides a number of new features and enhancements, and a completely new facility for analyzing filters, the Filter
Visualization Tool.
This section is organized into the following subsections:
• “Filter Visualization Tool” on page 28-2
• “downsample/upsample” on page 28-4
• “New Signal Demo” on page 28-4
Filter Visualization Tool
The new Filter Visualization Tool ( fvtool ) groups all the filter analysis functions, such as magnitude, phase, impulse response, etc., into a single window where you can easily switch between analyses, add annotations, and print your filter response.
28-2
New Features
New Windows
Six new window functions and a general window function have been added to the Signal Processing Toolbox. One window has been renamed. The new windows are:
• Bartlett-Hann ( barthannwin )
• Blackman-Harris ( blackmanharris )
• Bohman ( bohmanwin )
• Gaussian ( gausswin )
• Nuttall’s Blackman-Harris ( nuttallwin )
• Tukey (tapered cosine) ( tukeywin )
28-3
28
Signal Processing Toolbox 5.1 Release Notes
The general window function is an alternate way to specify any Signal
Processing Toolbox window.
The rectangular ( boxcar ) window function has been renamed rectwin . For compatibility, boxcar will continue to work in this release.
bitrevorder
The new bitrevorder function returns input data in bit-reversed order.
downsample/upsample
The new downsample and upsample functions decrease and increase the sampling rate of a signal, respectively.
filternorm
The new filternorm function computes the 2-norm or inf-norm of a digital filter.
goertzel
The new goertzel function implements the Goertzel algorithm, which is an alternate method of computing the DFT.
New Signal Demo
A new demo, Vector Transition Processing Using Spectral Windows, has been added. This demo is interactive and demonstrates how to smooth the transition between two vectors by using various spectral windows.
28-4
Enhancements
Enhancements
This section describes the Signal Processing Toolbox enhancements and is organized into the following subsections:
• “FDATool Enhancements” on page 28-5
• “SPTool Enhancement” on page 28-5
• “Enhanced Functions” on page 28-6
FDATool Enhancements
The following items have been added to the FDATool.
• The new Filter Visualization ( fvtool ) can be launched from Analysis->Full
View Analysis .
• Print Preview is now an icon on the toolbar and it launches the MATLAB standard print preview.
• Clicking on any point on a filter plot line adds a data marker, which displays information about the current point.
• New windows are included in Method->FIR->Window and in the Window option in the Window Specifications pane.
• The ability to export filter coefficients to a C-header file (File->Create
Header File ) is included.
• The raised cosine ( firrcos ) filter method is a new option in the Method menu and in the Design Filter pane.
• A plug-in for Code Compose Studio™ IDE to provide the ability to download coefficients from FDATool to the Developer’s Kit for TI DSP is included.
• FDATool is integrated with DSP Blockset and is accessible from the Digital
Filter Design block.
SPTool Enhancement
You can print preview and print your filter design in the SPTool Filter Viewer and Filter Designer.
28-5
28
Signal Processing Toolbox 5.1 Release Notes
Enhanced Functions
The following functions have been enhanced in the Signal Processing Toolbox
5.1.
Function buffer chirp eqtflength freqzplot lpc medfilt1 sgolayfilt
Enhancement
Takes all MATLAB data types in addition to double-precision data
Allows you to specify the shape (concave or convex) of a quadratic chirp operation
Returns the numerator and denominator orders in addition to the numerator and denominator
Optionally accepts string input (e.g., 'mag' ) in addition to structure input
Outputs a vector of prediction error variances in addition to the linear prediction filter coefficients
Allows you to specify the matrix dimension along which the filter operates
Allows you to specify the matrix dimension along which the filter operates, and it returns row output for row input.
This is consistent with filter
28-6
Major Bug Fixes
Major Bug Fixes
The Signal Processing Toolbox 5.1 includes several bug fixes, including the following:
• In FDATool Magnitude and Phase plot, zoom now works properly.
• In FDATool, the highpass FIR design method for Least Squares and
Equiripple cases now uses the weights correctly when you use the Specify
Order option.
Bug Fixes Incorporated from Release 12.0
The Signal Processing Toolbox 5.1 includes several bug fixes that were made in
Release 12.0.
28-7
28
Signal Processing Toolbox 5.1 Release Notes
Platform Limitations
FDATool — 640 x 480 Resolution
On all platforms, FDATool requires a screen resolution greater than 640 x 480.
28-8
Upgrading from an Earlier Release
Upgrading from an Earlier Release
There are no upgrade issues moving from the Signal Processing Toolbox 5.0
(Release 12.0) to the Signal Processing Toolbox 5.1.
The following upgrade issue is involved in upgrading from the Signal
Processing Toolbox 4.3 (Release 11.1) to the Signal Processing Toolbox 5.1.
Changes to remez
In the Signal Processing Toolbox 5.1, the remez function no longer supports the
' m ' option that previously executed an M-file variant of the function.
28-9
28
Signal Processing Toolbox 5.1 Release Notes
Known Software Problem
FDATool and FVTool Pole/Zero Plot
In the FDATool analysis window, pole-zero plots do not display more than one root at a given point and data markers cannot be displayed for these points.
FDATool and FVTool Magnitude and Phase Plot
In the Magnitude and Phase plot, you can use data markers only on the phase curve.
28-10
Simulink Performance
Tools 1.1 Release Notes
New Features . . . . . . . . . . . . . . . . . . . 29-2
Model Coverage Tool . . . . . . . . . . . . . . . . . 29-2
Graphical Merge Tool . . . . . . . . . . . . . . . . . 29-4
Platform Limitations for HP and IBM . . . . . . . . 29-6
Limited Support Model Coverage Tool . . . . . . . . . . 29-6
Graphical Merge Tool Not Supported . . . . . . . . . . 29-6
29
29
Simulink Performance Tools 1.1 Release Notes
29-2
New Features
This section introduces the new features and enhancements added in Simulink
Performance Tools 1.1 since Simulink Performance Tools 1.0 (Release 12.0).
The following tools were enhanced:
• “Model Coverage Tool” on page 29-2
• “Graphical Merge Tool” on page 29-4
For an introduction to the Simulink Performance Tools, see the Release Notes
for Release 12.
Model Coverage Tool
This section describes features and enhancements added to the Model
Coverage Tool .
Additional Coverage Types
This version adds the following types of coverage analysis:
• Condition coverage
Examines blocks that output the logical combination of their inputs, e.g., the
Logic block, and Stateflow transitions. A test case achieves full coverage if it causes each input to each instance of a logic block in the model and each condition on a transition to be true at least once during the simulation and false at least once during the simulation.
• Modified condition/decision coverage (MC/DC)
Examines blocks that output the logical combination of their inputs, e.g., the
Logic block, and Stateflow transitions to determine the extent to which the test case tests the independence of logical inputs and transition conditions.
• Look-up table (LUT) coverage
Examines blocks, such as the Look-Up Table block, that output the result of looking up one or more inputs in a table of inputs and outputs, interpolating between or extrapolating from table entries as necessary. Lookup table coverage records the frequency that table lookups use at each interpolation interval.
See “Coverage Analysis” in the “Model Coverage Tool” section of Using
Simulink for more information.
New Features
Additional Covered Block Types
This version covers the following additional block types:
• Look-Up Table
• Look-Up Table (2-D)
• Combinatorial Logic
• For
• If
• Logic
• MinMax
• Relay
• SwitchCase
• While
See “Covered Blocks” in the “Model Coverage Tool” section of Using Simulink for more information.
Additional Coverage Reporting Options
This version provides the following additional coverage reporting options:
• Include each test in the model summary
• Produce bar graphs in the model summary
• Use two color bar graphs
• Display hit/count ratio in the model summary
• Don't report fully covered model objects
See “HTML Settings” in the “Model Coverage Tool” section Using Simulink for more information.
Hyperlink Enhancements
When you click a hyperlink to the model in a coverage report, the tool now opens the model, if it is not already open. Hyperlinks to the model in the coverage report now persist across Simulink sessions. This means that you no longer have to regenerate a report in order to use its hyperlinks.
29-3
29
Simulink Performance Tools 1.1 Release Notes
Graphical Merge Tool
This section describes features and enhancements added to the Graphical
Merge Tool since Simulink Performance Tools 1.0 (Release 12.0).
Name Change
The Graphical Merge Tool was known as the Model Differencing Tool in the previous version. The name was changed to reflect the tool’s new model merging capability.
Merging Models
This version not only detects differences between two models but can also optionally merge the differences into either or both models. The merge capability simplifies collaborative development of models. For example, colleagues can each work on separate copies of a model and, when done, use the
Graphical Merge Tool to combine the separate versions. See “Merging Model
Differences” in Using Simulink for more information.
Additional Model Comparison Options
The Simulink Performance Tools 1.0 allowed you two compare two models that both reside in your file system. The Simulink Performance Tools 1.1 allows you to compare an in-memory version of a model to the version last saved on your file system or to a version stored in a source control system. This allows you to determine what modifications you have made to a model before saving it. You can also compare two versions of a model stored in a source control system to determine how they differ. See “Comparing Models” in Using Simulink for more information.
Show and Hide Parameters Panel
This version allows you to show or hide the tool’s Parameters panel. Hiding the panel provides more room for the tool’s color-coded differences display.
Single Scrollbar
The previous version provided separate scrollbars to scroll the difference panels for each model being compared. This version provides a single scrollbar that scrolls both panels simultaneously. This keeps the displays in the two panels aligned, making it easier to compare the two models.
29-4
New Features
Aligned Model Content Displays
This version aligns the display of the contents of the two models so that an item that appears in both models appears at the same relative position in the content pane for each model. If an item appears in only one of the two models, the corresponding position in the other model’s content pane is empty. This visual alignment of the content panels makes it easy to spot differences between the two models. See “Differences Panes” in Using Simulink for more information.
Model History List
This release adds model history lists at the top of each model content pane in the Graphical Merge Tool. Each list displays the four models that have most recently appeared in the associated pane. To compare a model on the list to the model that appears in the other content pane, select the model in the history list and press Return.
29-5
29
Simulink Performance Tools 1.1 Release Notes
Platform Limitations for HP and IBM
Note The Release 12 platform limitation for the Simulink Performance Tools for the HP and IBM platforms still applies to Release 12.1. That limitation is summarized below.
Limited Support Model Coverage Tool
On the HP and IBM platforms, you must use the command line commands, for example, cvsim , cvtest , and cvhtml , to generate and display coverage data.
The tool displays coverage reports in your system’s default browser. The hyperlinks from the report to the model do no work.
Graphical Merge Tool Not Supported
The Graphical Merge Tool is not supported on the HP and IBM platforms.
29-6
30
Simulink Report Generator 1.2
Release Notes
New Features . . . . . . . . . . . . . . . . . . . 30-2
Block Type: Look-Up Table Component Reports on N-D Look-Up Tables . . . . . . . . . . . . . . 30-2
Real-Time Workshop Requirement Removed for Some Components . . . . . . . . . . . . . . 30-2
Image Titles for Snapshot Components . . . . . . . . . . 30-3
Upgrading from an Earlier Release . . . . . . . . . 30-4
Use of Existing SGML Files . . . . . . . . . . . . . . 30-4
30
Simulink Report Generator 1.2 Release Notes
New Features
This section introduces the new features and enhancements added in the
Simulink Report Generator 1.2 since the Simulink Report Generator 1.1
(Release 12.0).
Note The Simulink Report Generator extends the functionality of the
MATLAB Report Generator.
Block Type: Look-Up Table Component Reports on
N-D Look-Up Tables
The Simulink Report Generator 1.2 component Block Type: Look-Up Table allows you to report on the following N-D Simulink look-up tables, in addition to the Look-Up Table and Look-Up Table (2-D) that were supported in earlier releases:
• Look-Up Table (n-D)
• Direct Look-Up Table (n-D)
Note that the table created for the N-D data is a 2-D slice through the N-D data.
Real-Time Workshop Requirement Removed for
Some Components
The By simulation order option for sorting blocks no longer requires having the Real-Time Workshop product installed. The components affected by the removal of the Real-Time Workshop requirement for this option are:
• Block Loop
• Chart Loop
• Fixed-Point Block Loop
• Object Summary Table
Also, the Block Execution Order component no longer requires Real-Time
Workshop.
30-2
New Features
Image Titles for Snapshot Components
You can add titles to images for the System Snapshot and Stateflow Snapshot
(chart) components. This is in addition to the caption option that was available in earlier releases.
30-3
30
Simulink Report Generator 1.2 Release Notes
Upgrading from an Earlier Release
There are no upgrade issues moving from the Simulink Report Generator 1.1 to the Simulink Report Generator 1.2.
The following upgrade issue is involved in moving from the Simulink Report
Generator 1.0 (Release 11.0) to Simulink Report Generator 1.2.
Use of Existing SGML Files
If you generated a report using the Simulink Report Generator 1.0 and saved the report file as an SGML file, and then try to convert that SGML file using the Simulink Report Generator 1.1 rptconvert program, the conversion fails.
In such cases, you need to regenerate the SGML file using the Simulink Report
Generator 1.1.
30-4
Stateflow Coder 4.1
Release Notes
New Features . . . . . . . . . . . . . . . . . . . 31-2
Single-Precision Constants in Code Generation . . . . . . 31-2
Major Bugs Fixes . . . . . . . . . . . . . . . . . . 31-3
Code Generation for Default Transitions in Parallel States . 31-3
Code Generation for Double-Precision Whole Numbers . . . 31-3
31
31
Stateflow Coder 4.1 Release Notes
New Features
This section introduces the new features and enhancements added in Stateflow
Coder 4.1 since the online release of Stateflow Coder 4.0.2 (Release 12).
Note For information on new features in Stateflow 4.1, see the Stateflow 4.1
Release Notes.
For information about the features of Stateflow and Stateflow Coder 4.1 added in prior releases, including Stateflow and Stateflow Coder 4.0 (Release 12), see the What's New link from the Stateflow product page on the MathWorks Web site ( www.mathworks.com
).
Single-Precision Constants in Code Generation
Code generation now emits single-precision constants with a trailing F to the
C-compiler. This results in lower ROM size. For example, the action language statement x = y + single(1.375); now generates the code x = y + 1.375F;.
31-2
Major Bugs Fixes
Major Bugs Fixes
Below is a list of known bugs from Stateflow Coder 4.0.2 that are fixed in
Stateflow Coder 4.1.
Note For information on major bug fixes in Stateflow 4.1, see the Stateflow
4.1 Release Notes.
Code Generation for Default Transitions in Parallel
States
States with Parallel decomposition with default transition paths generated incorrect code in Stateflow Versions 3.0 through 4.0.2.
Code Generation for Double-Precision Whole
Numbers
Double-precision whole numbers were incorrectly emitted as integers (e.g., 5 instead of 5.0) in code generation in Stateflow Versions 3.0 through 4.0.2.
31-3
31
Stateflow Coder 4.1 Release Notes
31-4
System Identification
Toolbox 5.0.1 Release Notes
Upgrading from an Earlier Release . . . . . . . . . 32-2
Syntax of data Function . . . . . . . . . . . . . . . . 32-2
Theta Models No Longer Supported . . . . . . . . . . . 32-2
32
32
System Identification Toolbox 5.0.1 Release Notes
Upgrading from an Earlier Release
There is one new upgrade issue involved in moving from the System
Identification Toolbox 5.0 to the System Identification Toolbox 5.0.1.
Syntax of data Function
The syntax data{...} is no longer supported. Use the functions getexp or merge iddata instead.
Note The following upgrade issue is involved in moving from System
Identification Toolbox 4.0.5 (Release 11.0) to the System Identification Toolbox
5.0.1.
Theta Models No Longer Supported
Theta models (matrices) are no longer supported in the System Identification
Toolbox 5.0. Existing code that uses functions such as th2par and th2ss to access the theta model data will continue to work in the System Identification
Toolbox 5.0. However, if you have code that directly indexes into the theta matrix (e.g., th(1,3) ), that code will no longer work.
32-2
Virtual Reality Toolbox 2.0
Release Notes
Introduction to the Virtual Reality Toolbox . . . . . . 33-2
Simulink Interface . . . . . . . . . . . . . . . . . . 33-2
MATLAB Interface . . . . . . . . . . . . . . . . . . 33-2
Virtual Reality Modeling Language (VRML) . . . . . . . 33-2
VRML Viewing . . . . . . . . . . . . . . . . . . . 33-3
VRML Authoring . . . . . . . . . . . . . . . . . . . 33-3
33
33
Virtual Reality Toolbox 2.0 Release Notes
Introduction to the Virtual Reality Toolbox
The Virtual Reality Toolbox extends the capabilities of MATLAB and Simulink into the world of virtual reality graphics. Using standard Virtual Reality
Modeling Language (VRML) technology, you can create animated three-dimensional scenes that are driven from the MATLAB and Simulink environment.
Simulink Interface
You can observe a simulation of your dynamic system over time in a visually realistic three-dimensional model.
Most of the Virtual Reality Toolbox features can be implemented with
Simulink blocks. Once you include these blocks in a Simulink diagram, they allow you to select the virtual world, which you connect to Simulink signals.
The Virtual Reality Toolbox automatically scans the virtual world for available
VRML nodes that can be driven by Simulink.
MATLAB Interface
The Virtual Reality Toolbox provides a flexible MATLAB interface to a virtual reality world.
Virtual Reality Modeling Language (VRML)
The Virtual Reality Modeling Language (VRML) is an ISO standard that is open, text-based, and uses a WWW-oriented format. You use VRML to define a virtual world that you can display in a Web browser and connect to a Simulink model.
The Virtual Reality Toolbox uses many of the advanced features defined in the current VRML97 specification. The term VRML, in this chapter, always refers to VRML as defined in the VRML97 standard ISO/IEC 14772-1:1997. This format includes a description of three-dimensional scenes, sound, internal actions, and WWW anchors.
33-2
Introduction to the Virtual Reality Toolbox
VRML Viewing
If you install a VRML plug-in, you can view a virtual world in your preferred
Web browser. The Virtual Reality Toolbox includes the popular VRML plug-in, blaxxun Contact.
The Virtual Reality Toolbox connects MATLAB and Simulink with a VRML enabled browser to display a simulated process using the TCP/IP protocol. This allows you to watch a simulated virtual world not only on the computer where
MATLAB and Simulink are running, but also on other computers connected through the Internet.
VRML Authoring
The Virtual Reality Toolbox includes the leading VRML authoring tool,
V-Realm Builder, by Ligos Corp. With the addition of this VRML authoring tool, the Virtual Reality Toolbox provides a complete authoring, development, and working environment for carrying out three-dimensional visual simulations.
Updated Documentation Coming in Printed and
Web-Downloadable Form
The Virtual Reality Toolbox 2.0 documentation included on the Release 12.1
CD represents an early version of the product documentation. This documentation is being updated and will be posted to the MathWorks Web site, where you can download it. When the updated documentation is ready, a printed version will be shipped to all Virtual Reality Toolbox customers.
33-3
33
Virtual Reality Toolbox 2.0 Release Notes
33-4
Wavelet Toolbox 2.1
Release Notes
GUI Improvements . . . . . . . . . . . . . . . . . . 34-2
Major Bug Fixes . . . . . . . . . . . . . . . . . . 34-3
Upgrading from an Earlier Release . . . . . . . . . 34-4
34
34
Wavelet Toolbox 2.1 Release Notes
New Features
This section introduces the new features and enhancements added in the
Wavelet Toolbox 2.1 since the Wavelet Toolbox 2.0 (Release 12.0).
For information about Wavelet Toolbox features that are incorporated from recent releases, see the Release Notes for Release 12.
disp
The new disp method displays information for a WPTREE object.
wavefun2
The new wavefun2 function returns the 2-D scaling and wavelet functions from tensor products of 1-D scaling and wavelet functions.
GUI Improvements
The GUI menus have been reorganized and improved. See Appendix A, “GUI
Reference” in the Wavelet Toolbox User’s Guide for more information.
34-2
Major Bug Fixes
Major Bug Fixes
The Wavelet Toolbox includes several bug fixes, including the following descriptions (online only) of particularly important bug fixes.
34-3
34
Wavelet Toolbox 2.1 Release Notes
Upgrading from an Earlier Release
There are no upgrade issues moving from Wavelet Toolbox 2.0 (Release 12.0) to the Wavelet Toolbox 2.1.
See the Release Notes for Release 12 for upgrade issues involved in moving from the Wavelet Toolbox 1.2 (Release 11.0) to the Wavelet Toolbox 2.1.
34-4
xPC Target 1.2 Release
Notes
New Features . . . . . . . . . . . . . . . . . . . 35-2
C API . . . . . . . . . . . . . . . . . . . . . . . 35-2
UDP Driver Support . . . . . . . . . . . . . . . . . 35-2
Asynchronous Event (Interrupt) Support . . . . . . . . . 35-2
CAN FIFO Support . . . . . . . . . . . . . . . . . . 35-3
100 Mbit/Second Ethernet Support . . . . . . . . . . . 35-3
Fixed-Point Kernel Support . . . . . . . . . . . . . . 35-3
Increased Data Upload Speed . . . . . . . . . . . . . 35-3
I/O Device Driver Support . . . . . . . . . . . . . . . 35-3
Known Software and Documentation Problems . . . . 35-4
Uploading Data with External Mode . . . . . . . . . . . 35-4
Target Command Line Interface . . . . . . . . . . . . 35-4
Memory-Mapped Devices . . . . . . . . . . . . . . . 35-4
Selecting a Working Directory Inside the
MATLAB Root Directory . . . . . . . . . . . . . 35-4
35
35 xPC Target 1.2 Release Notes
New Features
This section introduces the new features and enhancements added to xPC
Target 1.2 and xPC Target Embedded Option 1.2 since Version 1.1 of those products (Release 12.0).
For information about xPC Target and xPC Target Embedded Option features that are incorporated from recent releases, see the Release Notes for Release 12.
C API
A beta version of the xPC Target C API is available from the Product News page at http://www.mathworks.com/support/author/xpc/index.shtml
.
Use the C API to create stand-alone graphical user interfaces (GUIs) or console applications to interact with a real-time target application. xPC Target includes examples for Visual C/C++ and Visual BASIC.
UDP Driver Support
Communicate with another computer using User Datagram Protocol (UDP) packets. Add UDP driver blocks to your Simulink model and configure them for sending and receiving messages from another system.
The UDP driver blocks are not included on the R12.1 CD. Please check the
Product News page at http://www.mathworks.com/support/author/xpc/ index.shtml
for the drivers when they become available.
Asynchronous Event (Interrupt) Support
Create subsystems that execute asynchronously when an event (interrupt) occurs.
These subsystems can communicate and be part of a larger model that executes with a monotonic step size.
We expect to further enhance the Asynchronous Event drivers currently available on the R12.1 CD. Please check the Product News page at http:// www.mathworks.com/support/author/xpc/index.shtml
for the enhanced version.
35-2
New Features
CAN FIFO Support
Use CAN FIFO model I/O drivers to either monitor an entire CAN network, or to minimize driver latency for certain applications.
100 Mbit/Second Ethernet Support
Use 10 or 100 megabit/second communication between the host and target computers for downloading real-time application and uploading signal data.
The communication uses the TCP/IP protocol with an Ethernet card in both the host and target computers.
Fixed-Point Kernel Support
The xPC Target kernel runs on PCs (CPUs) that do not have a hardware floating-point unit. If needed, xPC Target uses a software floating-point emulator.
Increased Data Upload Speed
Upload log data about five times faster or better. Upload scope data about three times faster.
I/O Device Driver Support
xPC Target 1.2 includes new device drivers blocks:
• New blocks to support additional I/O boards
• Blocks to support a GPIB fieldbus using a National Instruments GPIB controller and an RS232 connection to the target PC
• Blocks to support CAN and CAN FIFO networks
35-3
35 xPC Target 1.2 Release Notes
Known Software and Documentation Problems
This section updates the xPC Target 1.2 and xPC Target Embedded Option 1.2 documentation set, reflecting known xPC Target and xPC Target Embedded
Option software and documentation problems.
Uploading Data with External Mode
xPC Target does not support uploading data to normal Simulink scope blocks when using Simulink external mode. Instead, use xPC Target scope blocks or the xPC Target graphical user interface (GUI).
Target Command Line Interface
Visualizing or changing parameter values is limited to scalar parameters.
Memory-Mapped Devices
Some supported boards in the xPC Target I/O library are memory-mapped devices. These memory-mapped boards are accessed in the address space between 640K and 1M in the lower memory area. xPC Target reserves a 112 kB memory space for memory mapped devices in the address range
C0000 - DBFFF
Some drivers for memory-mapped devices allow you to select an address range supported by the device, but not supported by xPC Target. For example, the
CAN drivers for Softing allow you to select memory ranges above DBFFF.
Select a memory range supported by both the device and xPC Target.
Selecting a Working Directory Inside the MATLAB
Root Directory
Before you run the command xpctest , select a current directory outside of the
MABLAB root directory.
During the build process, Real-Time Workshop does not allow files to be saved within the MATLAB root. If you select a current directory within the MATLAB root, the xPC Target test procedure will fail when trying to build a target application.
35-4
advertisement
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project
Related manuals
advertisement