Language - MATLAB - Revision history

Mparadis: /* Using the MATLAB Engine from a C program */

2017-06-06T21:08:59Z

Using the MATLAB Engine from a C program

← Older revision		Revision as of 21:08, 6 June 2017
Line 291:		Line 291:

	Here is a modified version of Spatial-simple.c which uses the MATLAB engine to pass the spatial data through a high-pass filter to monitor for sudden changes in acceleration such as if a car were running off road or a structure was experiencing unexpected vibrations (an earthquake say):		Here is a modified version of Spatial-simple.c which uses the MATLAB engine to pass the spatial data through a high-pass filter to monitor for sudden changes in acceleration such as if a car were running off road or a structure was experiencing unexpected vibrations (an earthquake say):
	*[{{SERVER}}/images/e/ef/Main.cpp Main]		*[{{SERVER}}/docs21/images/e/ef/Main.cpp Main]
	*[{{SERVER}}/images/e/ee/Spatialfilter.h Header]		*[{{SERVER}}/docs21/images/e/ee/Spatialfilter.h Header]

	The full API and documentation package for the MATLAB engine can be found on MathWorks' website.		The full API and documentation package for the MATLAB engine can be found on MathWorks' website.

Mparadis: /* Using the MATLAB Engine from a C program */

2017-06-06T21:07:53Z

Using the MATLAB Engine from a C program

← Older revision		Revision as of 21:07, 6 June 2017
Line 291:		Line 291:

	Here is a modified version of Spatial-simple.c which uses the MATLAB engine to pass the spatial data through a high-pass filter to monitor for sudden changes in acceleration such as if a car were running off road or a structure was experiencing unexpected vibrations (an earthquake say):		Here is a modified version of Spatial-simple.c which uses the MATLAB engine to pass the spatial data through a high-pass filter to monitor for sudden changes in acceleration such as if a car were running off road or a structure was experiencing unexpected vibrations (an earthquake say):
	*[{{SERVER}}~~/wiki~~/images/e/ef/Main.cpp Main]		*[{{SERVER}}/images/e/ef/Main.cpp Main]
	*[{{SERVER}}~~/wiki~~/images/e/ee/Spatialfilter.h Header]		*[{{SERVER}}/images/e/ee/Spatialfilter.h Header]

	The full API and documentation package for the MATLAB engine can be found on MathWorks' website.		The full API and documentation package for the MATLAB engine can be found on MathWorks' website.

Mparadis at 20:45, 6 June 2017

2017-06-06T20:45:49Z

← Older revision		Revision as of 20:45, 6 June 2017
Line 24:		Line 24:
	{{APIQuickDownloads\|{{SERVER}}/documentation/Phidget21_C_Doc.zip}}		{{APIQuickDownloads\|{{SERVER}}/documentation/Phidget21_C_Doc.zip}}
	{{ExtraAPIQuickDownloads\|{{SERVER}}/documentation/web/cdoc/index.html\|HTML Version of}}\|		{{ExtraAPIQuickDownloads\|{{SERVER}}/documentation/web/cdoc/index.html\|HTML Version of}}\|
	{{ExampleQuickDownloads\|{{SERVER}}/downloads/examples/Matlab.zip MATLAB\|}}\|		{{ExampleQuickDownloads\|{{SERVER}}/downloads/phidget21/examples/c/Matlab.zip MATLAB\|}}\|
	{{WindowsQuickDownloads}}		{{WindowsQuickDownloads}}
	{{MacQuickDownloads}}		{{MacQuickDownloads}}
Line 45:		Line 45:
	Start by using and modifying existing examples. You can find the MATLAB example code here:		Start by using and modifying existing examples. You can find the MATLAB example code here:

	*[{{SERVER}}/downloads/examples/Matlab.zip MATLAB Examples]		*[{{SERVER}}/downloads/phidget21/examples/c/Matlab.zip MATLAB Examples]

	To run the example code, you'll need to unpack the download and find the source code ''for your specific device'' within the example package. The file you need will be named something similar to your device name. Once you have found the file that runs your device, copy that .m source file '''and''' phidget21Matlab.h from the examples folder to your project directory. Then, run the code within MATLAB as you would any .m file. For example, from the MATLAB command line, to run the example that reads the analog input at index X from a Phidget Interface Kit:		To run the example code, you'll need to unpack the download and find the source code ''for your specific device'' within the example package. The file you need will be named something similar to your device name. Once you have found the file that runs your device, copy that .m source file '''and''' phidget21Matlab.h from the examples folder to your project directory. Then, run the code within MATLAB as you would any .m file. For example, from the MATLAB command line, to run the example that reads the analog input at index X from a Phidget Interface Kit:
Line 146:		Line 146:

	===Use our Examples===		===Use our Examples===
	Download the and unzip the [{{SERVER}}/downloads/examples/Matlab.zip Phidget examples for MATLAB]. Put the {{Code\|phidget21Matlab.h}} header file that you just compiled into the unzipped example directory.		Download the and unzip the [{{SERVER}}/downloads/phidget21/examples/c/Matlab.zip Phidget examples for MATLAB]. Put the {{Code\|phidget21Matlab.h}} header file that you just compiled into the unzipped example directory.

	The {{Code\|phidget21Matlab.h}} file as well as the {{Code\|loadphidget21.m}} should be either in the current project directory, or in a MATLAB path (type {{Code\|path}} in MATLAB to see the current setup). If you prefer to use parentheses and quotations for aliasing (to keep your formatting strict), you can read about the various syntax options for the {{Code\|loadlibrary}} function on the [http://www.mathworks.com/help/techdoc/ref/loadlibrary.html MathWorks website].		The {{Code\|phidget21Matlab.h}} file as well as the {{Code\|loadphidget21.m}} should be either in the current project directory, or in a MATLAB path (type {{Code\|path}} in MATLAB to see the current setup). If you prefer to use parentheses and quotations for aliasing (to keep your formatting strict), you can read about the various syntax options for the {{Code\|loadlibrary}} function on the [http://www.mathworks.com/help/techdoc/ref/loadlibrary.html MathWorks website].

Burley: /* Common Problems and Solutions */

2013-09-05T19:36:39Z

Common Problems and Solutions

← Older revision		Revision as of 19:36, 5 September 2013
Line 320:		Line 320:

	The example programs uses the MATLAB {{Code\|timer()}} call, which relies on the Java Virtual Machine. Since Rosetta does not support Java, the examples will not operate as expected.		The example programs uses the MATLAB {{Code\|timer()}} call, which relies on the Java Virtual Machine. Since Rosetta does not support Java, the examples will not operate as expected.

			===There are no compilers listed under the mex -setup menu===
			64-bit versions of Matlab do not have a C compiler included with them. You will need to use another compiler such as the Visual Studio compiler. If you do not have Visual Studio then you can install a free version from Microsoft's website which has a compiler with it or you download another free C compiler of which there are many.

Burley: /* Using the MATLAB Engine from a C program */

2013-06-14T14:14:56Z

Using the MATLAB Engine from a C program

← Older revision		Revision as of 14:14, 14 June 2013
Line 293:		Line 293:
	*[{{SERVER}}/wiki/images/e/ef/Main.cpp Main]		*[{{SERVER}}/wiki/images/e/ef/Main.cpp Main]
	*[{{SERVER}}/wiki/images/e/ee/Spatialfilter.h Header]		*[{{SERVER}}/wiki/images/e/ee/Spatialfilter.h Header]

			The full API and documentation package for the MATLAB engine can be found on MathWorks' website.

	A number of things can be tweaked in this example, such as the filter parameters and type of filter used, the threshold at which we take note of the vibrations etc... If we look at the unaltered data vs the filtered data we can see that the filtering operation was a success:		A number of things can be tweaked in this example, such as the filter parameters and type of filter used, the threshold at which we take note of the vibrations etc... If we look at the unaltered data vs the filtered data we can see that the filtering operation was a success:

	[[File:Filtereddata.png\|800px\|center\|link=]]		[[File:Filtereddata.png\|800px\|center\|link=]]


	==Common Problems and Solutions==		==Common Problems and Solutions==

Burley: /* Common Problems and Solutions */

2013-06-14T14:13:41Z

Common Problems and Solutions

← Older revision		Revision as of 14:13, 14 June 2013
Line 268:		Line 268:

	The ''complete'' set of functions you have available for all Phidgets can be found in the [{{SERVER}}/documentation/Phidget21_C_Doc.zip C/C++ API]. Note, however, MATLAB does not make use of the event functions in the C/C++ API. You can also find more description on any device-specific function in the Device API page for your specific Phidget, which can be found in its [[:Category:UserGuide\|user guide]].		The ''complete'' set of functions you have available for all Phidgets can be found in the [{{SERVER}}/documentation/Phidget21_C_Doc.zip C/C++ API]. Note, however, MATLAB does not make use of the event functions in the C/C++ API. You can also find more description on any device-specific function in the Device API page for your specific Phidget, which can be found in its [[:Category:UserGuide\|user guide]].

			==Using the MATLAB Engine from a C program==
			It is possible to use events while still having a MATLAB like environment by using the MATLAB engine library in C. In MathWorks' own words: "The MATLAB® engine library contains routines that allow you to call MATLAB software from your own programs, thereby employing MATLAB as a computation engine..."[http://www.mathworks.com/help/matlab/matlab_external/using-matlab-engine.html] This allows you to write a C program that uses normal C syntax structure but calls MATLAB to take care of the complex math algorithms that you do not want to implement in C. To get the MATLAB engine set up just follow these steps (note that these steps are for a Windows system with Visual Studio installed, you can download a free version of VS from Microsoft under the Express name)

			*Create a new Visual Studio empty project.
			*Add a new CPP source file be sure to include the following header files:
			**<nowiki>#include <windows.h></nowiki>
			**<nowiki>#include <stdlib.h></nowiki>
			**<nowiki>#include <stdio.h></nowiki>
			**<nowiki>#include <string.h></nowiki>
			**<nowiki>#include <engine.h></nowiki>
			*Under Project Properties:
			**Add <code>/<Matlab install directory>/extern/include</code> to "Additional include directories"
			**Make sure that precompiled headers are disabled
			**In the "Linker" section add <code>/<Matlab install directory>/extern/lib/win32(or 64)/microsoft</code> to "Additional library dependencies".
			**Under "Linker->Input" add <code>libmx.lib libmat.lib libeng.lib</code> to "Additional dependendcies".
			*Now open a cmd terminal and navigate to <code>/<Matlab install directory>/bin/win32(or 64)</code> and enter in the following command:
			**<code>matlab /regserver</code>
			*Close the MATLAB window that opens.
			*Next, make sure that <code>/<Matlab install directory>/bin/win32(or 64)</code> is included in your PATH environment variable.
			*Finally, restart Visual Studio. Your project should now be configured to be able to use the MATLAB engine.

			Here is a modified version of Spatial-simple.c which uses the MATLAB engine to pass the spatial data through a high-pass filter to monitor for sudden changes in acceleration such as if a car were running off road or a structure was experiencing unexpected vibrations (an earthquake say):
			*[{{SERVER}}/wiki/images/e/ef/Main.cpp Main]
			*[{{SERVER}}/wiki/images/e/ee/Spatialfilter.h Header]

			A number of things can be tweaked in this example, such as the filter parameters and type of filter used, the threshold at which we take note of the vibrations etc... If we look at the unaltered data vs the filtered data we can see that the filtering operation was a success:

			[[File:Filtereddata.png\|800px\|center\|link=]]


	==Common Problems and Solutions==		==Common Problems and Solutions==

Burley: /* Windows XP/Vista/7 */

2013-04-02T18:33:17Z

Windows XP/Vista/7

← Older revision		Revision as of 18:33, 2 April 2013
Line 39:		Line 39:
	*[[#Linux \| Linux]]		*[[#Linux \| Linux]]

	==Windows XP/Vista/7==		==Windows XP/Vista/7/8==

	===Use Our Examples===		===Use Our Examples===

Burley at 16:59, 13 March 2013

2013-03-13T16:59:16Z

Show changes

Burley: /* Introduction */

2013-02-27T17:23:18Z

Introduction

← Older revision		Revision as of 17:23, 27 February 2013
Line 6:		Line 6:

	{{LanguageSupport\|MATLAB\|the non-[[General Phidget Programming#Event Driven Code\|event driven]] part of the Phidget API\|AdvancedServo, Encoder, InterfaceKit, Servo and Stepper.\|any operating system that can run MATLAB code\|}}		{{LanguageSupport\|MATLAB\|the non-[[General Phidget Programming#Event Driven Code\|event driven]] part of the Phidget API\|AdvancedServo, Encoder, InterfaceKit, Servo and Stepper.\|any operating system that can run MATLAB code\|}}

			As a result of MATLAB's lack of event support there are some things that cannot be done in MATLAB. The most prominent of which is sample at the full rate possible for certain boards. For example, in order to achieve the full 1000 samples/s specified by the analog inputs on an interface kit you need to set the datarate to 1ms. This will queue up events on the interface kit and send all 8 of them at 8ms intervals. Since MATLAB cannot use events, it must poll the device for data. You cannot poll faster than 8ms however and thus MATLAB is limited to 125 samples/s (8ms) rather than 1000 samples/s (1ms). There are similar effects on other boards with datarates higher than 125 samples/s.

	If you want to use the events provided by the Phidget library (for, say, collecting sensor data as it changes) then consider using Python as a wrapper. Python has many libraries which can provide MATLAB-like functionality, such as:		If you want to use the events provided by the Phidget library (for, say, collecting sensor data as it changes) then consider using Python as a wrapper. Python has many libraries which can provide MATLAB-like functionality, such as:

Burley: /* Use Our Examples */

2013-01-22T19:13:35Z

Use Our Examples

← Older revision		Revision as of 19:13, 22 January 2013
Line 56:		Line 56:
	</syntaxhighlight>		</syntaxhighlight>
	</div>		</div>

			Alternatively you can use the header file titled {{Code\|phidget21Matlabx64.h}} and simply rename it to {{Code\|phidget21Matlab.h}}.

	To run the example code, you'll need to unpack the download and find the source code ''for your specific device'' within the example package. The file you need will be named something similar to your device name. Once you have found the file that runs your device, copy that .m source file '''and''' phidget21Matlab.h from the examples folder to your project directory. Then, run the code within MATLAB as you would any .m file. For example, from the MATLAB command line, to run the example that reads the analog input from a Phidget Interface Kit:		To run the example code, you'll need to unpack the download and find the source code ''for your specific device'' within the example package. The file you need will be named something similar to your device name. Once you have found the file that runs your device, copy that .m source file '''and''' phidget21Matlab.h from the examples folder to your project directory. Then, run the code within MATLAB as you would any .m file. For example, from the MATLAB command line, to run the example that reads the analog input from a Phidget Interface Kit: