User friendly ISDAT clients

What is this?

ISDAT is a database for accessing satellite data, in particular Cluster and Cassini. This page is part of an attemp to create an easy to install distrtibution of ISDAT clients. The distribution includes the following clients:

On which platforms does it run?

UNIX like environment is needed. The following platforms were tested: FreeBSD(i386 and amd64), Linux (amd64), Solaris, Cygwin*.

*see special notes on Cygwin.

Where do I get it?

Here is a current (Aug 19, 2009) distribution: isdat-clients-2.9.0.tar.gz

How to install*?

*see also special notes on Cygwin.

Unpack the distribution

> gunzip isdat-clients-2.9.0.tar.gz
> tar xvf isdat-clients-2.9.0.tar
> cd isdat-clients-2.9.0

Compile and install

> ./configure --prefix=/usr/local/isdat --with-matlab=/opt/matlab
> make
> make install

This will give you iscmd and ctm installed under /usr/local/isdat/bin. You can optionally create links under /usr/local/bin:

> cd /usr/local/bin
> ln -s /usr/local/isdat/bin/iscmd .
> ln -s /usr/local/isdat/bin/ctm .

How to run?


> iscmd
iscmd: Usage: iscmd p|q|c|d|i [isdat_URL] [start_time] [duration] [tm]
                isdat_URL  := isdat://host.domain:port_no/logical_instr
                start_time := yyyy-mm-dd hh:mm:ss.ns
                p :  (ping) check if server is alive
                q :  (query) list constituents of logical_instr
                c :  (contents) list intervals of available data
                d :  (data) get logical_instr data from start_time for duration
                i :  (indexgen) generate index files for logical_instr
                tm:  Returns TM data and not the default calibrated data

> iscmd q

>iscmd d 2002-02-01 00:00:30 1
##Dataformat: IsdatFlatFile (ISFF) version=1.0 for ISDAT DbDataObject
##URI: isdat:// 2002-02-01 00:00:30.0
#rank:          0
#complete:      complete
#dataType:      real float
#dimension:     0
#pack:          pack timetag
#reduction:     reduction none
#gapFill:       undefined gap fill
#dataSpecPath:  /Cluster/1/efw/E/p4/10Hz/lx
#quantity:      amplitude
#units:         V
#samplingFreq:  5
#filterFreq:    0
#coordSys:      Spacecraft_ref
#rotMat:        [1 0 0; 0 1 0; 0 0 1]
#start:         2002-02-01 00:00:30.0
#segments:      1
#samples:       5
##Time [s]      Data [V]
#seg_samples: 5
0.046102        -5.85953
0.246102        -5.83019
0.446102        -5.81972
0.646102        -5.93285
0.846102        -6.07323


> ctm
Environment variable ISDAT_DATABASE is not set
Using default database

select clients->general->igr. In IGR select instrument->Cluster->1->efw, parameter->E->p4->10Hz->lx. Press update in CTM window, or right click on the empty panel in IGR.

Matlab client

> LD_LIBRARY_PATH=/usr/local/isdat/lib matlab
inside MATLAB:
>> addpath('/usr/local/isdat/clients/APIs/matlab/Db_mex')
>> addpath('/usr/local/isdat/clients/APIs/matlab/matlib')
>> help matlib

How to report bugs?

All questions regardin installation/compilation should be e.mailed together with a config.log file to yuri NOSPAMAT irfu DOT se. All other bugs must be submitted via ISDAT Bug Reporting Page.

Special notes on Cygwin

Cygwin allows you to have a UNIX-like environment on Windows. You need to install Cygwin on your PC (including X) before you proceed with installation of ISDAT clients. Here is a list of additional packages needed:

  bison (Devel: bison)
  flex (Devel: flex)
  gcc (Devel: gcc)
  make (Devel: make)
  file (Utils: file)
  lesstif (X11: lesstif)
  X headers (X11: xorg-x11-devel)

After this you can follow the usual installation and running instructions.

NOTE: (1) X must be running (type in the Cygwin prompt) to run ctm/igr; (2) Matlab client does not and will never work on Cygwin.

Valid HTML 4.01! © 1998-2012 Yuri Khotyaintsev
last modified on Wednesday, 19-Aug-2009 19:30:10 CEST