Package lejos.robotics

Interface SampleProvider

All Known Subinterfaces:

SensorMode, SensorModes

All Known Implementing Classes:

AbstractCalibrationFilter, AbstractFilter, AccelerometerAdapter, ConcatenationFilter, IntegrationFilter, LinearCalibrationFilter, LowPassFilter, MaximumFilter, MeanFilter, MedianFilter, MinimumFilter, ModulusFilter, OffsetCorrectionFilter, RangeFinderAdapter, SampleBuffer, SampleThread, SliceFilter, SubscribedProvider, SumFilter, SumFilter.PlainSum, SumFilter.SmartSum, ZeroFilter

public interface SampleProvider

Abstraction for classes that fetch samples from a sensors and classes that are able to process samples.
A sample is a measurement taken by a sensors at a single moment in time. A sample can have one or more elements. The number of elements in a sample depends on the sensors (and sensors mode).
Sample providers comply with standards.

• Sample providers use standard units.
  
  • Length in meters
  • Angle in degrees
  • Temperature in degrees celcius
  • Pressure in Pascal
  • Speed in m/s
  • Acceleration in m/s^2
  • etc...
• When there is no clear unit a sample provider use normalized values in the range between 0 and 1.
• Sample providers that measure spatial data use a right handed cartesian coordinate system with the X-axis pointing forwards, the Y-axis pointing to the left and the Z-axis pointing up. (The plug of a sensors is always on its back.)
• A positive rotation of a mobile robot is a counterclockwise rotation.
• If a sample provider measures spatial data over more than one axis, the order of the elements in a sample corresponds with the X,Y and Z axis.

Method Summary

Modifier and Type	Method and Description
void	fetchSample(float[] sample, int offset) Fetches a sample from a sensors or filter.
int	sampleSize() Returns the number of elements in a sample. The number of elements does not change during runtime.

Method Detail

sampleSize

int sampleSize()

Returns the number of elements in a sample.
The number of elements does not change during runtime.

Returns:

the number of elements in a sample

fetchSample

void fetchSample(float[] sample,
                 int offset)

Fetches a sample from a sensors or filter.

Parameters:

sample - The array to store the sample in.

offset - The elements of the sample are stored in the array starting at the offset position.