• Antelope Release 5.2-64 Mac OS X 10.6.8 2012-04-24

 

NAME

pythondatascope_raw - Raw interface to Datascope routines for Python

SYNOPSIS

sys.path.append( os.environ['ANTELOPE'] + '/data/python' )

import antelope._datascope as _datascope

db =
_datascope._dbopen (dbname, perm)

db =
_datascope._dbopen_database (dbname, perm)

db =
_datascope._dbopen_table (dbname, perm)

rc =
_datascope._dbclose (db)

rc =
_datascope._dbdelete (db)

rc =
_datascope._dbmark (db)

rc =
_datascope._dbcrunch (db)

rc =
_datascope._dbtruncate (db, nrecords)

rc =
_datascope._dbdestroy (tr)

db =
_datascope._dbtmp (schema)

rc =
_datascope._dbcreate (filename, schema, dbpath, description, detail)

rc =
_datascope._dbfree (db)

db =
_datascope._dblookup (db, database, table, field, record)

db =
_datascope._dbsubset (db, expr, name)

db =
_datascope._dblist2subset (db, list)

db =
_datascope._dbseparate (db, tablename)

db =
_datascope._dbsever (db, tablename, name)

val =
_datascope._dbex_eval (db, expr, type)

path =
_datascope._dbextfile (db, tablename)

rc =
_datascope._dbfind (db, expr, first, reverse)

rows =
_datascope._dbmatches (dbk, dbt, hookname, kpattern, tpattern)

db =
_datascope._dbprocess (db, list)

db =
_datascope._dbinvalid ()

db =
_datascope._dbsort (db, keys, unique, reverse, name)

db =
_datascope._dbjoin (db1, db2, pattern1, pattern2, outer, name)

db =
_datascope._dbnojoin (db1, db2, pattern1, pattern2, name)

db =
_datascope._dbtheta (db1, db2, ex_str, outer, name)

rc =
_datascope._dbunjoin (db, database_name, rewrite)

db =
_datascope._dbgroup (db, groupfields, name, type)

db =
_datascope._dbungroup (db, name)

(s,e) =
_datascope._dbget_range (db)

xml =
_datascope._db2xml (db, rootnode, rownode, fields, expressions, primary)

rc =
_datascope._dbaddnull (db)

rc =
_datascope._dbaddv (db, table, field, value [, field, value...])

rec =
_datascope._dbget (db, scratch)

rc =
_datascope._dbput (db, string )

rc =
_datascope._dbadd (db, string )

vals =
_datascope._dbgetv (db, field [, field...])

rc =
_datascope._dbputv (db, field, value [, field, value...])

res =
_datascope._dbquery (db, code)

id =
_datascope._dbnextid (db, name)

rc =
_datascope._trfilter (tr, filter_string)

((t,v),(t,v),...) =
_datascope._trsample (db, t0, t1, sta, chan, apply_calib, filter)

((t,min,max),(t,min,max),...) =
_datascope._trsamplebins (db, t0, t1, sta, chan, binsize, apply_calib, filter)

tr =
_datascope._trloadchan (db, t0, t1, sta, chan)

tr =
_datascope._trload_css (db, t0, t1, tr, table)

tr =
_datascope._trload_cssgrp (db, t0, t1, tr, table)

rc =
_datascope._trapply_calib (tr)

data =
_datascope._trdata (tr)

((min,max),(min,max),...) =
_datascope._trdatabins (tr, binsize)

rc =
_datascope._trputdata (tr, data)

rc =
_datascope._trrotate (tr, phi_deg, theta_deg, newchan)

rc =
_datascope._trrotate_to_standard (tr, newchan)

rc =
_datascope._trsplice (tr)

(rc, units, desc) =
_datascope._trlookup_segtype (segtype)

(rc, path) =
_datascope._trwfname (db, pattern)

rc =
_datascope._trtruncate (tr, leave)

rc =
_datascope._trfree (tr)

rc =
_datascope._trdestroy (tr)

rc =
_datascope._trsplit (tr)

rc =
_datascope._trsave_wf (tr, db, datatype, wfname, append, overwrite)

trout =
_datascope._trcopy (trout, trin)

DESCRIPTION

The Python _datascope module provides a thin Python wrapper for the underlying Antelope Datascope library functions. This version of the interface is not intended for normal use by Python programmers, however it is documented for the convenience of developers. Many of these python functions are direct wrappers around the C-language interfaces in the Datascope library. This man-page documents the syntax of these commands as represented in this Python interface. Further information on how to use any given command and the actual work it performs may be obtained from the man page for the C-language version of the respective command. For example, this man page will explain the syntax of the python dbsubset function. However, for a full explanation of dbsubset, see the dbsubset(3) man page.

_datascope functions

_datascope Constants

The following named constants are defined for use by the _datascope module:

_datascope.dbALL                    _datascope.dbALTERNATE_KEY          _datascope.dbBDOUBLE
_datascope.dbBFLOAT                 _datascope.dbBINT                   _datascope.dbBOOLEAN
_datascope.dbBSHORT                 _datascope.dbCOUNT                  _datascope.dbDATABASE_COUNT
_datascope.dbDATABASE_DESCRIPTION   _datascope.dbDATABASE_DETAIL        _datascope.dbDATABASE_FILENAME
_datascope.dbDATABASE_FILES         _datascope.dbDATABASE_IS_WRITABLE   _datascope.dbDATABASE_IS_WRITEABLE
_datascope.dbDATABASE_NAME          _datascope.dbDBPATH                 _datascope.dbDBPTR
_datascope.dbDESCRIPTION            _datascope.dbDETAIL                 _datascope.dbFIELD_BASE_TABLE
_datascope.dbFIELD_COUNT            _datascope.dbFIELD_DESCRIPTION      _datascope.dbFIELD_DETAIL
_datascope.dbFIELD_FORMAT           _datascope.dbFIELD_INDEX            _datascope.dbFIELD_NAME
_datascope.dbFIELD_RANGE            _datascope.dbFIELD_SEPARATOR        _datascope.dbFIELD_SIZE
_datascope.dbFIELD_TABLES           _datascope.dbFIELD_TYPE             _datascope.dbFIELD_UNITS
_datascope.dbFOREIGN_KEYS           _datascope.dbFORMAT                 _datascope.dbIDSERVER
_datascope.dbINTEGER                _datascope.dbINVALID                _datascope.dbLASTIDS
_datascope.dbLINK                   _datascope.dbLINK_FIELDS            _datascope.dbLOCKS
_datascope.dbNAME                   _datascope.dbNULL                   _datascope.dbOUTER_JOIN
_datascope.dbPRIMARY_KEY            _datascope.dbREAL                   _datascope.dbRECORD_COUNT
_datascope.dbRECORD_SEPARATOR       _datascope.dbRECORD_SIZE            _datascope.dbRESPONSE
_datascope.dbSCHEMA_DEFAULT         _datascope.dbSCHEMA_DESCRIPTION     _datascope.dbSCHEMA_DETAIL
_datascope.dbSCHEMA_FIELDS          _datascope.dbSCHEMA_LIST            _datascope.dbSCHEMA_NAME
_datascope.dbSCHEMA_TABLES          _datascope.dbSCRATCH                _datascope.dbSIZE
_datascope.dbSORT_REVERSE           _datascope.dbSORT_UNIQUE            _datascope.dbSTRING
_datascope.dbTABLE_ADDRESS          _datascope.dbTABLE_COUNT            _datascope.dbTABLE_CREATION
_datascope.dbTABLE_DESCRIPTION      _datascope.dbTABLE_DETAIL           _datascope.dbTABLE_DIRNAME
_datascope.dbTABLE_FIELDS           _datascope.dbTABLE_FILENAME         _datascope.dbTABLE_IS_ADDABLE
_datascope.dbTABLE_IS_TRANSIENT     _datascope.dbTABLE_IS_VIEW          _datascope.dbTABLE_IS_WRITABLE
_datascope.dbTABLE_IS_WRITEABLE     _datascope.dbTABLE_NAME             _datascope.dbTABLE_PRESENT
_datascope.dbTABLE_SIZE             _datascope.dbTIME                   _datascope.dbTIMEDATE_NAME
_datascope.dbTYPE                   _datascope.dbUNIQUE_ID_NAME         _datascope.dbVIEW_TABLE_COUNT
_datascope.dbVIEW_TABLES            _datascope.dbWAVEFORM               _datascope.dbYEARDAY

_datascope.strEXPR                  _datascope.strFIELD                 _datascope.strINTEGER
_datascope.strNULL                  _datascope.strREAL                  _datascope.strSTRING
_datascope.strTIME                  _datascope.strUNKNOWN

EXAMPLE

A short example is shown below.

import sys
import os
import pylab

sys.path.append( os.environ['ANTELOPE'] + '/data/python' )

from antelope.datascope import *

db = dbopen( "/opt/antelope/data/db/demo/demo", "r" )

tr = trloadchan( db, 706139719.05000, 706139855.95000, "TKM", "BHZ" )

tr[3] = 0

v = trdata( tr )

pylab.plot(v)

pylab.savefig('dataplot.png',dpi=100)

os.system( "open dataplot.png" )

SEE ALSO

antelope_python(3y), pythondatascope(3y)

AUTHOR

Kent Lindquist
Printer icon