save

sherpa.astro.ui.save(filename='sherpa.save', clobber=False)

Save the current Sherpa session to a file.

Parameters

  • filename (str, optional) – The name of the file to write the results to. The default is ‘sherpa.save’.

  • clobber (bool, optional) – This flag controls whether an existing file can be overwritten (True) or if it raises an exception (False, the default setting).

Raises

sherpa.utils.err.IOErr – If filename already exists and clobber is False.

See also

clean

Clear all stored session data.

restore

Load in a Sherpa session from a file.

save_all

Save the Sherpa session as an ASCII file.

Notes

The current Sherpa session is saved using the Python pickle module. The output is a binary file, which may not be portable between versions of Sherpa, but is platform independent, and contains all the data. This means that files created by save can be sent to collaborators to share results.

Examples

Save the current session to the file ‘sherpa.save’.

>>> save()

Save the current session to the file ‘bestfit.sherpa’, overwriting any existing version of the file.

>>> save('bestfit.sherpa', clobber=True)