There are many different Matlab commands within Libisis. These include basic commands, such as taking the exponential of a dataset, through to integration and plotting commands. The following is an online user manual for the matlab interface of the Libisis software.
- 1 Overview
- 2 Data Manipulation Functions
- 3 Graphics
- 4 Tutorial
There are many different object types within Libisis used to store experimental data. Once an object is created, functions exist to manipulate the data contained within. The most common objects for plotting and data manipulation are IXTdataset_1d, IXTdataset_2d and IXTdataset_3d objects. IXTrunfile objects contain all raw data from a run.
IXTdataset_1d objects store signal and error information against one dimension (the x axis). Label and titling information is also stored. IXTdataset_2d objects also contain a second dimension (the y axis). As would be expected IXTdataset_3d objects contain yet another (z) dimension. IXTpolygons contains a list of shapes with signal data that can be plotted. All relevant data pertaining to a run can be stored in an IXTrunfile object. The object can be thought of as an array of IXTdataset_2d objects with a lot of additional information. IXTdataset_1d, IXTdataset_2d and IXTrunfile have fully implemented and similar functions, IXTdataset_3d and IXTpolygons are a special case and do not have many of the data manipulation functions as of yet.
Data is read into these objects (using methods described below) and can then be manipulated using many different tools and functions described in this documentation.
Most functions share a general behaviour outlined here
Data Manipulation Functions
Below are just a few of the possible read and write functions, other formats can also be used.
- Homer - Information about using Homer to import data into Libisis
Binary operators such as +, -, *, etc. are used to perform arithmetic operations between datasets and/or numbers
Elementary functions act on each signal element identically
Three different methods exist for rebinning a function. Rebin will rebin the data into user defined bins. Rebunch will bunch together a user defined number of bins. Regroup rebins data using a minimum binwidth given by the user but insures that the new bins are coincident with the existing bins.
- integrate_x, integrate_y, integrate_xy, integrate - Integrates a dataset between user defined limits
- smooth - Smooths out signal data to avoid small, sharp deviations
- unspike - Removes any large spikes from the data
- fit - Fitting data to known functions and giving curves of best fit
- func_eval - Evaluate a function at the given x and y data points
Special functions are used to transform data between different types.
- noisify - Add noise to a dataset.
Default properties and name tags are an integral part of Libisis graphics. They allow greater control of plots and it is particularly important to know about them when building applications on top of the Libisis structure. Names and tags can be used to easily identify and set properties for plots.
- sm - Sliceomatic (three dimensional) plotting
- linlogbutton, linlogmenu, linx, liny, linz, logx ,logy ,logz - changes the axes scale to logarithmic or linear
- aspect - changes the aspect ratio
- dxy,dxyz,dxyc - returns the co-ordinates of a clicked point on a plot, and/or marks the point with a label
- set_legend - adds a legend to the plot
- rename - rename a plot but keep default properties
- fromplot, get_all_name_tags, get_all_handles, get_handles, check_figure - get information from a plot
- set_user_preferences, set_default_properties, reset_default, reset_all - set (or reset) default properties for plot types
- undop - undo the last plot
- alias - make an alias for a function
Information for reference purposes, such as valid linestyles, marker styles etc.
A general tutorial. This is mainly from the graphics viewpoint but should provide a good overview of how to do things.
- Tutorial#Before You Begin
- Tutorial#Introduction To Libisis
- Tutorial#Reading In Data
- Tutorial#Setting Colours and Styles on 1d Plots
- Tutorial#Two Dimensional Plotting
- Tutorial#Reading from a slice
- Tutorial#Data Manipulation In Matlab
- Tutorial#Some Rebinning
- Tutorial#Some Binary Operations
- Tutorial#Integrating Data
- Tutorial#Using the Homer GUI
- Tutorial#Getting Help