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), MacOSX, Solaris, Cygwin*.

*see special notes on Cygwin.

Where do I get it?

Here is a current (January 2011) 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
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 db.irfu.se:0
Cluster
CSDS_PP
CSDS_SP

>iscmd d db.irfu.se:0/Cluster/1/efw/E/p4/10Hz/lx 2002-02-01 00:00:30 1
##Dataformat: IsdatFlatFile (ISFF) version=1.0 for ISDAT DbDataObject
##URI: isdat://db.irfu.se:0/Cluster/1/efw/E/p4/10Hz/lx 2002-02-01 00:00:30.0
#rank:          0
#complete:      complete
#dataType:      real float
#dimension:     0
#version:       2.8.2.2.2
#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/igr

> ctm
Environment variable ISDAT_DATABASE is not set
Using default database db.irfu.se:0

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)
  libtool (Devel: libtool)
  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 startxwin.sh in the Cygwin prompt) to run ctm/igr; (2) Matlab client does not and will never work on Cygwin.


Valid HTML 4.01! © 2007,2011 Yuri Khotyaintsev
http://www.space.irfu.se/isdat/isdat-clients/index.html
last modified on Sunday, 02-Jan-2011 22:29:04 CET