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)