Synopsis
Set the coordinate system to use for image analysis.
Syntax
set_coord(id, coord=None) id - int or str coord - { 'logical', 'image', 'physical', 'world', 'wcs' }
Description
The default coordinate system - that is, the mapping between pixel position and coordinate value, for images (2D data sets) is 'logical'. This function can change this setting, so that model parameters can be fit using other systems. This setting is also used by the `notice2d` and `ignore2d` series of commands.
Examples
Example 1
Change the coordinate system of the default data set to the world system ('wcs' is a synonym for 'world').
>>> set_coord('wcs')
Example 2
Change the data set with the id of 'm82' to use the physical coordinate system.
>>> set_coord('m82', 'physical')
PARAMETERS
The parameters for this function are:
Parameter | Definition |
---|---|
id | The data set to change. If not given then the default identifier is used, as returned by `get_default_id` . |
coord | The coordinate system to use. The 'image' option is the same as 'logical', and 'wcs' the same as 'world'. |
Notes
The function does not follow the normal Python standards for parameter use, since it is designed for easy interactive use. When called with a single un-named argument, it is taken to be the `coord` parameter. If given two un-named arguments, then they are interpreted as the `id` and `coord` parameters, respectively.
Any limits or values already set for model parameters, such as those made by `guess` , may need to be changed after changing the coordinate system.
The 'logical' system is one in which the center of the lower-left pixel has coordinates (1, 1) and the center of the top-right pixel has coordinates (nx, ny) , for a nx (columns) by ny (rows) pixel image. The pixels have a side of length 1, so the first pixel covers the range x=0.5 to x=1.5 and y=0.5 to y=1.5 .
The 'physical' and 'world' coordinate systems rely on FITS World Coordinate System (WCS) standard. The 'physical' system refers to a linear transformation, with possible offset, of the 'logical' system. The 'world' system refers to the mapping to a celestial coordinate system.
Changes in CIAO
Changed in CIAO 4.15
The filter created by `notice2d` and `ignore1d` is now cleared when the coordinate system is changed.
Bugs
See the bugs pages on the Sherpa website for an up-to-date listing of known bugs.
See Also
- confidence
- set_conf_opt, set_covar_opt, set_proj_opt
- data
- get_coord, set_areascal, set_arf, set_backscal, set_bkg, set_counts, set_data, set_dep, set_exposure, set_grouping, set_quality, set_rmf, set_staterror, set_syserror
- filtering
- ignore2d, notice2d, set_filter
- methods
- set_iter_method, set_iter_method_opt, set_method, set_method_opt
- modeling
- get_par, get_xsabund, get_xscosmo, get_xsxsect, get_xsxset, set_bkg_model, set_bkg_source, set_full_model, set_model, set_par, set_pileup_model, set_source, set_xsabund, set_xscosmo, set_xsxsect, set_xsxset
- statistics
- set_prior, set_sampler, set_sampler_opt, set_stat
- utilities
- set_analysis, set_default_id
- visualization
- image_setregion