Download and installation

The latest version (1.8) can be downloaded from PyPI – the Python Package index. It can also be installed online using pip with this command:

 pip  install psls

This command only installs the program but you  will need to download the PSLS package from here. This package includes the source code, some examples of configuration files, and the binary files containing the parameters of the model mimicking the systematic errors.

PSLS requires (among other) the following python packages: numpy, scipy, matplotlib, and yaml.
As an alternative to the online installation with pip, the code can be installed manually in your home directory with the following command:

 python setup.py install --home=$HOME/

It is also possible to install the code for all the users:

 sudo python setup.py install

Edit the configuration file, an example is given in psls.yaml. Then, execute PSLS:

psls.py -P -V psls.yaml

The package provides various files storing the parameters describing the PLATO systematic errors:

  • PLATO_systematics_[BOL/EOL]_V2.npy: Begining Of Life (BOL) and End Of Life (EOL) systematic errors for the P5 sample (aperture mask photometry with mask updates operating) ;
  • PLATO_systematics_[EOL/BOL]_FixedMask_V2.npy: fixed aperture mask  photometry ;
  •  PLATO_systematics_[EOL/BOL]_P1_V2.npy: systematic errors representative for the P1 sample (based on the PSF fitting method)

Older systematic errors tables (version 0) are given for compatibility and consistency with Samadi et al (2019)’s results.

To simulate solar-like oscillations  representative for a dwarf star  you will need to provide as input  a set of theoretical frequencies (the .gsm files)  generated with ADIPLS.

The package provides two working examples:

  • a main sequence star (0012069449.yaml) with its associated theoretical frequencies (0012069449.gsm) generated with the ADIPLS pulsation code. The 0012069449.gsm file is stored in the sub-directory models  ;
  • a red giant star (0009882316.yaml), which does not require as input theoretical frequencies.

To simulate other main sequence stars you can  use a grid of CESAM2K stellar models (HDF file), which you can obtain on demand by contacting Reza SAMADI.

Note that, for RGB and clump stars, the program relies on the Universal Pattern, accordingly sets of theoretical frequencies are not required for those stars.


This simulator is not an official product of the Plato Mission Consortium (PMC).If you want to simulate the representative PLATO data at pixel level, please consider PLATOSim.  http://ivs-kuleuven.github.io/PlatoSim3/

PSLS  is distributed under the terms of the GNU General Public License  in the hope that it will be useful, but WITHOUT ANY WARRANTY.

(c) 2017 by Réza SAMADI, LESIA – Observatoire de Paris.

Main contributors: Alexi Deru (LESIA), Emmanuel Grolleau (LESIA), Daniel Reese (LESIA)

Comments are closed.