Following the line of the article posted by A.Riazi, Solving engineering problem using MATLAB C API, I will show in this small example how to use M Functions inside our VC++ 6 project.
The project calculates the convolution of two vectors, and shows the resulting vector in the MsChart control. The function that performs the convolution is written in MatLab and then through the MatLab Add-in converted to C code ready to be used inside our app.
You need Visual Studio 6 and MatLab Release 12 installed with the MatLab C Library and Matlab Compiler.
Installing the MatLab Add-in
The add-in automates the integration of M-files into Visual C++ projects. The add-in for Visual Studio is automatically installed on your system when you run either mbuild -setup or mex -setup and select Microsoft Visual C/C++ version 6. In order to use the add-in you must follow these steps:
- Start MatLab, in the prompt type mbuild -setup
- Follow the menus and choose MS Visual C++6.0.
- Type the following commands in the matlab prompt :
These commands save the MatLab path to a file called mccpath in your user preferences directory (prefdir), ussually inside your documents and settings file. The path is used by the add-in because it runs outside Matlab and there is no other way for it to determine your Matlab path. If you add new directories to your Matlab path you will have to rerun this command if you want the add-in to see them.
- Configure the Matlab Add-in for Visual Studio 6 to work within MSVisual C++.
- Open MSVisualC++.
- Select Tools -> Customize from the MSVC menu.
- Click on the Add-ins and Macro Files tab.
- Check MATLAB for Visual Studio on the Add-ins and Macro Files list and click Close.
The floating MATLAB add-in for Visual Studio toolbar appears. The checkmark directs MSVC to automatically load the add-in when you start MSVC again.
Calculating the convolution in Matlab
We will write a simple function in MatLab that will perform the convolution of two vectors:
In2 and store the result in
We actually can use any matlab built-in function or toolbox function inside our function here we use only the function conv for simplicity.
%Returns the convolution of vector IN1 and IN2
Save the function with the name MyFunc.m
Writing the Application
Use the MFC AppWizard (exe) option to generate a Dialog Based Application and call it conv. Create a Button which will calculate the convolution of two given vectors.
Add the code below to the button's Message Handler.
Copy MyFunc.m into your VC++ project directory. Now go to the MatLab Add-in and click the .m++ (Add m-files to current project) button:
Select Windows Console Exe from the Combo Box and check Generate main file and debug mode. Press OK.
Then select the MyFunc.m file and click Open. After a while you will see new files added to your project.
Under MATLAB M-files you will see our MyFunc.m, you can even edit it from inside Visual C++. Under MATLAB C/C++ are MyFunc.c and MyFunc_main.c, generated by the MatLab Compiler. And all the headers needed by the compiler.
We can't build the app yet, we must add the following lines to convDlg.cpp:
Now the project should be built without any problem.
Points of Interest
The steps described here don't include the MSChart part, you can see it from the source code, but you can see that the calculation is done by placing a breakpoint inside the button message handler and checking the value of the
res vector after the line:
Well I hope this simple article be interesting for MatLab lovers, this is the first article I wrote, so I apologize if it is not clear enough. I will be glad to explain anything if you ask me. Greetings.
Daniel Cespedes is now working on his final project to get the Electrical Engineering degree at the National University of Technology in Cordoba Argentina. He is developing a Computerized system for the study of Human Echolocation, the ability to detect obstacles with the echoes of self generated sounds.(yes like bats!!) at the CINTRA (Centro de Investigación y Transferencia Acústica).He uses MsVisual C++ 6 as a developing tool. He also work at the Software Research Lab at the University.
He comes from Sta.Cruz de la Sierra-Bolivia a paradise in SouthAmerica´s heart, where you can find pure air, nature contact, happy people, beautiful women etc.