CVB.Net 14.0
SampleImageList Class Reference

Classifier type that operates on images. More...

Inherits SampleList.

Inherited by SampleClassificationImageList, and SampleRegressionImageList.

Classes

class  ImageCollection
 Collection of image samples More...
 
struct  ImageLabelInfo
 Base class for providing SIL label information. More...
 

Public Member Functions

void SetFeatureWindow (Point2D location, Size2D size, Point2D origin)
 Redefine the feature window of the sample image list. Note that the values provided must be consistent with the image size for which this sample image list has been created, otherwise an exception will be raised. More...
 
bool IsCompatible (Image img)
 Check whether a CVB image is compatible with this image list, i.e. if it is generally possible to add samples from that image to the list. More...
 
Image GetSampleImage (int sampleIndex)
 Retrieve an image by its overall sample index (ranging from 0 to NumSamples-1. More...
 
- Public Member Functions inherited from SampleList
delegate string LabelTransformStringToString (string labelIn)
 Delegate for label transformation. More...
 
delegate float[] LabelTransformStringToVector (string labelIn)
 Delegate for label transformation. More...
 
delegate float[] LabelTransformVectorToVector (float[] labelIn)
 Delegate for label transformation. More...
 
delegate string LabelTransformVectorToString (float[] labelIn)
 Delegate for label transformation. More...
 
delegate Image DataTransformImageToImage (Image imgIn)
 Image data transformation delegate. More...
 
void Dispose ()
 Dispose method that releases the classifier
 
void Save (string fileName)
 Save the Manto2 sample list to a file. More...
 

Protected Member Functions

void BaseInit ()
 Allows the inheritor to do a reinitialization of the base class parameters.
 
IntPtr CreateNativeImageData (Image srcImage, Point2D extractionLocation)
 Utility function for inheritors that creates a native image data object to be added to the SIL. Make sure to manually release the handle once it is no longer needed! More...
 
- Protected Member Functions inherited from SampleList
virtual void Dispose (bool disposing)
 IDispose helper function. More...
 
abstract int LabelToIndex< TLabel > (TLabel label)
 Convert a class label to a class index. More...
 
bool ContainsLabel< TLabel > (TLabel label)
 Check if the sample list contains a given label... More...
 
void RemoveLabel (int index)
 Remove a label and all the data objects associated with it based on its index. More...
 

Properties

Fringes Fringes [get]
 Fringes (= size difference between the images and the feature window) of the sample images.
 
Size2D FeatureWindowSize [get]
 Size of the feature window.
 
Point2D FeatureWindowLocation [get]
 Location of the feature window (position of left top corner inside the image).
 
Point2D FeatureWindowOrigin [get]
 Location of the feature window origin in pixel coordinates measured from the left top corner of the feature window.
 
Size2D ImageSize [get]
 Size of the images (in pixels) that can be added to the image list.
 
int ImageDimension [get]
 Size of the images (in pixels) that can be added to the image list.
 
DataType ImageDataType [get]
 Data type of the images that can be added to the image list. (all planes must have same data type)
 
override Type SampleType [get]
 Type of the samples used by this SampleList.
 
- Properties inherited from SampleList
IntPtr Handle [get]
 Native Manto2 classifier handle. More...
 
bool IsDisposed [get]
 Tests if the native handle has already been disposed.
 
string FileName [get]
 Name of the file from which this image list was loaded (string.Empty if this image list was neither loaded nor saved since its construction). More...
 
string Comment [get, set]
 Classifier comment text. More...
 
DateTime CreationDate [get]
 Date on which the SampleList was created.
 
DateTime ModificationDate [get]
 Date on which the SampleList was last modified.
 
int NumClasses [get]
 Number of distinguishable classes in the sample list.
 
int NumSamples [get]
 Total number of samples in the sample list.
 
int MinSampleCount [get]
 Number samples in the smallest class of the sample list.
 
int MaxSampleCount [get]
 Number samples in the largest class of the sample list.
 
double AverageSampleCount [get]
 Average number samples in per class of the sample list.
 
abstract Type LabelType [get]
 Type of the labels used by this SampleList.
 
abstract Type SampleType [get]
 Type of the samples used by this SampleList.
 
- Properties inherited from INativeHandle
IntPtr Handle [get]
 The native handle of the object.
 
bool IsDisposed [get]
 Possibility to check whether the object has already been disposed of.
 

Additional Inherited Members

- Static Public Member Functions inherited from SampleList
static SampleList FromFile (string fileName)
 Load a Manto2 sample list from disc. More...
 
- Events inherited from SampleList
NativeHandleEventDelegate ObjectDisposing
 Raised when this object is about to be disposed via the IDisposable.Dispose method.
More...
 
- Events inherited from INativeHandle
NativeHandleEventDelegate ObjectDisposing
 Raised when this object is about to be disposed via the IDisposable.Dispose method.
More...
 

Detailed Description

Classifier type that operates on images.

Member Function Documentation

◆ CreateNativeImageData()

IntPtr CreateNativeImageData ( Image  srcImage,
Point2D  extractionLocation 
)
protected

Utility function for inheritors that creates a native image data object to be added to the SIL. Make sure to manually release the handle once it is no longer needed!

Parameters
srcImageimage to create the data from
extractionLocationlocation at which to extract data
Returns
native handle (IntPtr.Zero will not happen).

◆ GetSampleImage()

Image GetSampleImage ( int  sampleIndex)

Retrieve an image by its overall sample index (ranging from 0 to NumSamples-1.

Parameters
sampleIndexIndex of the image to be retrieved.
Returns
Indexed image.

◆ IsCompatible()

bool IsCompatible ( Image  img)

Check whether a CVB image is compatible with this image list, i.e. if it is generally possible to add samples from that image to the list.

Parameters
imgImage object to be checked for compatibility.
Returns
true if the image referred to by img is compatible with this image list, false otherwise.

◆ SetFeatureWindow()

void SetFeatureWindow ( Point2D  location,
Size2D  size,
Point2D  origin 
)

Redefine the feature window of the sample image list. Note that the values provided must be consistent with the image size for which this sample image list has been created, otherwise an exception will be raised.

Parameters
locationFeature window location (pixel coordinate of the left top corner) inside the sample images.
sizeFeaturew window size in pixels.
originLocation of the origin of the feature window (relative to the left top corner of the feature window, in pixels).