About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: December 2008

URL: http://cxc.harvard.edu/sherpa4.1/show_all.sl.html
AHELP for Sherpa 4.1

show_all

Context: sl.sherpa

Synopsis

Reports the current state of the Sherpa session

Syntax

show_all(; [id, outfile=NULL, clobber=0]);

Description

The show_all() command returns information about the current Sherpa session. This includes data and response files that have been loaded, the current statistic and optimization method, and models that have been defined. The current parameter values for the models are included, as well as information on the most recent fit. Model values and fit statistics are updated each time a new fit is run.

  • id - the id of the dataset to use; default is to show information for all available datasets.
  • outfile - name of the file in which to store the information
  • clobber - a Boolean switch which indicates whether or not the 'outfile' should be overwritten, if the file already exists; default=0

The behavior of the screen output is determined by the user's $PAGER environment variable setting, which is usually a variant of "more." To disable paging within show_all() - i.e. print the entire contents, even if it scrolls offscreen - change this setting to "cat" before starting Sherpa:

unix% setenv PAGER cat

unix% sherpa

Example 1

sherpa> show_all();

Print the current state of the Sherpa session. This session has spectral data with ARF and RMF loaded. The model parameter values reflect the most recent fit.

Filter: 0.0080-14.9431 Energy (keV)
Noticed Channels: 1-1024
name           = source_pi.fits
channel        = Int32[1024]
counts         = Int32[1024]
staterror      = None
syserror       = None
bin_lo         = None
bin_hi         = None
grouping       = None
quality        = None
exposure       = 7854.46647487
backscal       = 0.000205020165089
areascal       = 1.0
grouped        = False
subtracted     = False
units          = energy
response_ids   = [1]
background_ids = []

RMF Data Set: 1:1
name     = rmf.fits
detchans = 1024
energ_lo = Float64[1078]
energ_hi = Float64[1078]
n_grp    = Int16[1078]
f_chan   = UInt32[1483]
n_chan   = UInt32[1483]
matrix   = Float64[436308]
offset   = 1
e_min    = Float64[1024]
e_max    = Float64[1024]

ARF Data Set: 1:1
name     = arf.fits
energ_lo = Float64[1078]
energ_hi = Float64[1078]
specresp = Float64[1078]
bin_lo   = None
bin_hi   = None
exposure = 7854.46650022

Model: 1
apply_rmf(apply_arf((7854.46647487 * (powlaw1d.p1 * xswabs.abs1))))
   Param        Type          Value          Min          Max      Units
   -----        ----          -----          ---          ---      -----
   p1.gamma     thawed      1.85316          -10           10           
   p1.ref       frozen            1     -3.4e+38      3.4e+38           
   p1.ampl      thawed    0.0174513            0      3.4e+38           
   abs1.nh      thawed      2.35815            0        1e+05 10^22 atoms / cm^2

Optimization Method: LevMar
name    = levmar
ftol    = 1.19209289551e-07
xtol    = 1.19209289551e-07
gtol    = 1.19209289551e-07
maxfev  = None
epsfcn  = 1.19209289551e-07
factor  = 100.0
verbose = 0

Statistic: Chi2Gehrels

Fit: 1
LevMar:
Initial fit statistic = 8.27486e+08
Final fit statistic   = 496.196 at function evaluation 29
Data points           = 1024
Degrees of freedom    = 1021
Probability [Q-value] = 1
Reduced statistic     = 0.48599
Change in statistic   = 8.27485e+08
   p1.gamma       1.85316     
   p1.ampl        0.0174513   
   abs1.nh        2.35815     

Example 2

sherpa> show_all(2, "sherpa.all", 1);

Write the information for dataset id=2 to the file "sherpa.all", clobbering any existing file with the same name.

Bugs

See the bugs pages on the Sherpa website for an up-to-date listing of known bugs.

Last modified: December 2008



The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory.
60 Garden Street, Cambridge, MA 02138 USA.    Email: cxcweb@head.cfa.harvard.edu
Smithsonian Institution, Copyright © 1998-2004. All rights reserved.