EHT-Imaging Pipeline Guide

Introduction

The EHT-Imaging pipeline is one of three pipelines (along with SMILI and DIFMAP) used to produce the M87* Black Hole images released by the Event Horizon Telescope Collaboration (EHTC). This project aims to provide findings about the reproducibility process of reconstructing an image of a black hole using the EHT-Imaging workflow.

This EHT-Imaging repository contains the original pipline script developed by the EHTC as well as scripts that we have developed in our efforts to fully reproduce the EHTC released black hole images. We also provide detailed instructions for installing all necessary dependencies and for running the pipeline on your local machine, as well as a Jupyter Notebook detailing the pipeline's execution and image creation process.

Summary of Contents

• Jupyter Notebook showing detailed pipeline execution and post-processing steps that we have taken
• Python scripts of original pipeline and our image post-processing
• Dockerfile to create a base image. We also provide access to pull a fully-functional Docker image from our Dockerhub.
• Documentation for environment setup to run pipeline, running the pipeline and post-processing, and using the provided Jupyter notebook.

Documentation

• Setting up the Environment
• Executing EHT-Imaging Pipeline
• Running Jupyter Notebook
• Set Up Docker Container

Information from the Event Horizon Telescope Collaboration

Authors: The Event Horizon Telescope Collaboration et al.

Date: April 10, 2019

Primary Reference: The Event Horizon Telescope Collaboration, et al. 2019d, ApJL, 875, L4 (M87 Paper IV)

Data Product Code: 2019-D01-02

Additional References:

• EHT Collaboration Data Portal Website
• The Event Horizon Telescope Collaboration, et al. 2019a, ApJL, 875, L1 (M87 Paper I)
• The Event Horizon Telescope Collaboration, et al. 2019b, ApJL, 875, L2 (M87 Paper II)
• The Event Horizon Telescope Collaboration, et al. 2019c, ApJL, 875, L3 (M87 Paper III)
• The Event Horizon Telescope Collaboration, et al. 2019d, ApJL, 875, L4 (M87 Paper IV)
• The Event Horizon Telescope Collaboration, et al. 2019e, ApJL, 875, L5 (M87 Paper V)
• The Event Horizon Telescope Collaboration, et al. 2019f, ApJL, 875, L6 (M87 Paper VI)
• Chael, A., Johnson, M., Narayan, R. et al. 2016, ApJ, 829, 11C
• Chael, A., Johnson, M., Bouman, K. et al. 2018, ApJ, 857, 23C
• Chael, A., Bouman, K., Johnson, M. et al., Zenodo (eht-imaging version 1.1.0)
• eht-imaging: https://github.com/achael/eht-imaging