Texture: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Scott
(New page: ===Purpose=== Run texture analysis on an image or group of images. ===Synopsis=== :[y,varargout]= texture(img, method, options, varargin) ===Description=== TEXTURE will perform an analy...)
 
imported>Scott
No edit summary
Line 7: Line 7:


===Description===
===Description===
TEXTURE will perform an analysis on any 2 dimensional (m x n pixels)
TEXTURE will perform an analysis on any 2 dimensional (m x n pixels) layer of an image or group of images. It loops through input 'img' where mode 3 is considered the variables (slabs of an image) mode and mode 4 is considered the images mode. Any additional inputs to the chosen 'method' must be added after the options input.  
layer of an image or group of images. It loops through input 'img' where
 
mode 3 is considered the variables (slabs of an image) mode and mode 4
Outputs are 'y' a dataset with each row corresponding to an image and varargout containing any secondary output from the selected method. Outputs for a 'method' must be designated by the user with options.numout. Outputs will be appended together forming one row vector per image. E.G. for 'anglemt' if options.numout = [2 1] then the y{2} and y{1} outputs of 'anglemt' will be concatenated to form the row. Only the first output of a function is used. If there is a second output of a function it is assigned to varargout.  
is considered the images mode. Any additional inputs to the chosen
 
'method' must be added after the options input. Outputs are 'y' a dataset
Aggregation can be performed across variables (slabs/layers) and or across images. For example, setting options.varmode = 'sum' will sum the layer of an image into one layer.  
with each row corresponding to an image and varargout containing any
secondary output from the selected method.
%
Outputs for a 'method' must be designated by the user with
options.numout. Outputs will be appended together forming one row vector
per image. E.G. for 'anglemt' if options.numout = [2 1] then the y{2}
and y{1} outputs of 'anglemt' will be concatenated to form the row. Only
the first output of a function is used. If there is a second output of a
function it is assigned to varargout.  
%
Aggregation can be performed across variables (slabs/layers) and
or across images. For example, setting options.varmode = 'sum' will sum
the layer of an image into one layer.  


====Inputs====
====Inputs====
* '''first''' = first input is this.
* '''img''' = image data (matrix or DataSet). The first two modes must be pixels, the third mode must be variables, and the fourth mode must be images.
* '''method''' = texture method ('anglemt' 'autocor_img' 'svd_texture' 'fft_texture' 'semivar').
* '''varargin''' = additional input needed for selected 'method'.


====Optional Inputs====
====Optional Inputs====
* '''second''' = optional second input is this.
* '''varargin''' = additional input needed for selected 'method'.


====Outputs====
====Outputs====
* '''firstout''' = first output is this.
* '''firstout''' = first output is this.
* '''y''' = dataset where each row (spectra) corresponds to an image.
* '''varargout''' = second ouput of a function (e.g. for anglemt this would be 's', the distance scales). Will transform into row vector of cells.


===Options===
===Options===
Line 39: Line 30:
options =  a structure array with the following fields:
options =  a structure array with the following fields:


* '''plots''': [ {'none'} | 'final' ] governs plotting of results, and
* '''numout''': [{1}] 1xK vector. Number and order of outputs from selected 'method' to use.
* '''order''': positive integer for polynomial order {default = 1}.
* '''imgmode''': [ {'none'} | 'sum' | 'mean' ] aggregation across images.
 
* '''varmode''': [ {'none'} | 'sum' | 'mean' ] aggregation across variables.
===Example===


<pre>
TEXTURE FUNCTION SUB-STRUCTURES
>>This is an example
These options can be assigned in their nested form. See the particular function for a full description of available options. For example:
Error: does not exist
: <tt>options.anglemt.xscale = [1:100];</tt>  
</pre>


===See Also===
===See Also===


[[baselinew]], [[deresolv]]
[[anglemt]], [[autocor_img]], [[detrend_img]], [[fft_texture]], [[semivar]], [[svd_texture]]

Revision as of 19:14, 29 September 2009

Purpose

Run texture analysis on an image or group of images.

Synopsis

[y,varargout]= texture(img, method, options, varargin)

Description

TEXTURE will perform an analysis on any 2 dimensional (m x n pixels) layer of an image or group of images. It loops through input 'img' where mode 3 is considered the variables (slabs of an image) mode and mode 4 is considered the images mode. Any additional inputs to the chosen 'method' must be added after the options input.

Outputs are 'y' a dataset with each row corresponding to an image and varargout containing any secondary output from the selected method. Outputs for a 'method' must be designated by the user with options.numout. Outputs will be appended together forming one row vector per image. E.G. for 'anglemt' if options.numout = [2 1] then the y{2} and y{1} outputs of 'anglemt' will be concatenated to form the row. Only the first output of a function is used. If there is a second output of a function it is assigned to varargout.

Aggregation can be performed across variables (slabs/layers) and or across images. For example, setting options.varmode = 'sum' will sum the layer of an image into one layer.

Inputs

  • img = image data (matrix or DataSet). The first two modes must be pixels, the third mode must be variables, and the fourth mode must be images.
  • method = texture method ('anglemt' 'autocor_img' 'svd_texture' 'fft_texture' 'semivar').
  • varargin = additional input needed for selected 'method'.

Optional Inputs

  • varargin = additional input needed for selected 'method'.

Outputs

  • firstout = first output is this.
  • y = dataset where each row (spectra) corresponds to an image.
  • varargout = second ouput of a function (e.g. for anglemt this would be 's', the distance scales). Will transform into row vector of cells.

Options

options = a structure array with the following fields:

  • numout: [{1}] 1xK vector. Number and order of outputs from selected 'method' to use.
  • imgmode: [ {'none'} | 'sum' | 'mean' ] aggregation across images.
  • varmode: [ {'none'} | 'sum' | 'mean' ] aggregation across variables.

TEXTURE FUNCTION SUB-STRUCTURES These options can be assigned in their nested form. See the particular function for a full description of available options. For example:

options.anglemt.xscale = [1:100];

See Also

anglemt, autocor_img, detrend_img, fft_texture, semivar, svd_texture