Clients

rasdaman can interface with a large and increasing number of tools. Some clients allow direct query submission, such as rasql and directql. For rapid development of browser clients the raswct toolkit is provided.

Geo tools supported include OpenLayers, QGIS, ncWMS, THREDDS, GDAL, MapServer, !ArcGIS; soon: GeoServer. Geo standards supported are OGC WMS, WCS, WCPS, and WPS; hence, all clients conforming to these standards can additionally be used for interfacing. All geo semantics is implemented through the petascope component (​source) which is implemented as a Java application layer offering OGC Web services.

rasdaman clients

• rasql is a command-line utility for sending queries and saving results in local files. It is part of the rasdaman package.
• raswct is the rasdaman Web Client Toolkit which allows, by way of input and output widgets, to easily compose a Web client. Simple versions need only HTML, but advanced interfaces can be created. One example for the use of raswct is ​standards.rasdaman.org.
• rview is a deprecated visual query interface for desktop use (executable). It is still part of the rasdaman package, but not maintained any longer. [executable: ]
• directql is not strictly a client, but a rasdaman server linked directly with the rasql utility (see above). This simplifies debugging for developers. (​source )

WCS clients

• WCS Web client: a generic Web client which allows for convenient forms-based input of WCS parameters for WCS Core and Extensions; all WCS extensions are supported, but the client presents only those extensions which are supported by the server addressed. Results can be displayed graphically where feasible. (​source )
• mobile clients (contributed by ​COMETA):
  • native Android app:
    • Google Play: ​https://play.google.com/store/apps/details?id=it.infn.ct.earthserverSGmobile
    • source: ​http://sourceforge.net/p/ctsciencegtwys/mobile/14/tree/trunk/Android/EarthServerSGMobile/
    • To check out the source code:

      svn checkout  svn://svn.code.sf.net/p/ctsciencegtwys/mobile/trunk/Android/EarthServerSGMobile EarthServerSGMobile
      

  • Appcelerator Titanium app built for iOS:
    • App Store: ​https://itunes.apple.com/us/app/earthserver-sg-mobile/id740603213?ls=1&mt=8
    • source: ​http://sourceforge.net/p/ctsciencegtwys/mobile/15/tree/trunk/iOS/EarthServer-SG-Mobile/
    • To check out src code:

      svn checkout  svn://svn.code.sf.net/p/ctsciencegtwys/mobile/trunk/iOS/EarthServer-SG-Mobile EarthServer-SG-Mobile
      

QGIS

This plugin enables the direct download, processing, integration and usage of Coverages from an OGC compliant WCPS 1.0 enabled servers within the QGIS software (v2.0+ supported). The plugin has been submitted to the official QGIS plugin repository, approval is pending; in the meantime it can be installed manually:

• get the rasdaman source tree:

  git clone git://rasdaman.org/rasdaman.git
  

• the plugin can be found in directory rasdaman/applications/qgis-wcps
• copy the qgis-wcps/QgsWcpsClient1 directory to your qgis-python-plugin directory, usually located in $HOME/.qgis2/python/plugins:

  $ mkdir -p $HOME/.qgis2/python/plugins/
  $ cp -r rasdaman/applications/qgis-wcps/QgsWcpsClient1 $HOME/.qgis2/python/plugins/
  

• now you can start QGIS and access the QgsWcpsClient1 plug-in via the Qgis Menu → Plugins → WcpsClient1 → WCPS 1.0 Client

OpenLayers

documentation tbd

ncWMS

documentation tbd

THREDDS

documentation tbd

GDAL

To compile GDAL with rasdaman support:

1. Get latest GDAL source
2. Compile and install (in the /home/rasdaman/gdal)

   ./configure --prefix=/home/rasdaman/gdal --mandir=/home/rasdaman/gdal/share/man --includedir=/home/rasdaman/gdal/include/gdal 
     --with-threads --with-grass=no --with-hide-internal-symbols=yes --with-libtiff=internal --with-geotiff=internal --with-jasper 
     --with-netcdf --with-xerces --with-geos --with-sqlite3 --with-curl --with-pg --with-ogdi --with-python --with-odbc 
     --with-static-proj4=yes --with-spatialite=/usr --with-cfitsio=no --with-epsilon=/usr --with-rasdaman=/home/rasdaman/install
   make
   make install
   

   • Note: rasdaman should be compiled with -fPIC, so make sure to specify --with-pic when running ./configure on rasdaman.
3. Setup environment

   export GDAL_HOME=/home/rasdaman/gdal
   export PATH=$PATH:$GDAL_HOME/bin
   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$GDAL_HOME/lib
   

ArcGIS

documentation tbd

GeoServer

documentation tbd

rview (deprecated)

rview is a desktop visualization client component of rasdaman, that communicates with rasdaman via RPC, so rpcbind/portmapper should be installed and running in order to use rview.

The rpcbind service has to be started in insecure mode, or rasdaman has to be started as root, in order for rview to be able to connect to rasdaman.

To start rpcbind in insecure mode:

# note that the service script location may vary among different Linux distributions
editor /etc/init.d/rpcbind

# or in recent Ubuntu's
editor /etc/init/portmap.conf

# then add '-i' to the OPTIONS variable

After the rpcbind is restarted, restart rasdaman and then rview can be opened with

#
cd $RMANHOME/bin
./rview

Important note: Rview is deprecated and unmaintained. For building clients use ​one of the Web client or the raswct library instead. In fact, there are strong reasons not to use rview: As highlighted using the RPC communication protocol is highly insecure and not recommended. Further, RPC communication is deprecated and will soon be replaced (together with HTTP and RNP) by a new, faster protocol.