decode.qlook module#
- auto(dems: Path, /, **options: Any) Path [source]#
Quick-look at an observation with auto-selected command.
The used command will be selected based on the observation name stored as the
observation
attribute in an input DEMS file.- Parameters:
dems (Path) – Input DEMS file (netCDF or Zarr).
**options (Any) – Options for the selected command. See the command help for all available options.
- Returns:
Absolute path of the saved file.
- Return type:
Path
- daisy(dems: Path, /, *, include_mkid_ids: Sequence[int] | None = None, exclude_mkid_ids: Sequence[int] | None = None, min_frequency: str | None = None, max_frequency: str | None = None, data_type: Literal['auto', 'brightness', 'df/f'] = 'auto', rolling_time: int = 200, source_radius: str = '60 arcsec', chan_weight: Literal['uniform', 'std', 'std/tx'] = 'std/tx', pwv: Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0'] = '5.0', skycoord_grid: str = '6 arcsec', skycoord_units: str = 'arcsec', format: str = 'png', outdir: Path = PosixPath('.'), overwrite: bool = False, suffix: str = 'daisy', debug: bool = False, **options: Any) Path [source]#
Quick-look at a daisy scan observation.
- Parameters:
dems (Path) – Input DEMS file (netCDF or Zarr).
include_mkid_ids (Sequence[int] | None) – MKID IDs to be included in analysis. Defaults to all MKID IDs.
exclude_mkid_ids (Sequence[int] | None) – MKID IDs to be excluded in analysis. Defaults to no MKID IDs.
min_frequency (str | None) – Minimum frequency to be included in analysis. Defaults to no minimum frequency bound.
max_frequency (str | None) – Maximum frequency to be included in analysis. Defaults to no maximum frequency bound.
data_type (Literal['auto', 'brightness', 'df/f']) – Data type of the input DEMS file. Defaults to the
long_name
attribute in it.rolling_time (int) – Moving window size.
source_radius (str) – Radius of the on-source area. Other areas are considered off-source in sky subtraction.
chan_weight (Literal['uniform', 'std', 'std/tx']) – Weighting method along the channel axis. uniform: Uniform weight (i.e. no channel dependence). std: Inverse square of temporal standard deviation of sky. std/tx: Same as std but std is divided by the atmospheric transmission calculated by the ATM model.
pwv (Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0']) – PWV in units of mm. Only used for the calculation of the atmospheric transmission when chan_weight is std/tx.
skycoord_grid (str) – Grid size of the sky coordinate axes.
skycoord_units (str) – Units of the sky coordinate axes.
format (str) – Output image format of quick-look result.
outdir (Path) – Output directory for the quick-look result.
overwrite (bool) – Whether to overwrite the output if it exists.
suffix (str) – Suffix that precedes the file extension.
debug (bool) – Whether to print detailed logs for debugging.
**options (Any) – Other options for saving the output (e.g. dpi).
- Returns:
Absolute path of the saved file.
- Return type:
Path
- pswsc(dems: Path, /, *, include_mkid_ids: Sequence[int] | None = None, exclude_mkid_ids: Sequence[int] | None = None, min_frequency: str | None = None, max_frequency: str | None = None, data_type: Literal['auto', 'brightness', 'df/f'] = 'auto', frequency_units: str = 'GHz', format: str = 'png', outdir: Path = PosixPath('.'), overwrite: bool = False, suffix: str = 'pswsc', debug: bool = False, **options: Any) Path [source]#
Quick-look at a PSW observation with sky chopper.
- Parameters:
dems (Path) – Input DEMS file (netCDF or Zarr).
include_mkid_ids (Sequence[int] | None) – MKID IDs to be included in analysis. Defaults to all MKID IDs.
exclude_mkid_ids (Sequence[int] | None) – MKID IDs to be excluded in analysis. Defaults to no MKID IDs.
min_frequency (str | None) – Minimum frequency to be included in analysis. Defaults to no minimum frequency bound.
max_frequency (str | None) – Maximum frequency to be included in analysis. Defaults to no maximum frequency bound.
data_type (Literal['auto', 'brightness', 'df/f']) – Data type of the input DEMS file. Defaults to the
long_name
attribute in it.frequency_units (str) – Units of the frequency axis.
format (str) – Output data format of the quick-look result.
outdir (Path) – Output directory for the quick-look result.
overwrite (bool) – Whether to overwrite the output if it exists.
suffix (str) – Suffix that precedes the file extension.
debug (bool) – Whether to print detailed logs for debugging.
**options (Any) – Other options for saving the output (e.g. dpi).
- Returns:
Absolute path of the saved file.
- Return type:
Path
- raster(dems: Path, /, *, include_mkid_ids: Sequence[int] | None = None, exclude_mkid_ids: Sequence[int] | None = None, min_frequency: str | None = None, max_frequency: str | None = None, data_type: Literal['auto', 'brightness', 'df/f'] = 'auto', chan_weight: Literal['uniform', 'std', 'std/tx'] = 'std/tx', pwv: Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0'] = '5.0', skycoord_grid: str = '6 arcsec', skycoord_units: str = 'arcsec', format: str = 'png', outdir: Path = PosixPath('.'), overwrite: bool = False, suffix: str = 'raster', debug: bool = False, **options: Any) Path [source]#
Quick-look at a raster scan observation.
- Parameters:
dems (Path) – Input DEMS file (netCDF or Zarr).
include_mkid_ids (Sequence[int] | None) – MKID IDs to be included in analysis. Defaults to all MKID IDs.
exclude_mkid_ids (Sequence[int] | None) – MKID IDs to be excluded in analysis. Defaults to no MKID IDs.
min_frequency (str | None) – Minimum frequency to be included in analysis. Defaults to no minimum frequency bound.
max_frequency (str | None) – Maximum frequency to be included in analysis. Defaults to no maximum frequency bound.
data_type (Literal['auto', 'brightness', 'df/f']) – Data type of the input DEMS file. Defaults to the
long_name
attribute in it.chan_weight (Literal['uniform', 'std', 'std/tx']) – Weighting method along the channel axis. uniform: Uniform weight (i.e. no channel dependence). std: Inverse square of temporal standard deviation of sky. std/tx: Same as std but std is divided by the atmospheric transmission calculated by the ATM model.
pwv (Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0']) – PWV in units of mm. Only used for the calculation of the atmospheric transmission when chan_weight is std/tx.
skycoord_grid (str) – Grid size of the sky coordinate axes.
skycoord_units (str) – Units of the sky coordinate axes.
format (str) – Output image format of quick-look result.
outdir (Path) – Output directory for the quick-look result.
overwrite (bool) – Whether to overwrite the output if it exists.
suffix (str) – Suffix that precedes the file extension.
debug (bool) – Whether to print detailed logs for debugging.
**options (Any) – Other options for saving the output (e.g. dpi).
- Returns:
Absolute path of the saved file.
- Return type:
Path
- skydip(dems: Path, /, *, include_mkid_ids: Sequence[int] | None = None, exclude_mkid_ids: Sequence[int] | None = None, min_frequency: str | None = None, max_frequency: str | None = None, data_type: Literal['auto', 'brightness', 'df/f'] = 'auto', chan_weight: Literal['uniform', 'std', 'std/tx'] = 'std/tx', pwv: Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0'] = '5.0', format: str = 'png', outdir: Path = PosixPath('.'), overwrite: bool = False, suffix: str = 'skydip', debug: bool = False, **options: Any) Path [source]#
Quick-look at a skydip observation.
- Parameters:
dems (Path) – Input DEMS file (netCDF or Zarr).
include_mkid_ids (Sequence[int] | None) – MKID IDs to be included in analysis. Defaults to all MKID IDs.
exclude_mkid_ids (Sequence[int] | None) – MKID IDs to be excluded in analysis. Defaults to no MKID IDs.
min_frequency (str | None) – Minimum frequency to be included in analysis. Defaults to no minimum frequency bound.
max_frequency (str | None) – Maximum frequency to be included in analysis. Defaults to no maximum frequency bound.
data_type (Literal['auto', 'brightness', 'df/f']) – Data type of the input DEMS file. Defaults to the
long_name
attribute in it.chan_weight (Literal['uniform', 'std', 'std/tx']) – Weighting method along the channel axis. uniform: Uniform weight (i.e. no channel dependence). std: Inverse square of temporal standard deviation of sky. std/tx: Same as std but std is divided by the atmospheric transmission calculated by the ATM model.
pwv (Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0']) – PWV in units of mm. Only used for the calculation of the atmospheric transmission when chan_weight is std/tx.
format (str) – Output image format of quick-look result.
outdir (Path) – Output directory for the quick-look result.
overwrite (bool) – Whether to overwrite the output if it exists.
suffix (str) – Suffix that precedes the file extension.
debug (bool) – Whether to print detailed logs for debugging.
**options (Any) – Other options for saving the output (e.g. dpi).
- Returns:
Absolute path of the saved file.
- Return type:
Path
- still(dems: Path, /, *, include_mkid_ids: Sequence[int] | None = None, exclude_mkid_ids: Sequence[int] | None = None, min_frequency: str | None = None, max_frequency: str | None = None, data_type: Literal['auto', 'brightness', 'df/f'] = 'auto', chan_weight: Literal['uniform', 'std', 'std/tx'] = 'std/tx', pwv: Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0'] = '5.0', format: str = 'png', outdir: Path = PosixPath('.'), overwrite: bool = False, suffix: str = 'still', debug: bool = False, **options: Any) Path [source]#
Quick-look at a still observation.
- Parameters:
dems (Path) – Input DEMS file (netCDF or Zarr).
include_mkid_ids (Sequence[int] | None) – MKID IDs to be included in analysis. Defaults to all MKID IDs.
exclude_mkid_ids (Sequence[int] | None) – MKID IDs to be excluded in analysis. Defaults to no MKID IDs.
min_frequency (str | None) – Minimum frequency to be included in analysis. Defaults to no minimum frequency bound.
max_frequency (str | None) – Maximum frequency to be included in analysis. Defaults to no maximum frequency bound.
data_type (Literal['auto', 'brightness', 'df/f']) – Data type of the input DEMS file. Defaults to the
long_name
attribute in it.chan_weight (Literal['uniform', 'std', 'std/tx']) – Weighting method along the channel axis. uniform: Uniform weight (i.e. no channel dependence). std: Inverse square of temporal standard deviation of sky. std/tx: Same as std but std is divided by the atmospheric transmission calculated by the ATM model.
pwv (Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0']) – PWV in units of mm. Only used for the calculation of the atmospheric transmission when chan_weight is std/tx.
format (str) – Output data format of the quick-look result.
outdir (Path) – Output directory for the quick-look result.
overwrite (bool) – Whether to overwrite the output if it exists.
suffix (str) – Suffix that precedes the file extension.
debug (bool) – Whether to print detailed logs for debugging.
**options (Any) – Other options for saving the output (e.g. dpi).
- Returns:
Absolute path of the saved file.
- Return type:
Path
- xscan(dems: Path, /, *, include_mkid_ids: Sequence[int] | None = None, exclude_mkid_ids: Sequence[int] | None = None, min_frequency: str | None = None, max_frequency: str | None = None, data_type: Literal['auto', 'brightness', 'df/f'] = 'auto', chan_weight: Literal['uniform', 'std', 'std/tx'] = 'std/tx', pwv: Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0'] = '5.0', format: str = 'png', outdir: Path = PosixPath('.'), overwrite: bool = False, suffix: str = 'zscan', debug: bool = False, **options: Any) Path [source]#
Quick-look at an observation of subref X-axis focus scan.
- Parameters:
dems (Path) – Input DEMS file (netCDF or Zarr).
include_mkid_ids (Sequence[int] | None) – MKID IDs to be included in analysis. Defaults to all MKID IDs.
exclude_mkid_ids (Sequence[int] | None) – MKID IDs to be excluded in analysis. Defaults to no MKID IDs.
min_frequency (str | None) – Minimum frequency to be included in analysis. Defaults to no minimum frequency bound.
max_frequency (str | None) – Maximum frequency to be included in analysis. Defaults to no maximum frequency bound.
data_type (Literal['auto', 'brightness', 'df/f']) – Data type of the input DEMS file. Defaults to the
long_name
attribute in it.chan_weight (Literal['uniform', 'std', 'std/tx']) – Weighting method along the channel axis. uniform: Uniform weight (i.e. no channel dependence). std: Inverse square of temporal standard deviation of sky. std/tx: Same as std but std is divided by the atmospheric transmission calculated by the ATM model.
pwv (Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0']) – PWV in units of mm. Only used for the calculation of the atmospheric transmission when chan_weight is std/tx.
format (str) – Output image format of quick-look result.
outdir (Path) – Output directory for the quick-look result.
overwrite (bool) – Whether to overwrite the output if it exists.
suffix (str) – Suffix that precedes the file extension.
debug (bool) – Whether to print detailed logs for debugging.
**options (Any) – Other options for saving the output (e.g. dpi).
- Returns:
Absolute path of the saved file.
- Return type:
Path
- yscan(dems: Path, /, *, include_mkid_ids: Sequence[int] | None = None, exclude_mkid_ids: Sequence[int] | None = None, min_frequency: str | None = None, max_frequency: str | None = None, data_type: Literal['auto', 'brightness', 'df/f'] = 'auto', chan_weight: Literal['uniform', 'std', 'std/tx'] = 'std/tx', pwv: Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0'] = '5.0', format: str = 'png', outdir: Path = PosixPath('.'), overwrite: bool = False, suffix: str = 'zscan', debug: bool = False, **options: Any) Path [source]#
Quick-look at an observation of subref Y-axis focus scan.
- Parameters:
dems (Path) – Input DEMS file (netCDF or Zarr).
include_mkid_ids (Sequence[int] | None) – MKID IDs to be included in analysis. Defaults to all MKID IDs.
exclude_mkid_ids (Sequence[int] | None) – MKID IDs to be excluded in analysis. Defaults to no MKID IDs.
min_frequency (str | None) – Minimum frequency to be included in analysis. Defaults to no minimum frequency bound.
max_frequency (str | None) – Maximum frequency to be included in analysis. Defaults to no maximum frequency bound.
data_type (Literal['auto', 'brightness', 'df/f']) – Data type of the input DEMS file. Defaults to the
long_name
attribute in it.chan_weight (Literal['uniform', 'std', 'std/tx']) – Weighting method along the channel axis. uniform: Uniform weight (i.e. no channel dependence). std: Inverse square of temporal standard deviation of sky. std/tx: Same as std but std is divided by the atmospheric transmission calculated by the ATM model.
pwv (Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0']) – PWV in units of mm. Only used for the calculation of the atmospheric transmission when chan_weight is std/tx.
format (str) – Output image format of quick-look result.
outdir (Path) – Output directory for the quick-look result.
overwrite (bool) – Whether to overwrite the output if it exists.
suffix (str) – Suffix that precedes the file extension.
debug (bool) – Whether to print detailed logs for debugging.
**options (Any) – Other options for saving the output (e.g. dpi).
- Returns:
Absolute path of the saved file.
- Return type:
Path
- zscan(dems: Path, /, *, include_mkid_ids: Sequence[int] | None = None, exclude_mkid_ids: Sequence[int] | None = None, min_frequency: str | None = None, max_frequency: str | None = None, data_type: Literal['auto', 'brightness', 'df/f'] = 'auto', chan_weight: Literal['uniform', 'std', 'std/tx'] = 'std/tx', pwv: Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0'] = '5.0', format: str = 'png', outdir: Path = PosixPath('.'), overwrite: bool = False, suffix: str = 'zscan', debug: bool = False, **options: Any) Path [source]#
Quick-look at an observation of subref Z-axis focus scan.
- Parameters:
dems (Path) – Input DEMS file (netCDF or Zarr).
include_mkid_ids (Sequence[int] | None) – MKID IDs to be included in analysis. Defaults to all MKID IDs.
exclude_mkid_ids (Sequence[int] | None) – MKID IDs to be excluded in analysis. Defaults to no MKID IDs.
min_frequency (str | None) – Minimum frequency to be included in analysis. Defaults to no minimum frequency bound.
max_frequency (str | None) – Maximum frequency to be included in analysis. Defaults to no maximum frequency bound.
data_type (Literal['auto', 'brightness', 'df/f']) – Data type of the input DEMS file. Defaults to the
long_name
attribute in it.chan_weight (Literal['uniform', 'std', 'std/tx']) – Weighting method along the channel axis. uniform: Uniform weight (i.e. no channel dependence). std: Inverse square of temporal standard deviation of sky. std/tx: Same as std but std is divided by the atmospheric transmission calculated by the ATM model.
pwv (Literal['0.5', '1.0', '2.0', '3.0', '4.0', '5.0']) – PWV in units of mm. Only used for the calculation of the atmospheric transmission when chan_weight is std/tx.
format (str) – Output image format of quick-look result.
outdir (Path) – Output directory for the quick-look result.
overwrite (bool) – Whether to overwrite the output if it exists.
suffix (str) – Suffix that precedes the file extension.
debug (bool) – Whether to print detailed logs for debugging.
**options (Any) – Other options for saving the output (e.g. dpi).
- Returns:
Absolute path of the saved file.
- Return type:
Path