)               (      (     
				 ( /(               )\ )   )\ )  
				 )\())  (     (    (()/(  (()/(  
				((_)\   )\    )\    /(_))  /(_)) 
				 _((_) ((_)  ((_)  (_))   (_))   
				| || | | __| | __| | _ \  / __|  
				| __ | | _|  | _|  |  _/  \__ \  
				|_||_| |___| |___| |_|    |___/    

HEEPS is a high-contrast imaging (HCI) simulator, mostly geared towards studying the HCI performance of ELT instrument; "METIS".

Currently simulator includes three coronagraphs:

• Classical vortex
• Ring apodized vortex coronagraph (RAVC)
• Apodizing phase plate (APP)

For technical document about the simulator see SPIE paper by Brunella et al: link

1. Python 3.6 is required to run HEEPS package, if not already installed, we recommend downloading and installing Anaconda package for Python 3.6, see link.
2. The 'PROPER' library can be downloaded from link. (i) After downloading the "proper_v3.0d1_python_3.x_30jul18.zip" file, extract it. (ii) Go to the directory and execute "python setup.py install" in a terminal
3. The 'VIP' library for ADI processing and generating contrast curves can be installed by executing "pip install vip_hci" in a terminal. Please see the GitHub page for more details about the package.

1. Download all the HEEPS file as a zip and extract it.
2. A default simulation parameters are described in a file called "read_config.py". These parameters can be modified/overwritten in a script.
3. See files "example_coronagraph_psf.py" and "ADI_processing.py" to get familiar with the module
4. See "manual.pdf" for more details about the architecture of the HEEPS package and its various sub-modules.