utils

class utils[source]

Utility component, verified, xml translator

Methods Summary

c_exception

Returns detailed information from the last CASA C++ exception (i.e., AipsError).

c_exception_clear

Clears the CASA C++ exception information.

clearpath

Removes all directories from the data path.

compare_version

Returns a description string that includes the version information and the descriptive string..

defaultpath

Returns the default data path.

getagg

Returns the value of the agg parameter used at startup.

getcachedir

Returns the value of the cachedir parameter used at startup.

getnogui

Returns the value of the nogui parameter used at startup.

getpath

Returns the list of directories that are currently in the data path.

getpipeline

Returns the value of the pipeline parameter used at startup.

getpython

get path to python executable

getrc

getrc method

hostinfo

returns host information

initialize

returns True if initalization was performed; returns False if initialization was already done

lockedtables

get the tables locked by this process

maxint

maximum number an C++ int can hold

maxlong

maximum number an C++ long can hold

measurespath

path to the measures data

minint

minimum number an C++ int can hold

minlong

minimum number an C++ long can hold

registry

returns record containing the URI for the CASAtools registry which can be used by other unix processes to access the registry

remove_service

Remove a service from the registry using the URI for the service.

removetable

removetable method

resolve

If the provided path already represents a file or a directory, it is returned.

rundata

path to the measures data.

services

returns record containing the information about the services that have been registered with CASAtools

setmeasurespath

Set path to the measures data.

setpath

Sets the data path to the specified list of directories.

setrundata

Set path to the measures data.

shutdown

python is shutting down cleanup anything that is outstanding

tableinfo

Currently this only returns the pid of the process locking the table (lockpid), if the lock is permanent (lockperm), and the status (lockstatus) – ’not in use’, ’open’, ’read’, ’write’, or ’unknown’.

toolversion

Returns a two element vector representing the CASAtools version (year, build).

toolversion_string

Returns a description string that shows the CASA 6 CASAtools version information as a descriptive string.

tryit

test variant convesion

utils

Construct a utility tool

version

Returns a four element vector representing the version (major, minor, patch and feature).

version_desc

The descriptive string describes a particular packaged version.

version_info

Returns a description string that includes the version information and the descriptive string..

version_string

Returns a description string that includes the version information and the descriptive string..

version_variant

Returns the target instrument.

c_exception()[source]

Returns detailed information from the last CASA C++ exception (i.e., AipsError). The exception message and the stack trace (mangled; use the shell’s c++filt to demangle) from the last CASA C++ exception. The information is from the last one generated and may not represent an exception from the last action; c_exception_clear can be used to remove stale information. The information’s exception might also have been caught in the C++ code and not have been translated into a Python-level exception.

c_exception_clear()[source]

Clears the CASA C++ exception information. This allows the user to be sure that information retrieved using c_exception is not from an exception in the distant past.

clearpath()[source]

Removes all directories from the data path.

compare_version(comparitor='', vec='')[source]

Returns a description string that includes the version information and the descriptive string..

Parameters

  • comparitor (string='') - what sort of comparison to do, one of >, <, <=, >=, ==, = !=

  • vec (intVec='') - vector to use to compare current version number against vec

Returns

bool

defaultpath()[source]

Returns the default data path. This path is used unless the user has set the current path to something else using the setpath function.

getagg()[source]

Returns the value of the agg parameter used at startup. Defaults to False.

getcachedir()[source]

Returns the value of the cachedir parameter used at startup.

getnogui()[source]

Returns the value of the nogui parameter used at startup. Defaults to False.

getpath()[source]

Returns the list of directories that are currently in the data path.

getpipeline()[source]

Returns the value of the pipeline parameter used at startup. Defaults to False.

getpython()[source]

get path to python executable

getrc(rcvar='')[source]

getrc method

Parameters

  • rcvar (string='') - Returns the value of the rc variable given. If no value is give it returns the root directory of CASA.

Returns

string

hostinfo()[source]

returns host information

initialize(python_path='')[source]

returns True if initalization was performed; returns False if initialization was already done

Parameters

  • python_path (string='') - path to python executable

Returns

bool

lockedtables()[source]

get the tables locked by this process

maxint()[source]

maximum number an C++ int can hold

maxlong()[source]

maximum number an C++ long can hold

measurespath()[source]

path to the measures data

minint()[source]

minimum number an C++ int can hold

minlong()[source]

minimum number an C++ long can hold

registry()[source]

returns record containing the URI for the CASAtools registry which can be used by other unix processes to access the registry

remove_service(uri='')[source]

Remove a service from the registry using the URI for the service. The URI should be a string that looks something like “0.0.0.0:34101”. This function returns True if the removal was successful. Otherwise, it returns False.

Parameters

  • uri (string='') - uri (Address) of the service to remove.

Returns

bool

removetable(tablenames='')[source]

removetable method

Parameters

  • tablenames (stringVec='') - Removes tables safely

Returns

bool

resolve(path='')[source]

If the provided path already represents a file or a directory, it is returned. If it does not, this function tries to find a complete path by matching up this partial directory with the elements of the data path.

Parameters

  • path (string='') - path to be expanded

Returns

string

rundata()[source]

path to the measures data. This function is deprecated measurespath should be used instead.

services()[source]

returns record containing the information about the services that have been registered with CASAtools

setmeasurespath(path='')[source]

Set path to the measures data. Must be called during initalization before Measures module is initialized.

Parameters

  • path (string='') - path to IERS data

setpath(dirs='')[source]

Sets the data path to the specified list of directories. Returns True if all directories were added returns False otherwise.

Parameters

  • dirs (stringVec='') - directories that should constitute the data path

Returns

bool

setrundata(path='')[source]

Set path to the measures data. Must be called during initalization before Measures module is initialized. This function is deprecated. setmeasurespath should be used instead.

Parameters

  • path (string='') - path to IERS data

shutdown()[source]

python is shutting down cleanup anything that is outstanding

tableinfo(tablename='')[source]

Currently this only returns the pid of the process locking the table (lockpid), if the lock is permanent (lockperm), and the status (lockstatus) – ’not in use’, ’open’, ’read’, ’write’, or ’unknown’. However, the hope is that this will eventually return a complete description of the table.

Parameters

  • tablename (string='') - path to table

Returns

record

toolversion()[source]

Returns a two element vector representing the CASAtools version (year, build). This is only returned with CASA 6. With CASA 5, an zero element vector is returned.

toolversion_string()[source]

Returns a description string that shows the CASA 6 CASAtools version information as a descriptive string. With CASA 5, a zero length string is returned.

tryit(input='')[source]

test variant convesion

Parameters

  • input (record='') - testing variant

Returns

double

utils()[source]

Construct a utility tool

version()[source]

Returns a four element vector representing the version (major, minor, patch and feature).

version_desc()[source]

The descriptive string describes a particular packaged version. During a development cycle there are different sorts of packaged distributions. For example, a development version (“DEV”) or a release version (“REL”).

version_info()[source]

Returns a description string that includes the version information and the descriptive string..

version_string()[source]

Returns a description string that includes the version information and the descriptive string..

version_variant()[source]

Returns the target instrument. This helps distinguish versions that otherwise may have the same version number