Class ImageTrack

Inheritance

Object

ImageTrack

Inherited Members

Object.Equals(Object)

Object.Equals(Object, Object)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ReferenceEquals(Object, Object)

Object.ToString()

Namespace: AudioAnalysisTools.StandardSpectrograms

Assembly: AudioAnalysisTools.dll

Syntax

public sealed class ImageTrack

Constructors

ImageTrack(TrackType)

Declaration

public ImageTrack(TrackType type)

Parameters

Type	Name	Description
TrackType	type

ImageTrack(TrackType, Double[])

Declaration

public ImageTrack(TrackType type, double[] data)

Parameters

Type	Name	Description
TrackType	type
Double[]	data

ImageTrack(TrackType, Double[], Double[])

Initializes a new instance of the ImageTrack class. used for showing the singal envelope track.

Declaration

public ImageTrack(TrackType type, double[] data1, double[] data2)

Parameters

Type	Name	Description
TrackType	type
Double[]	data1
Double[]	data2

ImageTrack(TrackType, Double[,])

Declaration

public ImageTrack(TrackType type, double[, ] data)

Parameters

Type	Name	Description
TrackType	type
Double[,]	data

ImageTrack(TrackType, Int32[])

Initializes a new instance of the ImageTrack class. CONSTRUCTOR.

Declaration

public ImageTrack(TrackType type, int[] data)

Parameters

Type	Name	Description
TrackType	type
Int32[]	data

ImageTrack(TrackType, TimeSpan, Double)

Declaration

public ImageTrack(TrackType type, TimeSpan t, double pixelsPerSecond)

Parameters

Type	Name	Description
TrackType	type
TimeSpan	t
Double	pixelsPerSecond

Fields

DefaultHeight

Declaration

public const int DefaultHeight = 30

Field Value

Type	Description
Int32

envelopeTrackHeight

Declaration

public const int envelopeTrackHeight = 40

Field Value

Type	Description
Int32

HeightOfTimeScale

Declaration

public const int HeightOfTimeScale = 15

Field Value

Type	Description
Int32

scoreMax

Declaration

public double scoreMax

Field Value

Type	Description
Double

scoreMin

Declaration

public double scoreMin

Field Value

Type	Description
Double

scoreTrackHeight

Declaration

public const int scoreTrackHeight = 40

Field Value

Type	Description
Int32

syllablesTrackHeight

Declaration

public const int syllablesTrackHeight = 10

Field Value

Type	Description
Int32

TrackColors

Declaration

public static Color[] TrackColors

Field Value

Type	Description
SixLabors.ImageSharp.Color[]

Properties

bottomOffset

Declaration

public int bottomOffset { get; set; }

Property Value

Type	Description
Int32

GarbageID

Declaration

public int GarbageID { get; set; }

Property Value

Type	Description
Int32

Height

Declaration

public int Height { get; set; }

Property Value

Type	Description
Int32

Name

Declaration

public string Name { get; set; }

Property Value

Type	Description
String

sampleUnit

Declaration

public int sampleUnit { get; set; }

Property Value

Type	Description
Int32

ScoreMax

Declaration

public double ScoreMax { get; set; }

Property Value

Type	Description
Double

ScoreMin

Declaration

public double ScoreMin { get; set; }

Property Value

Type	Description
Double

ScoreThreshold

Declaration

public double ScoreThreshold { get; set; }

Property Value

Type	Description
Double

SegmentationThreshold_k1

Declaration

public double SegmentationThreshold_k1 { get; set; }

Property Value

Type	Description
Double

SegmentationThreshold_k2

Declaration

public double SegmentationThreshold_k2 { get; set; }

Property Value

Type	Description
Double

topOffset

Declaration

public int topOffset { get; set; }

Property Value

Type	Description
Int32

TrackType

Declaration

public TrackType TrackType { get; set; }

Property Value

Type	Description
TrackType

Methods

CalculateGridInterval(TimeSpan, Int32)

Declaration

public static TimeSpan CalculateGridInterval(TimeSpan totalDuration, int width)

Parameters

Type	Name	Description
TimeSpan	totalDuration
Int32	width

Returns

Type	Description
TimeSpan

DrawBarScoreTrack(Double[], Double[], Int32, Double, String)

used to draw score track of an array of values The values in array MUST lie in [0,1].

Declaration

public static Image<Rgb24> DrawBarScoreTrack(double[] order, double[] array, int trackWidth, double threshold, string title)

Parameters

Type	Name	Description
Double[]	order
Double[]	array
Int32	trackWidth
Double	threshold
String	title

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawColourScoreTrack(Double[], Double[], Int32, Int32, Double, String)

used to draw coloured score track or any array of values.

Declaration

public static Image<Rgb24> DrawColourScoreTrack(double[] order, double[] array, int trackWidth, int trackHeight, double threshold, string title)

Parameters

Type	Name	Description
Double[]	order
Double[]	array
Int32	trackWidth
Int32	trackHeight
Double	threshold
String	title

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawDecibelTrack(Image<Rgb24>)

Declaration

public Image<Rgb24> DrawDecibelTrack(Image<Rgb24> bmp)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawDecibelTrack(Double[], Int32, Double, Double)

This method assumes that the passed decibel array has been normalised.

Declaration

public static Image<Rgb24> DrawDecibelTrack(double[] data, int imageWidth, double segmentationThreshold_k1, double segmentationThreshold_k2)

Parameters

Type	Name	Description
Double[]	data
Int32	imageWidth
Double	segmentationThreshold_k1
Double	segmentationThreshold_k2

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawGrayScaleScoreTrack(Double[], Double, Double, Double, String)

used to draw score track or any array of values.

Declaration

public static Image<Rgb24> DrawGrayScaleScoreTrack(double[] array, double minVal, double maxVal, double threshold, string title)

Parameters

Type	Name	Description
Double[]	array
Double	minVal
Double	maxVal
Double	threshold
String	title

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawGrayScaleScoreTrack(Double[], Int32, Double, String)

Declaration

public static Image<Rgb24> DrawGrayScaleScoreTrack(double[] array, int trackHeight, double threshold, string title)

Parameters

Type	Name	Description
Double[]	array
Int32	trackHeight
Double	threshold
String	title

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawNamedScoreArrayTrack(Image<Rgb24>)

Declaration

public Image<Rgb24> DrawNamedScoreArrayTrack(Image<Rgb24> bmp)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawScoreArrayTrack(Image<Rgb24>)

Displays a score track, normalised to min and max of the data. max=approx 8-16.

Declaration

public Image<Rgb24> DrawScoreArrayTrack(Image<Rgb24> bmp)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawScoreArrayTrack(Double[], Double, Int32)

Displays a score track, normalised to min and max of the data. max=approx 8-16.

Declaration

public static Image<Rgb24> DrawScoreArrayTrack(double[] data, double threshold, int trackWidth)

Parameters

Type	Name	Description
Double[]	data
Double	threshold
Int32	trackWidth

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawScoreMatrixTrack(Image<Rgb24>)

This method assumes that the passed data array is of values, min=0.0, max = approx 8-16.

Declaration

public Image<Rgb24> DrawScoreMatrixTrack(Image<Rgb24> bmp)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawScoreTrack(Image<Rgb24>, Double[], Int32, Int32, Double, Double, Double, String)

used to draw richness indices.

Declaration

public static void DrawScoreTrack(Image<Rgb24> bmp, double[] array, int yOffset, int trackHeight, double minVal, double maxVal, double threshold, string title)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp
Double[]	array
Int32	yOffset
Int32	trackHeight
Double	minVal
Double	maxVal
Double	threshold
String	title

DrawScoreTrack(Image<Rgb24>, Double[], Int32, Int32, Double, String)

Declaration

public static void DrawScoreTrack(Image<Rgb24> bmp, double[] array, int yOffset, int trackHeight, double threshold, string title)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp
Double[]	array
Int32	yOffset
Int32	trackHeight
Double	threshold
String	title

DrawSegmentationTrack(BaseSonogram, Double, Double, Int32)

Declaration

public static Image<Rgb24> DrawSegmentationTrack(BaseSonogram sg, double segmentationThreshold_k1, double segmentationThreshold_k2, int imageWidth)

Parameters

Type	Name	Description
BaseSonogram	sg
Double	segmentationThreshold_k1
Double	segmentationThreshold_k2
Int32	imageWidth

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawSegmentationTrack(Image<Rgb24>)

This method assumes that the passed decibel array has been normalised. Also requires values to be set for SegmentationThreshold_k1 and SegmentationThreshold_k2.

Declaration

public Image<Rgb24> DrawSegmentationTrack(Image<Rgb24> bmp)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawSegmentationTrack(Double[], Int32[], Double, Double, Int32)

Declaration

public static Image<Rgb24> DrawSegmentationTrack(double[] data, int[] stateData, double segmentationThreshold_k1, double segmentationThreshold_k2, int imageWidth)

Parameters

Type	Name	Description
Double[]	data
Int32[]	stateData
Double	segmentationThreshold_k1
Double	segmentationThreshold_k2
Int32	imageWidth

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawShortTimeTrack(TimeSpan, TimeSpan, TimeSpan, TimeSpan, Int32, String)

This time track is labeled to be convenient for time durations around 1-20 minutes.

Declaration

public static Image<Rgb24> DrawShortTimeTrack(TimeSpan offsetMinute, TimeSpan xAxisPixelDuration, TimeSpan xAxisTicInterval, TimeSpan labelInterval, int trackWidth, string title)

Parameters

Type	Name	Description
TimeSpan	offsetMinute
TimeSpan	xAxisPixelDuration
TimeSpan	xAxisTicInterval
TimeSpan	labelInterval
Int32	trackWidth
String	title

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawSimilarityScoreTrack(Image<Rgb24>)

Displays a score track, normalised to min and max of the data. max=approx 8-16.

Declaration

public Image<Rgb24> DrawSimilarityScoreTrack(Image<Rgb24> bmp)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawSyllablesTrack(Image<Rgb24>)

paints a track of symbol colours derived from symbol ID.

Declaration

public Image<Rgb24> DrawSyllablesTrack(Image<Rgb24> bmp)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawTimeRelativeTrack(TimeSpan, Int32, Int32)

Declaration

public static Image<Rgb24> DrawTimeRelativeTrack(TimeSpan fullDuration, int trackWidth, int trackHeight)

Parameters

Type	Name	Description
TimeSpan	fullDuration
Int32	trackWidth
Int32	trackHeight

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawTimeTrack(Image<Rgb24>)

adds time track to a sonogram at the vertical position determined by topOffset.

Declaration

public Image<Rgb24> DrawTimeTrack(Image<Rgb24> bmp)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawTimeTrack(TimeSpan, Int32)

Draws time track with labels to indicate hh:mm:ss.

Declaration

public static Image<Rgb24> DrawTimeTrack(TimeSpan duration, int width)

Parameters

Type	Name	Description
TimeSpan	duration	Duration of the time scale.
Int32	width	pixel width of the time scale.

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawTimeTrack(TimeSpan, Nullable<DateTimeOffset>, Int32, Int32)

IMPORTANT: THIS TIME SCALE METHOD WAS REWORKED ON 23 June 2015 and on 3 August 2015. IT POSSIBLY CONTAINS BUGS THAT WILL NEED TO BE FIXED FOR ZOOMING SPECTROGRAMS It is possible that rounding the tic marks to 'nice' numbers is not a good idea.

Returns a bitmap of a time scale. Interval between tic marks is calculated automatically. This method is used for long duration spectrograms. It could be generalised for any time track.

Declaration

public static Image<Rgb24> DrawTimeTrack(TimeSpan fullDuration, DateTimeOffset? dateTime, int trackWidth, int trackHeight)

Parameters

Type	Name	Description
TimeSpan	fullDuration	time span of entire time track to be drawn.
Nullable<DateTimeOffset>	dateTime	date and time at start of the track.
Int32	trackWidth	X pixel dimension.
Int32	trackHeight	Y pixel dimension.

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawTimeTrack(TimeSpan, TimeSpan, TimeSpan, Int32, Int32, String)

Like the above method but adds a label at end displaying units of time.

Declaration

public static Image<Rgb24> DrawTimeTrack(TimeSpan fullDuration, TimeSpan startOffset, TimeSpan ticInterval, int trackWidth, int trackHeight, string title)

Parameters

Type	Name	Description
TimeSpan	fullDuration
TimeSpan	startOffset
TimeSpan	ticInterval
Int32	trackWidth
Int32	trackHeight
String	title

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawTitleTrack(Int32, Int32, String)

Declaration

public static Image<Rgb24> DrawTitleTrack(int trackWidth, int trackHeight, string title)

Parameters

Type	Name	Description
Int32	trackWidth
Int32	trackHeight
String	title

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawTrack(Image<Rgb24>)

Declaration

public void DrawTrack(Image<Rgb24> bmp)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp

DrawTrackTitle(Image<Rgb24>, String)

Declaration

public Image<Rgb24> DrawTrackTitle(Image<Rgb24> bmp, string title)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp
String	title

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawWaveEnvelopeTrack(AudioRecording, Int32)

Declaration

public static Image<Rgb24> DrawWaveEnvelopeTrack(AudioRecording recording, int imageWidth)

Parameters

Type	Name	Description
AudioRecording	recording
Int32	imageWidth

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawWaveEnvelopeTrack(Image<Rgb24>)

assumes that max signal value = 1.0 and min sig value = -1.0 i.e. wav file values.

Declaration

public Image<Rgb24> DrawWaveEnvelopeTrack(Image<Rgb24> bmp)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>	bmp

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawWaveEnvelopeTrack(Double[,])

assumes that max signal value = 1.0 and min sig value = -1.0 i.e. wav file values.

Declaration

public static Image<Rgb24> DrawWaveEnvelopeTrack(double[, ] envelope)

Parameters

Type	Name	Description
Double[,]	envelope

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawYearScale_horizontal(Int32, Int32)

Declaration

public static Image<Rgb24> DrawYearScale_horizontal(int trackWidth, int trackHeight)

Parameters

Type	Name	Description
Int32	trackWidth
Int32	trackHeight

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

DrawYearScaleVertical(Int32, Int32)

Declaration

public static Image<Rgb24> DrawYearScaleVertical(int offset, int trackHeight)

Parameters

Type	Name	Description
Int32	offset
Int32	trackHeight

Returns

Type	Description
SixLabors.ImageSharp.Image<SixLabors.ImageSharp.PixelFormats.Rgb24>

GetDecibelTrack(BaseSonogram)

ASSUME that passed decibel array has been normalised.

Declaration

public static ImageTrack GetDecibelTrack(BaseSonogram sg)

Parameters

Type	Name	Description
BaseSonogram	sg

Returns

Type	Description
ImageTrack

GetNamedScoreTrack(Double[], Nullable<Double>, Nullable<Double>, Nullable<Double>, String)

Declaration

public static ImageTrack GetNamedScoreTrack(double[] scores, double? scoreMin, double? scoreMax, double? scoreThreshold, string name)

Parameters

Type	Name	Description
Double[]	scores
Nullable<Double>	scoreMin
Nullable<Double>	scoreMax
Nullable<Double>	scoreThreshold
String	name

Returns

Type	Description
ImageTrack

GetScoreTrack(Double[], Nullable<Double>, Nullable<Double>, Nullable<Double>)

Declaration

public static ImageTrack GetScoreTrack(double[] scores, double? scoreMin, double? scoreMax, double? scoreThreshold)

Parameters

Type	Name	Description
Double[]	scores
Nullable<Double>	scoreMin
Nullable<Double>	scoreMax
Nullable<Double>	scoreThreshold

Returns

Type	Description
ImageTrack

GetScoreTrack(Int32[], Nullable<Int32>, Nullable<Int32>, Nullable<Int32>)

Declaration

public static ImageTrack GetScoreTrack(int[] scores, int? scoreMin, int? scoreMax, int? scoreThreshold)

Parameters

Type	Name	Description
Int32[]	scores
Nullable<Int32>	scoreMin
Nullable<Int32>	scoreMax
Nullable<Int32>	scoreThreshold

Returns

Type	Description
ImageTrack

GetSegmentationTrack(BaseSonogram)

ASSUME that passed decibel array has been normalised.

Declaration

public static ImageTrack GetSegmentationTrack(BaseSonogram sg)

Parameters

Type	Name	Description
BaseSonogram	sg

Returns

Type	Description
ImageTrack

GetSimilarityScoreTrack(Double[], Nullable<Double>, Nullable<Double>, Nullable<Double>, Int32)

Declaration

public static ImageTrack GetSimilarityScoreTrack(double[] scores, double? scoreMin, double? scoreMax, double? scoreThreshold, int neighbourhoodLength)

Parameters

Type	Name	Description
Double[]	scores
Nullable<Double>	scoreMin
Nullable<Double>	scoreMax
Nullable<Double>	scoreThreshold
Int32	neighbourhoodLength

Returns

Type	Description
ImageTrack

GetSyllablesTrack(Int32[], Int32)

Declaration

public static ImageTrack GetSyllablesTrack(int[] SyllableIDs, int garbageID)

Parameters

Type	Name	Description
Int32[]	SyllableIDs
Int32	garbageID

Returns

Type	Description
ImageTrack

GetTimeTrack(TimeSpan, Double)

Declaration

public static ImageTrack GetTimeTrack(TimeSpan t, double pixelsPerSecond)

Parameters

Type	Name	Description
TimeSpan	t
Double	pixelsPerSecond

Returns

Type	Description
ImageTrack

GetWavEnvelopeTrack(AudioRecording, Int32)

Declaration

public static ImageTrack GetWavEnvelopeTrack(AudioRecording ar, int imageWidth)

Parameters

Type	Name	Description
AudioRecording	ar
Int32	imageWidth

Returns

Type	Description
ImageTrack

GetWavEnvelopeTrack(Double[,], Int32)

Declaration

public static ImageTrack GetWavEnvelopeTrack(double[, ] envelope, int imageWidth)

Parameters

Type	Name	Description
Double[,]	envelope
Int32	imageWidth

Returns

Type	Description
ImageTrack

GetXaxisTicLocations(Int32, TimeSpan)

returns array of bytes that is the gray scale color to use.

Declaration

public static byte[] GetXaxisTicLocations(int width, TimeSpan timeSpan)

Parameters

Type	Name	Description
Int32	width
TimeSpan	timeSpan

Returns

Type	Description
Byte[]

SetIntArray(Int32[])

Declaration

public void SetIntArray(int[] data)

Parameters

Type	Name	Description
Int32[]	data

Extension Methods

ObjectExtensions.NotNull(Object)

ObjectExtensions.AsArray<T>(T)

ObjectExtensions.AsList<T>(T)

ObjectExtensions.Wrap<T>(T)

SystemExtensions.BinarySerialize(Object)

ConfigFileExtensions.NotNull(Object, FileInfo, String, String)

ConfigFileExtensions.ValidateNotNull(Object, String, String)

ConfigFileExtensions.ValidateLessThan<T>(Object, Nullable<T>, String, Nullable<T>, String, String)

ExtensionsXml.SerializeObject<T>(T)