A Brief Introduction to Engineering Computation with MATLAB by Serhat Beyenir - HTML preview

PLEASE NOTE: This is an HTML preview only and some elements such as links or page numbers may be incorrect.
Download the book in PDF, ePub, Kindle for a complete version.

Chapter 8Publishing with MATLAB

8.1Generating Reports with MATLAB*

Basic Publishing with MATLAB

publishing

MATLAB includes an automatic report generator called publisher. The publisher publishes a script in several formats, including HTML, XML, MS Word and PowerPoint. The published file can contain the following:

  • Commentary on the code,

  • MATLAB code,

  • Results of the executed code, including the Command Window output and figures created by the code.

The publish Function

The most basic syntax is publish('file','format') where the m-file is called and executed line by line then saved to a file in specified format. All published files are placed in the html directory although the published output might be a doc file.

Publishing with Editor

The publisher is easily accessible from the Editor toolbar and file menu:

publishing
Figure 8.1
Publish button on the Editor toolbar

publishing
Figure 8.2
Publish item on the Editor file menu.
Example 8.1

Write a simple script and publish it in an html file.

Select File > New > Script to create an m-file. Once the editor is opened, type in the following code:

x = [0:6];   % Create a row vector
y = 1.6*x;   % Compute y as a function of x
[x',y']     % Transpose vectors x and y
plot(x,y),title('Graph of y=f(x)'),xlabel('x'),ylabel('f(x)'),grid % Plot a graph

Save the script as publishing.m and select File > Publish. An HTML file is generated as shown in the figure below:

Publishing
Figure 8.3
A script published in html

The Double Percentage %% Sign

The scripts sometimes can be very long and their readability might be reduced. To improve the publishing result, sections are introduced by adding descriptive lines to the script preceded by %%. Consider the following example.

Example 8.2

Edit the script created in the example above to look like the code below:

%% This file creates vectors, displays results and plots an x-y graph
x = [0:6];   % Create a row vector
y = 1.6*x;   % Compute y as a function of x
%% Tabulated data
[x',y']     % Transpose vectors x and y
%% Graph of y=f(x)
plot(x,y),title('Graph of y=f(x)'),xlabel('x'),ylabel('f(x)'),grid % Plot a graph

Save the script, a new HTML file is generated as shown in the figure below:

Publishing
Figure 8.4
An html file with sections

Summary of Key Points

  1. MATLAB can generate reports containing commentary on the code, MATLAB code and the results of the executed code,

  2. The publisher generates a script in several formats, including HTML, XML, MS Word and PowerPoint.

  3. The Double Percentage %% can be used to creates hyper-linked sections.

Solutions