main¶
- sofia_redux.pipeline.sofia.sofia_app.main()[source]¶
Run the Redux GUI.
The Redux application may be started from the command line with the command:
redux
Input files may then be loaded via the File menu (File -> Open New Reduction). Redux will determine the appropriate reduction object for the input data, and load all necessary pipeline steps.
Each reduction step has a number of parameters that can be edited before running the step. To examine or edit these parameters, click the Edit button next to the step name to bring up the parameter editor for that step. Within the parameter editor, all values may be edited. Click OK to save the edited values and close the window. Click Reset to restore any edited values to their last saved values. Click Restore Defaults to reset all values to their stored defaults. Click Cancel to discard all changes to the parameters and close the editor window.
The current set of parameters can be displayed, saved to a file, or reset all at once using the Parameters menu. A previously saved set of parameters can also be restored for use with the current reduction (Parameters -> Load Parameters).
After all parameters for a step have been examined and set to the user’s satisfaction, a processing step can be run on all loaded files either by clicking Step, or the Run button next to the step name. Each processing step must be run in order, but if a processing step is selected in the Step through: widget, then clicking Step will treat all steps up through the selected step as a single step and run them all at once. When a step has been completed, its buttons will be grayed out and inaccessible. It is possible to undo one previous step by clicking Undo. All remaining steps can be run at once by clicking Reduce. After each step, the results of the processing may be displayed in a data viewer. After running a pipeline step or reduction, click Reset to restore the reduction to the initial state, without resetting parameter values.
Files can be added to the reduction set (File -> Add Files) or removed from the reduction set (File -> Remove Files), but either action will reset the reduction for all loaded files. Select the File Information tab to display a table of information about the currently loaded files.
It is possible to set some custom values before Redux starts up.
The log level for the terminal and GUI log window may be set with the ‘-l’ command line option. To quiet all log output, specify ‘-l critical’; for fully verbose log messages, specify ‘-l debug’.
Other custom values may be specified in a configuration file in INI format on the command line. This file may contain:
a default output directory for the pipeline
a default name for an as-run input manifest
a default name for the output manifest
a default name for the as-run parameter file
a log file name template (may contain
time.strftime
formatting keys)the log level for the log file
the format for the log file
All file names may be changed from within the GUI.
In addition, configuration files may contain new default parameters for any pipeline step. These should be specified with the pipeline step name as a section header (with an optional step index number), then a keyword = value pair for the parameter to be modified. Any parameters not specified are left at their default values. All parameters will still be editable at runtime within the GUI. For a complete example of the pipeline parameters for a particular reduction type, use the GUI to display or save the parameters (Parameters -> Display All Parameters, or Parameters -> Save Parameters).
See also
sofia_redux.pipeline.sofia.redux_pipe
Batch mode processing
Examples
The following values, if placed in a configuration file (e.g. ‘custom.cfg’), would replicate the current default settings:
output_directory = . input_manifest = redux_infiles.txt output_manifest = outfiles.txt parameter_file = redux_param.cfg log_file = "redux_%Y%m%d_%H%M%S.log" log_level = DEBUG log_format = "%(asctime)s - %(origin)s - %(levelname)s - %(message)s"
The following additional section would set the initial ‘save’ parameter to True for the pipeline step named ‘calibrate’:
[calibrate] save = True
To run Redux with these settings:
redux -c custom.cfg
To run Redux with a verbose log:
redux -l debug
To run Redux with no terminal or log window output:
redux -l critical