Initializes a new instance of the UnitConverters class. IMPORTANT NOTE: segmentDuration should be the duration spanned by the spectrogram image, not the actual duration recording. Given one frame per pixel column, the spectrogram duration = frameCount * seconds/frame.

Declaration

public UnitConverters(double segmentStartOffset, double segmentDuration, double nyquistFrequency, int imageWidth, int imageHeight)

Parameters

Type	Name	Description
Double	segmentStartOffset	Segment start relative to start of the recording.
Double	segmentDuration	Set the time-scale. The spectrogram time-span. Typically 60 seconds.
Double	nyquistFrequency	Sets the frequency scale.
Int32	imageWidth	Pixel width = number of time frames.
Int32	imageHeight	Pixel height = the number of frequency bins.

| Improve this Doc View Source

UnitConverters(Double, Int32, Int32)

Initializes a new instance of the UnitConverters class. Use this constructor or the next one when you have sample rate of recording from which spectrogram is derived. This constructor assumes that the step size equals the frame size. Enables calculations independent of the image size.

Declaration

public UnitConverters(double segmentStartOffset, int sampleRate, int frameSize)

Parameters

Type	Name	Description
Double	segmentStartOffset	Start time in seconds of the current recording segment.
Int32	sampleRate	Sample rate of the recording segment.
Int32	frameSize	The window or frame size.

| Improve this Doc View Source

UnitConverters(Double, Int32, Int32, Double)

Initializes a new instance of the UnitConverters class. Use this constructor or the above when you have sample rate of recording from which spectrogram is derived. Enables calculations independent of the image size. Supplied with the frame overlap rather than the step size.

Declaration

public UnitConverters(double segmentStartOffset, int sampleRate, int frameSize, double frameOverlap)

Parameters

Type	Name	Description
Double	segmentStartOffset	Start time in seconds of the current recording segment.
Int32	sampleRate	Sample rate of the recording segment.
Int32	frameSize	The window or frame size.
Double	frameOverlap	Fractional overlap of frames.

| Improve this Doc View Source

UnitConverters(Double, Int32, Int32, Int32)

Initializes a new instance of the UnitConverters class. Use this constructor or the next one when you have sample rate of recording from which spectrogram is derived. Enables calculations independent of the image size.

Declaration

public UnitConverters(double segmentStartOffset, int sampleRate, int frameSize, int stepSize)

Parameters

Type	Name	Description
Double	segmentStartOffset	Start time in seconds of the current recording segment.
Int32	sampleRate	Sample rate of the recording segment.
Int32	frameSize	The window or frame size.
Int32	stepSize	THe step size which is LTE frame size.

Properties

| Improve this Doc View Source

FrameOverlap

Declaration

public double FrameOverlap { get; }

Property Value

Type	Description
Double

| Improve this Doc View Source

FrameSize

Declaration

public int FrameSize { get; }

Property Value

Type	Description
Int32

| Improve this Doc View Source

HertzPerFreqBin

Declaration

public double HertzPerFreqBin { get; }

Property Value

Type	Description
Double

| Improve this Doc View Source

NyquistFrequency

Declaration

public int NyquistFrequency { get; }

Property Value

Type	Description
Int32

| Improve this Doc View Source

SampleRate

Declaration

public int SampleRate { get; }

Property Value

Type	Description
Int32

| Improve this Doc View Source

SecondsPerFrame

Declaration

public double SecondsPerFrame { get; }

Property Value

Type	Description
Double

| Improve this Doc View Source

SecondsPerFrameStep

Declaration

public double SecondsPerFrameStep { get; }

Property Value

Type	Description
Double

| Improve this Doc View Source

SegmentStartOffset

Declaration

public double SegmentStartOffset { get; }

Property Value

Type	Description
Double

| Improve this Doc View Source

SpectralScale

Gets the spectral scale.

Declaration

public LinearScale SpectralScale { get; }

Property Value

Type	Description
LinearScale

Remarks

Measured in hertz per pixel.

| Improve this Doc View Source

StepSize

Declaration

public int StepSize { get; }

Property Value

Type	Description
Int32

| Improve this Doc View Source

TemporalScale

Gets the temporal scale. Measured in seconds per pixel. To converts seconds to pixels. From converts pixels to seconds.

Declaration

public LinearScale TemporalScale { get; }

Property Value

Type	Description
LinearScale

Methods

| Improve this Doc View Source

ConvertPointToSpectralPoint(Point, Double)

Declaration

public SpectralPoint ConvertPointToSpectralPoint(Point point, double value)

Parameters

Type	Name	Description
SixLabors.ImageSharp.Point	point
Double	value

Returns

Type	Description
SpectralPoint

| Improve this Doc View Source

FrameFromEndTime(Double)

Declaration

public int FrameFromEndTime(double endTime)

Parameters

Type	Name	Description
Double	endTime

Returns

Type	Description
Int32

| Improve this Doc View Source

FrameFromStartTime(Double)

Declaration

public int FrameFromStartTime(double startTime)

Parameters

Type	Name	Description
Double	startTime

Returns

Type	Description
Int32

| Improve this Doc View Source

GetEndTimeInSecondsOfFrame(Int32)

Declaration

public double GetEndTimeInSecondsOfFrame(int frameId)

Parameters

Type	Name	Description
Int32	frameId

Returns

Type	Description
Double

| Improve this Doc View Source

GetFrameCountFromSecondsDuration(Double)

Returns the number of frames for the passed duration in seconds. Do the calculations in signal samples. TODO: Question should we do round or floor?.

Declaration

public int GetFrameCountFromSecondsDuration(double seconds)

Parameters

Type	Name	Description
Double	seconds	The elapsed time.

Returns

Type	Description
Int32	The number of frames.

| Improve this Doc View Source

GetFreqBinFromHertz(Double)

Declaration

public int GetFreqBinFromHertz(double hertz)

Parameters

Type	Name	Description
Double	hertz

Returns

Type	Description
Int32

| Improve this Doc View Source

GetHertzFromFreqBin(Int32)

Declaration

public double GetHertzFromFreqBin(int bin)

Parameters

Type	Name	Description
Int32	bin

Returns

Type	Description
Double

| Improve this Doc View Source

GetHertzHighFromFreqBin(Int32)

Declaration

public double GetHertzHighFromFreqBin(int bin)

Parameters

Type	Name	Description
Int32	bin

Returns

Type	Description
Double

| Improve this Doc View Source

GetPixelRectangle(ISpectralEvent)

Gets a rectangle suitable for drawing.

Declaration

public RectangleF GetPixelRectangle(ISpectralEvent event)

Parameters

Type	Name	Description
ISpectralEvent	event	The event to get the border for.

Returns

Type	Description
SixLabors.ImageSharp.RectangleF	The rectangle representing the border.

Remarks

Top and left are floored to pixel boundaries. Width and height are rounded up. No border pixels are substracted from width or height!.

| Improve this Doc View Source

GetPixelRectangle(ISpectralPoint)

Declaration

public RectangleF GetPixelRectangle(ISpectralPoint point)

Parameters

Type	Name	Description
ISpectralPoint	point

Returns

Type	Description
SixLabors.ImageSharp.RectangleF

| Improve this Doc View Source

GetPoint(ISpectralEvent)

Gets the top and left of an event, in a fashion suitable for drawing.

Declaration

public PointF GetPoint(ISpectralEvent event)

Parameters

Type	Name	Description
ISpectralEvent	event	The event to get the point for.

Returns

Type	Description
SixLabors.ImageSharp.PointF	The point.

Remarks

Top and left are floored to pixel boundaries.

| Improve this Doc View Source

GetPoint(ISpectralPoint)

Declaration

public PointF GetPoint(ISpectralPoint point)

Parameters

Type	Name	Description
ISpectralPoint	point

Returns

Type	Description
SixLabors.ImageSharp.PointF

| Improve this Doc View Source

GetPointCentroid(ISpectralPoint)

Declaration

public PointF GetPointCentroid(ISpectralPoint point)

Parameters

Type	Name	Description
ISpectralPoint	point

Returns

Type	Description
SixLabors.ImageSharp.PointF

| Improve this Doc View Source

GetSecondsDurationFromFrameCount(Int32)

Returns the duration in seconds of the passed number of frames. NOTE: In the case where frames are overlapped, the last frame in any sequence is longer than the frame step. This correction becomes sgnificant when the frameCount is small.

Declaration

public double GetSecondsDurationFromFrameCount(int frameCount)

Parameters

Type	Name	Description
Int32	frameCount	The number of frames.

Returns

Type	Description
Double	Duration inseconds.

| Improve this Doc View Source

GetSize(ISpectralEvent)

Gets the width and height of an event.

Declaration

public SizeF GetSize(ISpectralEvent event)

Parameters

Type	Name	Description
ISpectralEvent	event	The event to get the size for.

Returns

Type	Description
SixLabors.ImageSharp.SizeF	The size.

Remarks

Width and height are rounded up.

| Improve this Doc View Source

GetStartTimeInSecondsOfFrame(Int32)

Declaration

public double GetStartTimeInSecondsOfFrame(int frameId)

Parameters

Type	Name	Description
Int32	frameId

Returns

Type	Description
Double

| Improve this Doc View Source

HertzToPixels(Double)

Declaration

public float HertzToPixels(double seconds)

Parameters

Type	Name	Description
Double	seconds

Returns

Type	Description
Single

| Improve this Doc View Source

PixelsToHertz(Single)

Declaration

public double PixelsToHertz(float pixels)

Parameters

Type	Name	Description
Single	pixels

Returns

Type	Description
Double

| Improve this Doc View Source

PixelsToSeconds(Single)

Declaration

public double PixelsToSeconds(float pixels)

Parameters

Type	Name	Description
Single	pixels

Returns

Type	Description
Double

| Improve this Doc View Source

RecordingRelativeToSegmentRelative(Double)

Declaration

public double RecordingRelativeToSegmentRelative(double seconds)

Parameters

Type	Name	Description
Double	seconds

Returns

Type	Description
Double

| Improve this Doc View Source

SecondsToPixels(Double)

Declaration

public float SecondsToPixels(double seconds)

Parameters

Type	Name	Description
Double	seconds

Returns

Type	Description
Single

| Improve this Doc View Source

SegmentRelativeToRecordingRelative(Double)

Declaration

public double SegmentRelativeToRecordingRelative(double seconds)

Parameters

Type	Name	Description
Double	seconds

Returns

Type	Description
Double

| Improve this Doc View Source

SetBounds<T>(T, Oblong)

Declaration

public void SetBounds<T>(T event, Oblong source)
    where T : SpectralEvent

Parameters

Type	Name	Description
T	event
Oblong	source

Type Parameters

Name	Description
T

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)