Chandra X-Ray Observatory
	(CXC)
Skip to the navigation links
Last modified: December 2013

URL: http://cxc.harvard.edu/sherpa/ahelp/restore.html
Jump to: Description · Examples · Bugs · See Also


AHELP for CIAO 4.9 Sherpa v1

restore

Context: saving

Synopsis

Restore a previous Sherpa session from a file

Syntax

restore([filename=sherpa.save])

Description

The restore command restores all information about a Sherpa session, including the data, from a save file ("ahelp save"). The file is platform-independent, allowing collaborators to send a Sherpa session to one another.

CAVEAT: Sherpa session files saved with older versions of Sherpa may not be properly restored in CIAO4.6. The warning messages will be printed during the Sherpa 4.6 session originating from the restored files.

        WARNING: Could not determine whether the model is discrete.
        This probably means that you have restored a session saved with a previous version of Sherpa.
        Falling back to assuming that the model is continuous.
        
  • filename - name, including path, of the save file; default is "sherpa.save" in the working directory

Currently the session is stored as a binary file, so it cannot be viewed or modified outside of Sherpa. To save the output as an ASCII file, use the "save_all" command.

Example 1

sherpa> restore()

The session is restored from the default file, sherpa.save.

Example 2

sherpa> restore("/data/m31/model2.shp")

The session is restored from the file /data/m31/model2.shp.

Example 3

Restore session from earlier versions of Sherpa
     sherpa-1> restore("sherpa4.5.save")
 
 Solar Abundance Vector set to angr: Anders E. G  Grevesse N. Geochimica et Cosmochimica Acta 53,197 (1989) 
 Cross Section Table set to bcmc: Balucinska-Church and McCammon, 1998
           
     sherpa-2> plot_fit() 
   
        WARNING: Could not determine whether the model is discrete.
        This probably means that you have restored a session saved with a previous version of Sherpa.  
        Falling back to assuming that the model is continuous.

        WARNING: Could not determine whether the model is discrete.
        This probably means that you have restored a session saved
        with a previous version of Sherpa.  Falling back to assuming
        that the model is continuous.  

Restoring a session saved with CIAO 4.5. The warning messages indicate that there might be issues when continuing the analysis from restored session file. We recommend not to use save session file but repeat the analysis using CIAO 4.6 before moving to the new analysis.

Bugs

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

See Also

contrib
save_chart_spectrum
modeling
save_model, save_source
saving
save, save_all, save_arrays, save_data, save_delchi, save_error, save_filter, save_grouping, save_image, save_pha, save_quality, save_resid, save_staterror, save_syserror, save_table, script

Last modified: December 2013
Smithsonian Institute Smithsonian Institute

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