National Instruments 374318A-01 User Manual
Measurement StudioTM
Measurement Computing
User Manual
Measurement Studio for MCC User Manual
TM
Edition
March 2006
374318A-01
Worldwide Technical Support and Product Information
ni.com
National Instruments Corporate Headquarters
11500 North Mopac Expressway Austin, Texas 78759-3504 USA Tel: 512 683 0100
Worldwide Offices
Australia 1800 300 800, Austria 43 0 662 45 79 90 0, Belgium 32 0 2 757 00 20, Brazil 55 11 3262 3599,
Canada 800 433 3488, China 86 21 6555 7838, Czech Republic 420 224 235 774, Denmark 45 45 76 26 00,
Finland 385 0 9 725 725 11, France 33 0 1 48 14 24 24, Germany 49 0 89 741 31 30, India 91 80 41190000,
Israel 972 0 3 6393737, Italy 39 02 413091, Japan 81 3 5472 2970, Korea 82 02 3451 3400,
Lebanon 961 0 1 33 28 28, Malaysia 1800 887710, Mexico 01 800 010 0793, Netherlands 31 0 348 433 466,
New Zealand 0800 553 322, Norway 47 0 66 90 76 60, Poland 48 22 3390150, Portugal 351 210 311 210,
Russia 7 095 783 68 51, Singapore 1800 226 5886, Slovenia 386 3 425 4200, South Africa 27 0 11 805 8197,
Spain 34 91 640 0085, Sweden 46 0 8 587 895 00, Switzerland 41 56 200 51 51, Taiwan 886 02 2377 2222,
Thailand 662 278 6777, United Kingdom 44 0 1635 523545
For further support information, refer to the Contacting Measurement Computing Corp. appendix. To comment
on National Instruments documentation, refer to the National Instruments Web site at
the info code
feedback.
ni.com/info and enter
© 2006 National Instruments Corporation. All rights reserved.
Important Information
Warranty
The media on which you receive National Instruments software are warranted not to fail to execute programming instructions, due to defects
in materials and workmanship, for a period of 90 days from date of shipment, as evidenced by receipts or other documentation. National
Instruments will, at its option, repair or replace software media that do not execute programming instructions if National Instruments receives
notice of such defects during the warranty period. National Instruments does not warrant that the operation of the software shall be
uninterrupted or error free.
A Return Material Authorization (RMA) number must be obtained from the factory and clearly marked on the outside of the package before any
equipment will be accepted for warranty work. National Instruments will pay the shipping costs of returning to the owner parts which are covered by
warranty.
National Instruments believes that the information in this document is accurate. The document has been carefully reviewed for technical accuracy. In
the event that technical or typographical errors exist, National Instruments reserves the right to make changes to subsequent editions of this document
without prior notice to holders of this edition. The reader should consult National Instruments if errors are suspected. In no event shall National
Instruments be liable for any damages arising out of or related to this document or the information contained in it.
E
XCEPT AS SPECIFIED HEREIN, NATIONAL INSTRUMENTS MAKES NO WARRANTIES, EXPRESS OR IMPLIED, AND SPECIFICALLY DISCLAIMS ANY WARRANTY OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. CUSTOMER’S RIGHT TO RECOVER DAMAGES CAUSED BY FAULT OR NEGLIGENCE ON THE PART OF NATIONAL
I
NSTRUMENTS SHALL BE LIMITED TO THE AMOUNT THERETOFORE PAID BY THE CUSTOMER. NATIONAL INSTRUMENTS WILL NOT BE LIABLE FOR DAMAGES RESULTING
FROM LOSS OF DATA, PROFITS, USE OF PRODUCTS, OR INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. This limitation of
the liability of National Instruments will apply regardless of the form of action, whether in contract or tort, including negligence. Any action against
National Instruments must be brought within one year after the cause of action accrues. National Instruments shall not be liable for any delay in
performance due to causes beyond its reasonable control. The warranty provided herein does not cover damages, defects, malfunctions, or service
failures caused by owner’s failure to follow the National Instruments installation, operation, or maintenance instructions; owner’s modification of the
product; owner’s abuse, misuse, or negligent acts; and power failure or surges, fire, flood, accident, actions of third parties, or other events outside
reasonable control.
Copyright
Under the copyright laws, this publication may not be reproduced or transmitted in any form, electronic or mechanical, including photocopying,
recording, storing in an information retrieval system, or translating, in whole or in part, without the prior written consent of National
Instruments Corporation.
National Instruments respects the intellectual property of others, and we ask our users to do the same. NI software is protected by copyright and other
intellectual property laws. Where NI software may be used to reproduce software or other materials belonging to others, you may use NI software only
to reproduce materials that you may reproduce in accordance with the terms of any applicable license or other legal restriction.
Trademarks
National Instruments, NI, ni.com, and LabVIEW are trademarks of National Instruments Corporation. Refer to the Terms of Use section
on ni.com/legal for more information about National Instruments trademarks.
Universal Library and Measurement Computing are trademarks of Measurement Computing Corporation. Other product and company names
mentioned herein are trademarks or trade names of their respective companies.
Patents
For patents covering National Instruments products, refer to the appropriate location: Help»Patents in your software, the patents.txt file
on your CD, or ni.com/patents.
WARNING REGARDING USE OF NATIONAL INSTRUMENTS PRODUCTS
(1) NATIONAL INSTRUMENTS PRODUCTS ARE NOT DESIGNED WITH COMPONENTS AND TESTING FOR A LEVEL OF
RELIABILITY SUITABLE FOR USE IN OR IN CONNECTION WITH SURGICAL IMPLANTS OR AS CRITICAL COMPONENTS IN
ANY LIFE SUPPORT SYSTEMS WHOSE FAILURE TO PERFORM CAN REASONABLY BE EXPECTED TO CAUSE SIGNIFICANT
INJURY TO A HUMAN.
(2) IN ANY APPLICATION, INCLUDING THE ABOVE, RELIABILITY OF OPERATION OF THE SOFTWARE PRODUCTS CAN BE
IMPAIRED BY ADVERSE FACTORS, INCLUDING BUT NOT LIMITED TO FLUCTUATIONS IN ELECTRICAL POWER SUPPLY,
COMPUTER HARDWARE MALFUNCTIONS, COMPUTER OPERATING SYSTEM SOFTWARE FITNESS, FITNESS OF COMPILERS
AND DEVELOPMENT SOFTWARE USED TO DEVELOP AN APPLICATION, INSTALLATION ERRORS, SOFTWARE AND HARDWARE
COMPATIBILITY PROBLEMS, MALFUNCTIONS OR FAILURES OF ELECTRONIC MONITORING OR CONTROL DEVICES,
TRANSIENT FAILURES OF ELECTRONIC SYSTEMS (HARDWARE AND/OR SOFTWARE), UNANTICIPATED USES OR MISUSES, OR
ERRORS ON THE PART OF THE USER OR APPLICATIONS DESIGNER (ADVERSE FACTORS SUCH AS THESE ARE HEREAFTER
COLLECTIVELY TERMED “SYSTEM FAILURES”). ANY APPLICATION WHERE A SYSTEM FAILURE WOULD CREATE A RISK OF
HARM TO PROPERTY OR PERSONS (INCLUDING THE RISK OF BODILY INJURY AND DEATH) SHOULD NOT BE RELIANT SOLELY
UPON ONE FORM OF ELECTRONIC SYSTEM DUE TO THE RISK OF SYSTEM FAILURE. TO AVOID DAMAGE, INJURY, OR DEATH,
THE USER OR APPLICATION DESIGNER MUST TAKE REASONABLY PRUDENT STEPS TO PROTECT AGAINST SYSTEM FAILURES,
INCLUDING BUT NOT LIMITED TO BACK-UP OR SHUT DOWN MECHANISMS. BECAUSE EACH END-USER SYSTEM IS
CUSTOMIZED AND DIFFERS FROM NATIONAL INSTRUMENTS' TESTING PLATFORMS AND BECAUSE A USER OR APPLICATION
DESIGNER MAY USE NATIONAL INSTRUMENTS PRODUCTS IN COMBINATION WITH OTHER PRODUCTS IN A MANNER NOT
EVALUATED OR CONTEMPLATED BY NATIONAL INSTRUMENTS, THE USER OR APPLICATION DESIGNER IS ULTIMATELY
RESPONSIBLE FOR VERIFYING AND VALIDATING THE SUITABILITY OF NATIONAL INSTRUMENTS PRODUCTS WHENEVER
NATIONAL INSTRUMENTS PRODUCTS ARE INCORPORATED IN A SYSTEM OR APPLICATION, INCLUDING, WITHOUT
LIMITATION, THE APPROPRIATE DESIGN, PROCESS AND SAFETY LEVEL OF SUCH SYSTEM OR APPLICATION.
WARNING REGARDING USE OF MEASUREMENT COMPUTING CORPORATION PRODUCTS
MEASUREMENT COMPUTING CORPORATION DOES NOT AUTHORIZE ANY MEASUREMENT COMPUTING CORPORATION
PRODUCT FOR USE IN LIFE SUPPORT SYSTEMS AND/OR DEVICES WITHOUT WRITTEN APPROVAL OF THE CEO OF
MEASUREMENT COMPUTING CORPORATION. LIFE SUPPORT DEVICES/SYSTEMS ARE DEVICES OR SYSTEMS WHICH,
A)ARE INTENDED FOR SURGICAL IMPLANTATION INTO THE BODY, OR B)SUPPORT OR SUSTAIN LIFE AND WHOSE
FAILURE TO PERFORM CAN BE REASONABLY EXPECTED TO RESULT IN INJURY. MEASUREMENT COMPUTING
CORPORATION PRODUCTS ARE NOT DESIGNED WITH THE COMPONENTS REQUIRED, AND ARE NOT SUBJECT TO THE
TESTING REQUIRED TO ENSURE A LEVEL OF RELIABILITY SUITABLE FOR THE TREATMENT AND DIAGNOSIS OF PEOPLE.
Contents
About This Manual
How To Use this Manual ...............................................................................................ix
Conventions ...................................................................................................................x
Chapter 1
Introduction to Measurement Studio Measurement Computing Edition
Installation Requirements ..............................................................................................1-1
Deployment Requirements ............................................................................................1-2
Installing Measurement Studio ......................................................................................1-2
Measurement Studio Features........................................................................................1-4
Measurement Studio Resources.....................................................................................1-4
Chapter 2
Measurement Studio Measurement Computing Edition .NET Class
Libraries
Measurement Studio Support for Visual Studio .NET 2003
Class Library Overview ..............................................................................................2-1
Analysis .........................................................................................................................2-2
Measurements..................................................................................................2-2
Signal Generation ............................................................................................2-2
Windowing ......................................................................................................2-3
Filters...............................................................................................................2-3
Signal Processing.............................................................................................2-4
Linear Algebra.................................................................................................2-4
Array and Numeric Operations .......................................................................2-5
Curve Fitting....................................................................................................2-5
Statistics...........................................................................................................2-6
Common.........................................................................................................................2-6
MCC-488.2 ....................................................................................................................2-7
Universal Library...........................................................................................................2-7
MccDaq Scan Components............................................................................................2-7
User Interface.................................................................................................................2-8
Windows Forms Controls ..............................................................................................2-9
Waveform Graph and Scatter Graph Controls ................................................2-10
Digital Waveform Graph Control....................................................................2-12
Complex Graph Control ..................................................................................2-13
Legend Control................................................................................................2-15
Numeric Controls ............................................................................................2-15
© National Instruments Corporation v Measurement Studio for MCC User Manual
Contents
Numeric Edit Control...................................................................................... 2-17
Switch and LED Controls ...............................................................................2-18
Property Editor Control................................................................................... 2-19
Measurement Studio Support for Visual Studio 2005 Class Library Overview ........... 2-20
Windows Forms Array Controls ................................................................................... 2-20
Switch and LED Array Controls ..................................................................... 2-21
Numeric Edit Array Control ........................................................................... 2-22
ASP.NET Web Forms Controls .................................................................................... 2-23
Waveform Graph and Scatter Graph Controls................................................ 2-24
Digital Waveform Graph Control ................................................................... 2-26
Complex Graph Control.................................................................................. 2-28
Legend Control ............................................................................................... 2-29
Numeric Controls............................................................................................ 2-29
Numeric Edit Control...................................................................................... 2-32
Switch and LED Controls ...............................................................................2-33
AutoRefresh Control ....................................................................................... 2-33
Chapter 3
Measurement Studio Integrated Tools and Features
Measurement Studio Menu............................................................................................ 3-1
Creating a Measurement Studio Project........................................................................ 3-2
Adding or Removing Measurement Studio Class Libraries.......................................... 3-3
Chapter 4
Getting Started with Measurement Studio
Measurement Studio Walkthroughs for Visual Studio .NET 2003............................... 4-1
Walkthrough: Creating a Measurement Studio Application with
Windows Forms Controls and Analysis in Visual Studio .NET 2003 ....................... 4-2
Walkthrough: Creating a Measurement Studio Measurement
Computing DAQ Application in Visual Studio .NET 2003 ....................................... 4-10
Walkthrough: Creating a Measurement Studio MCCDaq Scan
Components Application in Visual Studio .NET 2003 .............................................. 4-16
Walkthrough: Creating a Measurement Studio MCC-488.2
Application in Visual Studio .NET 2003.................................................................... 4-23
Measurement Studio Walkthroughs for Visual Studio 2005......................................... 4-28
Walkthrough: Creating a Measurement Studio Application with
Windows Forms Controls and Analysis in Visual Studio 2005 ................................. 4-29
Walkthrough: Creating a Measurement Studio Application with
Web Forms Controls and Analysis in Visual Studio 2005......................................... 4-39
Measurement Studio for MCC User Manual vi ni.com
Appendix A
Contacting Measurement Computing Corp.
Glossary
Index
Contents
© National Instruments Corporation vii Measurement Studio for MCC User Manual
About This Manual
The Measurement Studio Measurement Computing Edition User Manual
introduces the concepts associated with the Measurement Studio class
libraries and development tools. This manual assumes that you have a
general working knowledge of Microsoft Visual Studio, including .NET
Windows and ASP.NET.
How To Use this Manual
Measurement Studio 8.0.1 includes one CD with support for both Visual
Studio .NET 2003 and Visual Studio 2005. This manual documents the
Measurement Studio for Visual Studio 2003/2005 CD. The Measurement
Studio support for Visual Studio .NET 2003 and Visual Studio 2005 CD
includes separate, parallel sets of class libraries, integration features, and
support documentation for developing with Visual Studio .NET 2003 and
Visual Studio 2005.
The Measurement Studio Measurement Computing Edition User Manual is
organized into four chapters. Chapter 1, Introduction to Measurement
Studio Measurement Computing Edition, is an overview of Measurement
Studio Measurement Computing Edition. This chapter includes installation
and deployment requirements, installation instructions, and a list of
Measurement Studio resources. Chapter 2, Measurement Studio
Measurement Computing Edition .NET Class Libraries, includes
information about the .NET class libraries. Chapter 3, Measurement Studio
Integrated Tools and Features, includes information on using
Measurement Studio Measurement Computing Edition tools and features
integrated into the Visual Studio environment. Chapter 4, Getting Started
with Measurement Studio, includes walkthroughs that guide you through
step-by-step instructions on how to develop with Measurement Studio
features.
Use this manual as a starting point to learn about Measurement Studio.
Refer to the NI Measurement Studio Help within the Visual Studio
environment for function reference and detailed information about the
Measurement Studio class libraries, wizards, assistants, and other features.
© National Instruments Corporation ix Measurement Studio for MCC User Manual
About This Manual
Conventions
The following conventions appear in this manual:
<> Text enclosed in angle brackets represents directory names and parts of
paths that may vary on different computers, such as <
» The » symbol leads you through nested menu items and dialog box options
to a final action. The sequence File»Page Setup»Options directs you to
pull down the File menu, select the Page Setup item, and select Options
from the last dialog box.
This icon denotes a tip, which alerts you to advisory information.
This icon denotes a note, which alerts you to important information.
bold Bold text denotes items that you must select or click on in the software,
such as menu items and dialog box options. Bold text also denotes class
library member names or emphasis.
italic Italic text denotes parameters, variables, cross-references, or an
introduction to a key concept. Italic text also denotes text that is a
placeholder for a word or value that you must supply.
Windows\System>.
monospace Text in this font denotes text or characters that you enter from the keyboard,
sections of code, programming examples, and syntax examples. This font
also is used for the proper names of disk drives, paths, directories,
programs, device names, filenames and extensions, and code excerpts.
Measurement Studio for MCC User Manual x ni.com
Introduction to Measurement
Studio Measurement Computing
Edition
Measurement Studio Measurement Computing Edition is an integrated
suite of tools and class libraries that are designed for developers using .NET
Windows and ASP.NET to develop measurement and automation
applications.
Measurement Studio Measurement Computing Edition dramatically
reduces application development time through object-oriented
measurement hardware interfaces, advanced analysis libraries, scientific
user interface controls for Windows and Web applications, wizards,
interactive code designers, and highly extensible .NET classes. You can use
Measurement Studio Measurement Computing Edition to develop a
complete measurement and automation application that includes data
acquisition, analysis, and presentation functionalities.
1
The Measurement Studio Measurement Computing Edition package
includes two CDs—one with Measurement Studio 8.0.1 and the other with
Measurement Computing device drivers. This manual documents the
Measurement Studio Measurement Computing Edition CD, which includes
separate, parallel sets of Measurement Studio class libraries and support
documentation for developing with Visual Studio .NET 2003 and Visual
Studio 2005.
Installation Requirements
To install Measurement Studio, your computer must have the following:
• Microsoft Windows 2000/XP
• Microsoft .NET Framework 1.1 for Visual Studio .NET 2003 or
Microsoft .NET Framework 2.0 for Visual Studio 2005
• Standard, Professional, Enterprise Developer, Enterprise Architect, or
Academic edition of Microsoft Visual Studio .NET 2003 and
Microsoft Visual Studio 2005 (required to use the Measurement Studio
© National Instruments Corporation 1-1 Measurement Studio for MCC User Manual
Chapter 1 Introduction to Measurement Studio Measurement Computing Edition
integrated tools) or Visual C#, Visual Basic, or Visual C++ Express
Editions of Microsoft Visual Studio 2005
Measurement Studio integration tools are not supported in the Visual
Studio 2005 Express Editions.
• Intel Pentium II class processor, 733 MHz or higher
• Video display—800 × 600, 256 colors (16-bit color recommended for
user interface controls)
• Minimum of 256 MB of RAM (512 MB or higher recommended)
• Minimum of 405 MB of free hard disk space for Visual Studio .NET
2003 support and minimum of 385 MB of free hard disk space for
Visual Studio 2005 support
• Microsoft-compatible mouse
• Microsoft Internet Explorer 6.0 or later
Optional Installation—In order for links from Measurement Studio help
topics to .NET Framework help topics to work, you must install the
Microsoft .NET Framework SDK 1.1 for Visual Studio .NET 2003 or
Microsoft .NET Framework SDK 2.0 for Visual Studio 2005.
Deployment Requirements
To deploy an application built with Measurement Studio .NET class
libraries, the target computer must have a Windows 2000/XP operating
system and the .NET Framework version 1.1 for Visual Studio .NET 2003
or the .NET Framework version 2.0 for Visual Studio 2005.
Installing Measurement Studio
Complete the following steps to install Measurement Studio. These steps
describe a typical installation. Please carefully review all additional
licensing and warning dialog boxes.
Note There are separate installers for Measurement Studio support for Visual Studio
.NET 2003 and Measurement Studio support for Visual Studio 2005. Repeat the
installation instructions to install support for both.
1. Insert the Measurement Studio CD into the CD drive.
automatically starts. If it does not automatically start, double-click the
autorun.exe icon.
Measurement Studio for MCC User Manual 1-2 ni.com
autorun.exe
Chapter 1 Introduction to Measurement Studio Measurement Computing Edition
2. Click Install NI Measurement Studio for Visual Studio .NET 2003
or click Install NI Measurement Studio for Visual Studio 2005.
3. Click Next to install all NI software to the default installation
directory, or click Browse to select a different installation directory.
You must install Measurement Studio to a local drive. Click Next.
Note The option to browse for an installation location is valid only if you have not already
installed any Measurement Studio features. If you have any Measurement Studio features
installed, then Measurement Studio installs to the same root directory to which you
installed other Measurement Studio features.
4. From the feature tree, select the features you want to install. To change
the Measurement Studio installation directory, select the first feature in
the list and click Browse. Click Next.
5. Review the license agreement and select I accept the License
Agreement(s). Click Next.
6. In the Installation Summary dialog box, review the features you
selected. Click Next.
Note Step 8 starts the installation of Measurement Studio. Be aware that when the installer
indicates that it is removing backup files, this is a normal operation. The installer may take
several minutes to complete this step.
7. If prompted, insert the Device Drivers CD and select Rescan Drive.
If not prompted, go to step 13 on this list.
8. From the feature tree, select the Device Drivers components you want
to install. To change a driver installation directory, select the driver and
click Browse. Click Next.
9. In the Product Information dialog box, carefully review important
information about the features you are installing. Click Next.
10. If there is a license agreement associated with the driver software,
review the license agreement and select I accept the License
Agreement(s). Click Next.
11. In the Installation Summary dialog box, review the features you
selected. Click Next.
12. Click Next to complete the installation.
13. If prompted, click the appropriate restart option. If you did not install
a component that requires a restart, you will not be prompted to restart.
© National Instruments Corporation 1-3 Measurement Studio for MCC User Manual
Chapter 1 Introduction to Measurement Studio Measurement Computing Edition
Measurement Studio Features
The following list contains features included in Measurement Studio. Refer
to
mccdaq.com/mstudio for more information about the features and
functionality included in Measurement Studio.
• Windows Forms user interface controls
• Web Forms user interface controls
• Analysis class library
• Universal Library class library
• MccDaq Scan Components class library
• GPIB class library
Measurement Studio Resources
As you work with Measurement Studio, you might need to consult other
resources. For detailed Measurement Studio help, including function
reference and in-depth documentation on developing with Measurement
Studio, refer to the NI Measurement Studio Help within the Visual Studio
environment. The NI Measurement Studio Help is fully integrated with the
Visual Studio help. You must have Visual Studio installed to view the
online help, and you must have the Microsoft .NET Framework SDK 1.1
for Visual Studio .NET 2003 or the Microsoft .NET Framework SDK 2.0
for Visual Studio 2005 installed in order for links from Measurement
Studio help topics to .NET Framework help topics to work. You can launch
the NI Measurement Studio Help in the following ways:
• From the Windows Start menu, select Start»All Programs»
National Instruments»<Measurement Studio>»Measurement
Studio Documentation. The help launches in a stand-alone help
viewer.
• From Visual Studio, select Help»Contents to view the Visual Studio
table of contents. The NI Measurement Studio Help is listed in the table
of contents.
• From Visual Studio, select Measurement Studio»NI Measurement
Studio Help. The help launches within the application.
Tip As you work through this manual, you will see italicized references to relevant help
topics. To find these topics, use the table of contents in the NI Measurement Studio Help.
Measurement Studio for MCC User Manual 1-4 ni.com
Chapter 1 Introduction to Measurement Studio Measurement Computing Edition
The following resources also are available to provide you with information
about Measurement Studio.
• Examples—Measurement Studio installs examples to the following
paths:
– Visual Basic .NET or Visual C#—
Instruments\<MeasurementStudio>\DotNET\Examples
Program Files\National
• Measurement Computing Technical Support—Refer to Appendix A,
Contacting Measurement Computing Corp., for more information.
• Measurement Studio Measurement Computing Edition Web site,
mccdaq.com/mstudio—Contains Measurement Studio news,
support, and downloads.
• NI Developer Zone,
zone.ni.com—Provides access to online
example programs, tutorials, technical news, and a Discussion Forum
where you can participate in Measurement Studio discussion forums
for Visual Basic 6.0, Visual C++, and .NET languages.
© National Instruments Corporation 1-5 Measurement Studio for MCC User Manual
2
Measurement Studio
Measurement Computing
Edition .NET Class Libraries
This chapter provides overview information about the .NET class libraries
included with Measurement Studio Measurement Computing Edition
support for Visual Studio .NET 2003 and Visual Studio 2005. Refer to the
Using the Measurement Studio .NET Class Libraries section of the
NI Measurement Studio Help for detailed information about these libraries.
Refer to Chapter 4, Getting Started with Measurement Studio, for
step-by-step instructions on developing applications with these libraries.
Measurement Studio Support for Visual Studio .NET 2003 Class Library Overview
• Analysis
• Common
• MCC-488.2
• Universal Library
• MccDaq Scan Components
• User Interface
Refer to the following sections for information about each Measurement
Studio .NET class library.
© National Instruments Corporation 2-1 Measurement Studio for MCC User Manual
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
Analysis
The Measurement Studio Analysis .NET class library is in the
NationalInstruments.Analysis namespace. The Analysis class
library includes a set of classes that provides various digital signal
processing, signal filtering, signal generation, peak detection, and other
general mathematical functionality. Use this library to analyze acquired
data or to generate data.
The Analysis class library includes the following functionality:
• Sawtooth, sine, square, triangle, and basic function wave generators.
• Bessel, Chebyshev, Inverse Chebyshev, Windowed, Kaiser, and
Elliptic Low, High, Bandpass, and Bandstop filters
• Signal processing functions such as convolution, deconvolution,
correlation, decimation, integration, and differentiation
• FFT, Inverse FFT, Real FFT, Fast Hartley, Inverse Fast Hartley, Fast
Hilbert, Inverse Fast Hilbert, DST, Inverse DST, DCT, and Inverse
DCT transformations
• Linear algebra functions such as determinant, check positive
definiteness, calculate dot product, and other various matrix functions
• Scaled and unscaled windowing classes
• Common statistical functions such as mean, median, mode, and
variance
• Exponential, linear, and polynomial curve fitting functions
• Signal generation functions
Refer to the following lists to determine the type of measurements available
in the Analysis .NET libraries.
Measurements
• Impulse Response Function
• Network Functions (avg)
Signal Generation
• Arbitrary Wave
• Chirp Pattern
• Gaussian White Noise
• Sine Pattern
Measurement Studio for MCC User Manual 2-2 ni.com
Windowing
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
•Sine Wave
•Square Wave
• Triangle Wave
• Uniform White Noise
• Blackman Window
• Blackman-Harris Window
• Blackman-Nuttall Window
• Cosine Tapered window
• Dolph-Chebyshev Window
• Exact Blackman Window
• Exponential Window
• Flat Top Window
• Force Window
• Gauss Window
• General Cosine Window
• Hamming Window
• Hanning Window
•Kaiser Window
• Scaled Time Domain Windows
• Symmetric Time Domain Windows
• Triangle Window
Filters
• Bessel
• Butterworth
• Cascade
•Chebyshev
• Elliptic
•FIR
• FIR Windowed
•IIR
© National Instruments Corporation 2-3 Measurement Studio for MCC User Manual
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
• IIR Cascade
• Inverse Chebyshev
•Kaiser
Signal Processing
• Autocorrelation
• Convolution
•Cross Power
• Cross Correlation
• Decimate
• Deconvolution
• Derivative x(t)
• Discrete Cosine Transform
• Discrete Sine Transform
• Fast Hartley Transform
• Fast Hilbert Transform
• Integral x(t)
• Inverse Fast Hartley Transform
• Inverse Fast Hilbert Transform
• Peak Detection
• Power Spectrum
• Pulse Parameters
• Real and Complex FFT
• Threshold Peak Detector
Linear Algebra
• Complex Determinant
• Complex Dot Product
• Complex Matrix Condition Number
• Complex Matrix Norm
• Complex Matrix Rank
• Complex Outer Product
• Complex Pseudo Inverse Matrix
Measurement Studio for MCC User Manual 2-4 ni.com
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
• Determinant
• Dot Product
• Inverse Matrix
• Matrix Condition Number
• Matrix Multiplication
•Matrix Norm
• Matrix Rank
• Outer Product
• Pseudo Inverse Matrix
• Special Matrix
• Test Positive Definite Matrix
• Trace
• Transpose
Array and Numeric Operations
• 1D and 2D Array Arithmetic
• 1D and 2D Linear Evaluation
• Evaluation
• 1D Polar to Rectangular
• 1D Rectangular to Polar
• Complex Number Arithmetic
• Find Polynomial Roots
• Scale 1D and 2D
Curve Fitting
• Exponential Fit
• General Least Squares Linear Fit
• General Polynomial Fit
• Linear Fit
• Nonlinear Fit
© National Instruments Corporation 2-5 Measurement Studio for MCC User Manual
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
Statistics
• Histogram
• Mean
• Median and Mode
• Moment about Mean
Tip For more information about analyzing or generating data with the Analysis class
library, refer to the Using the Measurement Studio Analysis .NET Library topic in the
NI Measurement Studio Help. For more information about the functionality included in the
Analysis class library, visit
ni.com/analysis and select Analysis in Measurement
Studio.
Common
The Measurement Studio Common .NET class library is in the
NationalInstruments namespace. The Common class library provides
a set of classes that facilitates the exchange of data between the acquisition,
analysis, and user interface portions of your application. The Common
class library includes the following features:
•A
ComplexDouble data type. This data type represents a complex
number of type
imaginary part.
•A
DigitalWaveform data type. This data type represents a set of
digital states that are grouped by samples or signals.
•An
AnalogWaveform data type. This data type represents an analog
signal that varies over time.
•A
DataConverter class that converts data from one data type to
another data type, such as converting an array of integers to an array of
doubles.
•An
EngineeringFormatInfo class that defines a custom formatter
to format numeric values as strings with engineering notation and
International System of Units (SI) prefixes and symbols.
Double that is composed of a real part and an
Tip For more detailed information about the Common class library, refer to the
NationalInstruments section in the NI Measurement Studio Help.
Measurement Studio for MCC User Manual 2-6 ni.com
MCC-488.2
The Measurement Studio MCC-488.2 .NET class library is in the
MccDaq.Mcc4882 namespace. This class library is included when you
install the MCC-488.2 driver. The MCC-488.2 class library includes a set
of classes for communicating with GPIB instruments, controlling GPIB
devices, and acquiring GPIB status information. Use this library to design
code that communicates with and controls instruments on a GPIB interface.
Use the MCC-488.2 class library to configure and communicate with GPIB
devices using the
Universal Library
The Measurement Studio Universal Library .NET class library is in the
MccDaq namespace. This class library is included when you install the
Universal Library driver. Use the Universal Library class library to
communicate with and control Measurement Computing data acquisition
(DAQ) devices.
Use the Universal Library class library to perform the following types of
tasks:
• Analog signal measurement
• Analog signal generation
• Digital I/O
• Counting and timing
• Temperature measurement
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
Device and Board classes.
MccDaq Scan Components
The Measurement Studio Scan Components .NET class library is in the
MccDaq.ScanComponents namespace. The MccDaq Scan Components
library includes a set of components for reading and writing multiple
channels of analog data.
Use the MccDaq Scan Components library to perform the following types
of tasks:
• Analog input scans
• Analog output scans
© National Instruments Corporation 2-7 Measurement Studio for MCC User Manual
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
User Interface
The Measurement Studio user interface controls are in the Windows Forms
and Web Forms .NET class libraries. Refer to Table 2-1 for the UI controls
provided by Measurement Studio.
Table 2-1. Measurement Studio User Interface Controls
User Interface
Controls
Windows Forms Web Forms Windows Forms
Waveform graph ✔ ✔ ✔
Scatter graph ✔ ✔ ✔
Digital waveform
graph
Complex graph ✔ ✔ ✔
Legend ✔ ✔ ✔
Knob ✔ ✔ ✔
Gauge ✔ ✔ ✔
Meter ✔ ✔ ✔
Slide ✔ ✔ ✔
Thermometer ✔ ✔ ✔
Tank ✔ ✔ ✔
Numeric edit ✔ ✔ ✔
Switch ✔ ✔ ✔
Visual Studio 2005
✔ ✔ ✔
Visual Studio
.NET 2003
LED ✔ ✔ ✔
Property editor ✔ ✔
Array controls ✔
AutoRefresh control ✔
Measurement Studio for MCC User Manual 2-8 ni.com
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
Windows Forms Controls
The Measurement Studio user interface controls are in the Windows Forms
.NET class library. The Windows Forms .NET class library is in the
NationalInstruments.UI.WindowsForms namespace. The Windows
Forms class library encapsulates the following Measurement Studio user
interface controls:
• Waveform graph
• Scatter graph
• Digital waveform graph
• Complex graph
•Legend
• Knob
•Gauge
• Meter
•Slide
• Thermometer
•Tank
• Numeric edit
• Switch
•LED
• Property editor
Use this class library to add measurement-specific user interface controls
to your application. You can configure the controls programmatically at
design time, through the Properties window in the Windows Forms
Designer, or at run time with the property editor control. The following
sections describe each of the Measurement Studio Windows Forms user
interface controls.
Tip For more information about easily using the .NET user interface controls,
refer to the Using the Measurement Studio Windows Forms .NET Controls section in the
NI Measurement Studio Help.
© National Instruments Corporation 2-9 Measurement Studio for MCC User Manual
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
Waveform Graph and Scatter Graph Controls
Use the Measurement Studio waveform graph and scatter graph controls, as
shown in Figure 2-1, to display two-dimensional data on a Windows Forms
user interface. Use the waveform graph to display two-dimensional linear
data. You explicitly specify each value in one dimension and provide an
initial value and interval to implicitly specify the values in the other
dimension. Use the scatter graph to display two-dimensional linear or
nonlinear data. You explicitly specify each value in both dimensions.
Figure 2-1. Windows Forms Waveform Graph Control with Cursors and Windows
Forms Scatter Graph Control with XY Point Annotation; Both Graphs Have
Corresponding Legends
With the waveform graph and scatter graph controls and the classes that
interface with the controls, you can perform the following operations:
Plot Operations
• Plot and chart data.
• Configure a graph to contain multiple plots to show separate but
related data on the same graph.
• Draw lines or fills from a plot to an X value, Y value, or another plot.
Measurement Studio for MCC User Manual 2-10 ni.com
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
• Specify plots in the scatter graph control as X and Y data. Specify plots
in the waveform graph control as X or Y data and optionally with date
and time scaling.
• Use the extensible plot and plot area drawing capabilities and events to
customize the graph appearance.
• Use plot data tooltips to display X and Y coordinates when a user
hovers the mouse over a data point.
• Create custom point and line styles for plots.
• Specify anti-aliased plots for plot lines.
Axis Operations
• Configure a graph to include multiple axes or independent ranges so
that plot data fits the graph plot area.
• Configure the axis modes to fixed, exact autoscaling, loose
autoscaling, strip chart, or scope chart.
• Use logarithmic axes with configurable bases.
• Interactively change the range of an axis and invert the axis at run time
by clicking on the axis end labels.
Cursor Operations
• Use cursors to identify key points in plots and the plot area.
• Configure cursor snap modes to be fixed, floating, nearest point, or to
plot.
• Use cursor labels to display X and Y data coordinates that the cursor
crosshair points to, and customize the text font and colors of the label.
• Create custom point and line styles for cursors.
Annotation Operations
• Configure text labels, arrows, and drawing shapes to annotate a point
anywhere in the plot area of the graph.
• Configure range area, text labels, and arrows to annotate a range in the
plot area of the graph.
Additional Operations
• Pan and zoom interactively.
• Configure major, minor, and custom divisions and origin lines.
© National Instruments Corporation 2-11 Measurement Studio for MCC User Manual
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
• Copy the graph as a BMP, GIF, JPEG, or PNG image to the clipboard
or a file.
Tip For more information about using the waveform and scatter graph controls, refer to
the Using the Measurement Studio Windows Forms Scatter and Waveform Graph .NET
Controls section in the NI Measurement Studio Help.
Digital Waveform Graph Control
Use the Measurement Studio digital waveform graph control, as shown in
Figure 2-2, to display
interface.
DigitalWaveform data on a Windows Forms user
Figure 2-2. Windows Forms Digital Graph Control
With the digital waveform graph control and the classes that interface with
the control, you can perform the following operations:
Plot Operations
• Plot digital waveform data. Data values can represent up to eight
different digital states.
• Configure plot labels on the y-axis.
• Configure plot templates to customize plots that are implicitly created
from plotted data.
Measurement Studio for MCC User Manual 2-12 ni.com
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
• Specify anti-aliased digital plots.
• Expand and collapse signal plots interactively.
Waveform Sample and Signal State Operations
• Simultaneously display waveforms and signals or display signals only.
• Create custom waveform sample and signal state styles.
• Configure sample and state labels.
• Create custom waveform sample and signal state labels.
Axis Operations
• Configure the axis modes to fixed, exact autoscaling, or loose
autoscaling.
• Interactively change the range of an axis and invert the axis at run time
by clicking on the axis end labels.
Additional Operations
• Display data in sample or time mode.
• Pan with scroll bars.
• Configure the style and mode of scroll bars.
• Create custom scroll bars.
• Pan and zoom interactively.
• Configure major, minor, and custom divisions.
• Copy the graph as a BMP, GIF, JPEG, or PNG image to the clipboard
or a file.
Tip For more information about using the digital waveform graph control, refer to the
Using the Measurement Studio Windows Forms Digital Waveform Graph .NET Control
section in the NI Measurement Studio Help.
Complex Graph Control
Use the Measurement Studio complex graph control, as shown in
Figure 2-3, to display
interface. A
© National Instruments Corporation 2-13 Measurement Studio for MCC User Manual
ComplexDouble consists of a real part and an imaginary part.
ComplexDouble data on a Windows Forms user
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
Figure 2-3. Windows Forms Complex Graph Control
With the complex graph control and the classes that interface with the
control, you can perform the following operations:
Plot Operations
• Plot and chart ComplexDouble data.
• Configure a graph to contain multiple plots to show separate but
related data on the same graph.
• Draw lines or fills from a plot to an X value, Y value, or another plot.
• Use the extensible plot and plot area drawing capabilities and events to
customize the graph appearance.
• Configure the plot to display arrows. The arrows indicate the direction
of the complex data.
• Create custom point and line styles for plots.
• Specify anti-aliased plots for plot lines.
Axis Operations
• Configure a graph to include multiple axes or independent ranges so
that plot data fits the graph plot area.
• Configure the axis modes to fixed, exact autoscaling, loose
autoscaling, strip chart, or scope chart.
• Interactively change the range of an axis and invert the axis at run time
by clicking on the axis end labels.
Measurement Studio for MCC User Manual 2-14 ni.com
Tip For more information about using the complex graph control, refer to the Using
the Measurement Studio Windows Forms Complex Graph .NET Control section in the
NI Measurement Studio Help.
Legend Control
Tip For more information about using the legend control, refer to the Using the
Measurement Studio Windows Forms Legend .NET Control section in the NI Measurement
Studio Help.
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
Additional Operations
• Pan and zoom interactively.
• Configure major, minor, and custom divisions and origin lines.
• Copy the graph as a BMP, GIF, JPEG, or PNG image to the clipboard
or a file.
Use the Measurement Studio legend control, as shown in Figure 2-1, to
display symbols and descriptions for a specific set of elements of another
object, such as the plots or cursors of a graph. When you associate the
legend control with another object, any changes you make to that object are
automatically reflected in the legend. For example, if you associate the
legend control with the plots of a graph, any changes you make in the plots
collection editor are automatically reflected in the legend.
Numeric Controls
Use the Measurement Studio numeric controls to display numerical
information, on a Windows Forms user interface, with the look of scientific
instruments. The numeric controls include a knob, gauge, meter, slide,
thermometer, and tank. The following sections describe operations
available with the controls and the classes that interface with them.
With all of the numeric controls and the classes that interface with them,
you can perform the following operations:
• Configure the scale to be linear or logarithmic and toggle the visibility
of the scale.
• Fill the scale and configure the range, color, dimensions, and style of
the fill.
• Connect to the Measurement Studio .NET numeric edit control so that
if you change the value of one control, it changes the value of the other
control.
© National Instruments Corporation 2-15 Measurement Studio for MCC User Manual
Chapter 2 Measurement Studio Measurement Computing Edition .NET Class Libraries
• Customize the appearance of the control using 3D lab styles or classic
2D styles and change the color and length of ticks and labels.
• Configure the format of value labels to engineering or date/time.
Use the Measurement Studio knob, gauge, and meter controls, as shown in
Figure 2-4, to input and display numeric data on your user interface.
Figure 2-4. Windows Forms Knob, Gauge, and Meter Controls
With the knob, gauge, and meter controls and the classes that interface with
the controls, you can perform the following operations:
• Specify the start and sweep angle of the arc programmatically or from
the Properties window.
• Use automatic division spacing, custom divisions, and invert the scale.
Use the Measurement Studio slide, tank, and thermometer controls, as
shown in Figure 2-5, to input and display numeric data on your interface.
Figure 2-5. Windows Forms Slide, Tank, and Thermometer Controls
Measurement Studio for MCC User Manual 2-16 ni.com
Loading...