Programmatic depiction of objects in tomograms

This article describes some technique for generation of tomogram scenes.

While we call the different objects as "matlab-"XX, all the following explanations apply to the Dynamo command line, which inherits the graphic functionality of matlab.

Basic tool: graphic handles

The basic objects that we will use are the matlab figure and the matlab axis. Roughly speaking, a Matlab figure is a window generated by Matlab. A Matlab axes is a system of coordinates that can be defined inside a figure, and which can contain graphical objects.

In other words, graphical objects are defined into a canvas (a Matlab axes), which is parented by a window (a Matlab figure);

Matlab figure

A matlab figure can be created just by the order;

f = figure();

Here, f</ff> is an arbitrary name,we could have called the figure any other name. Once created, this f offers a handle, i.e., a way to operate on the figure. For instance :

f.Name = 'This is my figure'

will change the name shown on the top bar of the figure.

The current figure

One can get a handle to the current figure (the last one to have been active) through the command gcf. If none is current, a new figure will be generated.

Matlab axes

Simple plots

Tomogram slices

Models

Models have different plotting methods attached.

Standard plotting methods

The standard plotting methods are called plotXX, where XX can be Points, TablePoints

The regular syntax of a plotting method is:

 object.method( axeesHandle)

Thus, if you want to use the method plotPoints to generate in a graphical axes ax a 3d depiction of the points contained inside a model called m, your syntax would be:

 m.plotPoints(ax);