Core points
MATLAB is a high-level language for technical computing that integrates computing, visualization and programming in an easy-to-use environment where problems and solutions can be expressed in familiar mathematical notation. There are many projects around the world written in MATLAB and developed by millions of scientists and engineers. Various experimental and operational data people obtain from MATLAB can be used to support web applications, but there are some obstacles:
Creating an application is much easier if MATLAB serves data in JSON format and a web application can use this JSON data from MATLAB to create something great.
In this article, we will develop a small demonstration program to demonstrate how to make the MATLAB and MEAN stack work together.
About Web Application
This web application will involve real-time data transfer from MATLAB to the browser. For simplicity, we will transfer the current time from MATLAB and display it on the browser. We will use JSONlab, a toolbox for encoding/decoding JSON files in MATLAB. The web application will be created using the MEAN stack. If you are not familiar with MEAN stack, it is recommended that you read the article "Beginner of MEAN Stack" before continuing.
Introduction to JSONlab
JSONlab is a free open source implementation of JSON encoder/decoder in MATLAB language. It can be used to convert MATLAB data structures (arrays, structures, cells, structure arrays, and cell arrays) into strings in JSON format, or to decode JSON files into MATLAB data.
It gives us access to four functions: loadjson()
, savejson()
, loadubjson()
, and saveubjson()
. The last two functions are used to handle the UBJSON format. loadjson()
is used to convert JSON strings into related MATLAB objects. In our project, we only use the savejson()
function, which converts a MATLAB object (cell, structure, or array) to a JSON string. It can be used as follows:
json = savejson(rootname, obj, filename) json = savejson(rootname, obj, opt) json = savejson(rootname, obj, 'param1', value1, 'param2', value2, ...)
Since we have to write the file, we will use the first signature. It returns a JSON string as well as writes the string to the file.
JSONlab installation
To get started, download JSONlab, unzip the archive, and add the path of the folder to the path list of MATLAB using the following command:
addpath('/path/to/jsonlab');
If you want to add this path permanently, you need to type pathtool
, browse to the JSONlab root folder and add it to the list. Once finished, you must click Save. Then, run rehash
in MATLAB and type which loadjson
. If you see the output, it means JSONlab is installed correctly.
MATLAB code
We need the current time, so we will use the clock
command. It returns a six-element date vector containing the current date and time in the format [Year, Month, Day, Hours, Minutes, Seconds]. To get the time repeatedly, we put the clock
command in an infinite while
loop. Therefore, we will keep getting the real-time data until the script execution is terminated using Ctrl C on the MATLAB command window.
The following code implements this idea:
format shortg; y=0; while y == 0 % c = [year month day hour minute seconds] c=clock; % 将每个值四舍五入为整数 c=fix(c); x.clock=c; % 访问c的第4列,即小时 x.hours=c(:,4); % 访问c的第5列,即分钟 x.minutes=c(:,5); % 访问c的第6列,即秒 x.seconds=c(:,6); % 将x转换为JSON并写入matlabData.json savejson('',x,'data/matlabData.json'); end
In our projects, we focus on hours, minutes, and seconds. The fix(c)
function used in the above code rounds all elements of the matrix to the nearest integer. To get hour data, we need the value of column 4 of the matrix, so we use the command c(:,4)
. Using the same method, we retrieve minutes and seconds.
We will send the clock and some separate variables to the web application separately to display the conversion of different data types from the MATLAB object to JSON. While the clock data will be converted to an array, the values of hours, minutes and seconds will be converted to numbers, which we will see later.
In our project, we will use the savejson()
function to convert and write variable x using JSON format and write it to the file matlabData.json
. For simplicity, the rootname
parameter will be an empty string.
Use the previous code, we complete all the required MATLAB code. Now, once we run the script, we can observe that the JSON file is created in the data folder and that the data in the file will be updated automatically and constantly. Examples of JSON file content are as follows:
{ "hours": 19, "minutes": 28, "seconds": 28, "clock": [2015,5,27,19,28,28] }
We will monitor this file and use Node.js to read the latest data. Now let's start building a web application.
Web Application
Now that our MATLAB data has been converted to JSON and stored in a file, we can read this file independently and get the data by monitoring its changes. This operation has nothing to do with MATLAB. In the rest of this article, I'll assume you understand socket.io and the MEAN stack, even if we only use some of their basic concepts.
Let's start writing web applications.
Create package.json file
To start our application, let's define the dependencies of the project. To do this, we will create a package.json
file as follows:
json = savejson(rootname, obj, filename) json = savejson(rootname, obj, opt) json = savejson(rootname, obj, 'param1', value1, 'param2', value2, ...)
in the root folder of the project to install all dependencies. If you are not familiar with npm, it is recommended that you read the "NPM Getting Started Guide - Node Package Manager". npm install
Server side code This part of the code involves the use of Node.js, Express, and MongoDB. The operations performed by the server include:
Provided
index.html
Monitor and read data in JSON files
server.js
We use Express to provide static files:
Whenever a request is sent to
addpath('/path/to/jsonlab');
file stored in the /
directory will be provided. app
index.html
To monitor any changes to the file, we use
. Once a change is detected, the file is read and the data is retrieved. The whole process is completed using the following code: fs.watch()
fs.readFile()
format shortg; y=0; while y == 0 % c = [year month day hour minute seconds] c=clock; % 将每个值四舍五入为整数 c=fix(c); x.clock=c; % 访问c的第4列,即小时 x.hours=c(:,4); % 访问c的第5列,即分钟 x.minutes=c(:,5); % 访问c的第6列,即秒 x.seconds=c(:,6); % 将x转换为JSON并写入matlabData.json savejson('',x,'data/matlabData.json'); end
Send data to the browser using socket.io's
emit()
Save data to MongoDB using mongoose middlewareIn the last statement of the previous code segment, we create a model based on the defined pattern. The first parameter passed to the function is the singular name of the set to which our model belongs. Mongoose automatically assigns plural names to the collection. Therefore, here
{ "hours": 19, "minutes": 28, "seconds": 28, "clock": [2015,5,27,19,28,28] }
collection. appData
appDatas
When we get new data, we will use the latest data to create a new instance of the schema and save it to the database using the
is a document. save()
savingData
The final code for this part is as follows:
json = savejson(rootname, obj, filename) json = savejson(rootname, obj, opt) json = savejson(rootname, obj, 'param1', value1, 'param2', value2, ...)
We use try
and catch
to prevent the application from crashing. If we don't use it, and the JSON.parse
caused unexpected user input errors due to the rapid change, the application may crash. This is what we want to avoid!
Also note that please make sure the MongoDB server is running, otherwise the application will crash.
Client code
In this section, we will create a simple static HTML page. When new data is received through socket.io, we will update the data displayed on the page. This data can also be used to create real-time charts.
The following is the simple code for the index.html
file:
addpath('/path/to/jsonlab');
ngCloak
directive is used to prevent the browser from briefly displaying the original (uncompiled) form of AngularJS template when the application is loading.
Run the application
Before starting the Node.js server, we need to make sure that the MATLAB code and the MongoDB server are running. To run the MongoDB server, you need to execute the command mongod
on the terminal. To run the Node.js server, you must execute the command node server.js
in the root directory of the project folder.
The static page showing the current time will be provided in 127.0.0.1:3000
.
Conclusion
In this article, we use the MEAN stack to create a web application that gets data in JSON format from the MATLAB program. Data is converted with the help of JSONlab. The data is then sent to the browser using socket.io, so changes on the browser are reflected in real time. The full source code for this demo is available on GitHub.
I hope you enjoyed this article and look forward to reading your comments.
(The FAQs section is recommended to handle it separately due to the length of the article. Key questions and answers can be extracted and briefly summarized or reorganized as needed.)
The above is the detailed content of Creating a Web App with MATLAB and the MEAN Stack. For more information, please follow other related articles on the PHP Chinese website!