tget

tget(taskname=None, savefile='')

Recover saved values of the inputs to a task. If given a taskname, sets taskname as the current active (default) task.

Parameters

  • taskname (obj , string, or None) - task object or task name. None will use current active (default) task.

  • savefile (str) - Input file for the task inputs. default: <taskname>.last then <taskname>.saved. example: savefile=’tclean.orion’

Description

This is a convenient way to retrieve the paramaters used in a previous task invocation. Typing tget without a taskname will recover the saved parameter values for the task that is currently active (default). If a task (or task name) is provided for the taskname parameter, e.g. tget <task>, that task will become the active task and the parameter values will be restored for it.

The previous task parameter values are stored in files. By default, they are retrieved based upon the name of the task. This is done by searching for

  1. a <taskname>.last file

  2. a <taskname>.saved file

and then executing the Python in these files. For example,

default('gaincal') #set current active task to gaincal and default
tget #read saved inputs from gaincal.last (or gaincal.saved)
inp() #see these inputs!
tget bandpass #now get from bandpass.last (or bandpass.saved)
inp() #task is now bandpass, with recovered inputs

The savefile parameter can be used to cause tget to retrieve parameter values from a file with a different name. Supplying both the taskname and savefile parameters makes the specified task the active task and loads the defaults saved in the specified savefile, for example,

tget(gaincal,"ngc-calib.last")

If the taskname parameter is omitted, The active task is used. For example

default(tclean)
tget(savefile='good-clean.last')

Here, the active task is set with default(<task>) before loading the parameter values with tget.

Note: tget does not check whether the parameters in a named savefile came from the taskname or active task.