| AHELP for CIAO 4.5 Sherpa v1 | list_model_ids |
Context: info |
Synopsis
List all current model IDs.
Syntax
list_model_ids()
Description
Sherpa allows users to construct arbitrarily complex models from model components (e.g., Gaussians, Lorentzians, XSPEC models, etc.). These model expressions can then be assigned to Sherpa data sets, so that the models can be fit to the data. This function lists the IDs of all current, active models in a Sherpa session, i.e., all models which have been assigned to a data set to be fit. A model ID is the same as the ID of the data set to which it has been assigned, though the user has the option to assign an alternate model ID to a given model with the set_model command. However, in this case, the list_model_ids() function will return both the user-defined model ID *and* the ID of the data set to which that model has been assigned. The list_model_ids() function accepts no input arguments.
Example
sherpa> list_model_ids()
The list_model_ids() function lists the model IDs of all active models in a Sherpa session. A model ID is the same as the ID of the data set to which it has been assigned. If a user assigns an alternate ID to a model, such as "bkg_model", both the user-defined model ID *and* the ID of the associated data set will be returned by list_model_ids(). (In this example, the set_model function is used to assign models to four data sets, as well as to assign a string model ID to a model expression.)
sherpa> set_model(1, xsphabs.abs1)
sherpa> set_model(2, xspowerlaw.p1)
sherpa> set_model(3, abs1*p1)
sherpa> set_model("src", gauss1d.g1)
sherpa> set_model(4, get_model("src"))
sherpa> list_model_ids()
[1, 2, 3, 4, 'src']
Bugs
See the bugs pages on the Sherpa website for an up-to-date listing of known bugs.
See Also
- data
- get_bkg_plot
- info
- show_bkg_model, show_bkg_source
- modeling
- add_model, add_user_pars, clean, create_model_component, delete_bkg_model, delete_model, delete_model_component, get_model, get_model_autoassign_func, get_model_component, get_model_component_image, get_model_component_plot, get_model_plot, get_num_par, get_order_plot, get_par, get_pileup_model, get_source, get_source_component_image, get_source_component_plot, image_model, image_model_component, image_source, image_source_component, integrate, integrate1d, link, load_table_model, load_template_model, load_user_model, normal_sample, reset, save_model, save_source, set_bkg_model, set_full_model, set_model_autoassign_func, set_pileup_model, set_source, set_xsabund, set_xscosmo, set_xsxsect, set_xsxset, t_sample, uniform_sample
- plotting
- get_lrt_plot, get_lrt_results, get_pvalue_plot, get_pvalue_results, plot_cdf, plot_lrt, plot_model, plot_model_component, plot_pdf, plot_pvalue, plot_scatter, plot_source, plot_source_component, plot_trace
- psfs
- delete_psf, load_conv
- saving
- save_delchi, save_resid
- utilities
- calc_chisqr, calc_energy_flux, calc_model_sum, calc_photon_flux, calc_source_sum, calc_stat, eqwidth
- visualization
- contour_model, contour_ratio, contour_resid, get_ratio, get_resid

![[Sherpa Logo]](../imgs/sherpa_logo_navbar.gif)