class IQData {
     constructor IQData( [string name] );

     dump() ; // prints details on the std out
     forceFloat(); // make sure internal data is in float format and not in original format
     number getChannelCount() ; // number of channels in the data , by default 1

     // load IQ samples from an existing file, supported formats : CS16, CF32, WAV
     boolean loadFromFile( string filename ); 
     // Save IQ Data to a file, supported formats : CS16, CF32, WAV
     boolean saveToFile( string filename  , [option:channel]); 
     // append IQ Data to a file, supported formats : CS16, CF32 (no WAV)
     bool appendToFile( string filename  , [option:channel]); 

     getSamples( int start, array ,[option:channel]); - where array : a = new Float32Array(2*size)
     setSamples( int start, array ,[option:channel]);

     Samples getReal([option:channel])  ; // returns real part
     Samples getImag([option:channel])  ; // returns imag part

     freqShift( number freqHz );

     number getLength() ; // length in samples
     setLength( number of samples , number_of_channels) ; // truncate or extend

     number getSampleRate();
     setSampleRate( number );  // change the samplerate

     number getCenterFrequency();
     setCenterFrequency( number );

     number getTimestamp(); // returns the timestamp for the first sample of this block (milliseconds since 01/01/1970)
     number getDuration() ; // returns the duration in seconds ( number of samples / sample rate)
     Object getGPS() ; // returns coordinates associated to this IQ Data block

     number rms( [option:channel] );

     object getAC( length , [option:channel]) ; // returns autocorrelation object
     object getPowerSpectrum( spectrum_width , [option:channel]);
     bool   CSVSpectrum( spectrum_width, filename, [option:channel]);

     IQData part( number sart, number samples , [option:channel]); // extract a subpart of the IQ
     bool append( IQData );

     readFromQueue( IQQueue object ) ; // replaces current samples with what is in the queue - waits (locks task)

     FloatData getReal() ; // returns the real part in a FloatData object
     FloatData getImag() ; // returns the imaginary part in a FloatData object

     // Attribute management
     bool setAttribute( JSONObjet ); // Add an attribute JSON object to the IQ Data
     JSONObjet getAttribute();       // retrieve attribute object

     Object toJSON( start, count ) ; // convert to a Javascript representation the internal data, from start to start+count

}

// Define and load IQ object
var o = new IQData('');
if( !o.loadFromFile('/tmp/dvbs.cf32') ) {
    exit(); 
}
// Set frequency and samplerate
o.setCenterFrequency( 100 );
o.setSampleRate(8e6);

print('we have '+ o.getLength() + ' samples recorded at '+ o.getCenterFrequency() + ' MHz, Bandwidth : ' + o.getSampleRate() / 1e3 + ' kHz');
print('file length:' + o.getDuration() + ' secs.');

// Extract 1024 sample from offset 10 ,as array (1024 Isamples and 1024 Qsamples)
var rawIQ = new Float32Array(1024*2);
var n = o.getSamples( 10, rawIQ );
print('extracted ' + n + ' IQ Pairs');
We have loaded ' + satlist.length + ' sat definitions.');

var o = new IQData('');
if( !o.loadFromFile('/tmp/dvbs.cf32') ) {
    exit(); 
}
o.dump();

var rx = ...
var IQ = rx.CaptureAllChannels();
var channels = IQ.getChannelCount();

var o = new IQData('');
o.loadFromFile('/opt/sdrnode/test.cf32');
print('We have loaded ' + o.getLength() + ' samples');

     setLength( number of samples [,number_of_channels] ) ;

 .getSampleRate();

.getCenterFrequency();

.setSampleRate(SR_Hz);

var o = new IQData('');
o.loadFromFile('/tmp/dvbs.cf32');
o.setSampleRate(8e6);

.setCenterFrequency(Freq_MHz);

var o = new IQData('/tmp/test.cf32');
o.setCenterFrequency(98);
var x = o.getCenterFrequency();
print(x);

    var o = new IQData('');
    o.loadFromFile('/tmp/dvbs.cf32');
    o.setSampleRate(8e6);
    print('Size:' + o.getLength() + "  - SR: "  o.getSampleRate() + "  - duration: " o.getDuration() + ' secs.');

{
    "gps_fix" : boolean,
    "latitude_N" : number,
    "longitude_E" : number,
    "altitude" : number
}

    var IQ = rx.Capture( 1000 ); // capture 1000 samples from RX
    var pos = rx.getGPS();
    if( pos.gps_fix == true ) {
        print('Received at ' + pos.latitude_N + "," + pos.longitude_E ) ;
    }

var x = new IQData('x');
var timestamp = x.getTimeStamp();

var o = new IQData('');
if( !o.loadFromFile('/opt/sdrnode/dvbs.cf32') ) {
    exit(); 
}

.saveToFile(filename, [option:channel]);

radio.setRxCenterFreq( 466 );
var IQ = radio.Capture( 10000 );
IQ.dump();
IQ.saveToFile('capture.cf32') ;

{
 "datatype": "power_spectrum",
 "fft_size": your_fft_size,
 "sample_rate": radio_sample_rate_Hz,
 "channel": radio_channel_used,
 "timestamp": number, /* number of milliseconds since 01/01/1970 */
 "position" : {
 "gps_fix": boolean,
 "latitude_N": number,
 "longitude_E": number,
 "altitude" : number
  }
  "peaks" : [ array of peaks, see below ],
  "spectrum": []
}

var IQ = radio.Capture( 10000 );
var spectrum = IQ.getPowerSpectrum( fft ) ; 
peaks = spectrum.peaks ;
print('Peaks object:' + JSON.stringify( peaks ));

[
 {"frequency":0, "value":-99.626,"index":256},
 {"frequency":-0.038, "value":-114.254, "index":158},
 {"frequency":-0.047, "value":-114.162, "index":133},
 ...
]

bool CSVSpectrum( fft_size, filename, [option:channel]) ; 

var rx = Soapy.makeDevice( {'query' : 'driver=rtlsdr' });
rx.setRxSampleRate( 2e6 );
rx.setRxCenterFreq( 105.5 );
for( var i=0 ; i < 100 ; i++ ) {
 var samples = rx.Capture( 2e6 ) ;
 samples.CSVSpectrum( 1024, 'test.csv');
}

.getAC( length , [option:channel]) ;

getSamples(start, array)

var o = new IQData('');
o.loadFromFile('/opt/sdrnode/test.cf32');
print(o.getLength() + ' samples');
var rawIQ = new Float32Array(1024*2);
var n = o.getSamples( 10, rawIQ );
print('extracted ' + n + ' IQ Pairs');

.part(offset_start,size, [option int channel]);

var o = new IQData('');
o.loadFromFile('/opt/sdrnode/test.cf32');
// get 1024 complex from o, starting at index 1024
var subdata = o.part( 1024, 1024) ;

.append(IQ_data);

var IQ = DSP.tone( 440, 1000, 12500 );
IQ.append( DSP.tone( 880, 1000, 12500) );
IQ.dump();
IQ.saveToFile('/save/tone.cf32');

.freqShift(freq_Hz);

// load the searched signal
var IQ = new IQData('');
IQ.loadFromFile('/tmp/signal.wav');
// shift the searched signal
IQ.freqShift( -300 );
IQ.dump();

var IQ = DSP.tone( 440, 1000, 1000 );

var x = { 'field_a' : 4, 'field_b' : 12 } ;
IQ.setAttribute( x );

var q = Queues.create( 'queue');
// Get a block 
var IQ = q.dequeue(true); // blocking mode, we wait to have something 
var x = IQ.getAttribute();