How to Download, View, And Edit Images from the James Webb Space Telescope with Jdaviz and Imviz


Like to comfortably view and edit images from the Jamew Webb Space Telescope like an astronomer ?

Then follow this step by step cheatsheet guides if you are using windows on a PC .

Main Software Components

There are three key software components required:

  • Microsoft C++ 14
  • Jupyter Notebook (Python)
  • Jdaviz

Additonal
  • MAST Token to be able to download the images with Imviz.

Prerequsites:

Microsoft Visual C++ 14.0 or greater
error: Microsoft Visual C++ 14.0 or greater is required

If Microsoft Visual C++ 14.0 or greater is not installed, the installation of Jdaviz will fail. Without Jdaviz the downloaded images from the James Webb Space Telescope cannot be edited.

How to install Microsoft Visual C++
  1. Navigate to: https://visualstudio.microsoft.com/downloads/
  2. Download Visual Studio 2022 Community version
  3. Follow the instructions in this post: Install C and C++ support in Visual Studio | Microsoft Docs
Cheatsheet: Install Visual Studio 2022
MAST Token
  1. Navigate to https://ssoportal.stsci.edu/token

If you do not have not an account yet, please follow below steps to create your account:

  1. Click on the Forgotten Password? link
  2. Enter your email Adress
  3. Click Send Reset Email Button
  4. Click Create Account Button
  5. Click Launch Button
  6. Enter the Captcha
  7. Click Submit Button
  8. Enter your email
  9. Click Next Button
  10. Fill in the Name Form
  11. Click Next Button
  12. Fill in the Insitution (e.g. Private Citizen or Citizen Scientist)
  13. Click Accept Institution Button
  14. Enter Job Title (whatever you are or like to be ;-))
  15. Click Next Button
  16. New Account Data for your review is presented, in case of missing contact data, step 17 might be necessary
  17. Fill in Contact Information Form
  18. Click Next Button
  19. Click Create Account Button
  20. In your email account open the reset password emal
  21. Click on the link
  22. Enter Password
  23. Enter Retype Password
  24. Click Update Password
  25. Navigate to https://ssoportal.stsci.edu/token
  26. Now log on with your email and new account password
  27. Click Create Token Button
  28. Fill in a Token Name of your choice
  29. Click Create Token Button
  30. Copy the Token Number and save it for later use in Imviz to download the images from the James Webb Space Telescope

Quite a lot of steps for a Token.

Cheatsheet: Create MAST Account
Cheatsheet: Set Passord for new Account
Cheatsheet: Create MAST Token for use in Imviz
Jupyter Notebook

Jupyter notebook comes with the ananconda distribution.

  1. Navigate to: https://www.anaconda.com/products/distribution#windows
  2. Follow the instructions at: https://docs.anaconda.com/anaconda/install/windows/

Install Jdaviz

  1. Navigate to: Installation — jdaviz v2.7.2.dev6+gd24f8239
  2. Open the Jupyter Notebook
  3. Open Terminal from Jupyter Notebook
  4. Follow the instruction in: Installation — jdaviz v2.7.2.dev6+gd24f8239
Cheatsheet: Install Jdaviz

How to use IMVIZ

Imviz is installed together with Jdaviz.

Following steps to take in order to use Imviz:

  1. Navigate to: GitHub – orifox/jwst_ero: JWST ERO Analysis Work
  2. Click Code Button
  3. Click Download Zip
  4. If you do not have unzip, then the next steps might work for you:
  5. In Download Folder (PC) click the jwst_ero master zip file
  6. Then click on the folder jwst_ero master
  7. Copy file MIRI_Imviz_demo.jpynb
  8. Paste the file in the download folder
  9. Open Jupyter notebook
  10. Click Upload Button
  11. Select the file MIRI_Imviz_demo.jpynb
  12. Click Open Button
  13. Select the file MIRI_Imviz_demo.jpynb in the Jupyter Notebook file list
  14. Click View Button
  15. Click Run Button First Cell
  16. Paste MAST Token in next cell
  17. Click Run Button of this Cell
  18. Click then Run Button of next Cell
  19. Click Run Button of the following Cell
  20. Click Run Button of the next Cell to download the images
  21. Copy the link to the downloaded image file
  22. Past link into the First Cell in 3. Load and Manipulate Data
  23. Do the same in the next Cell
  24. Click Run Button of the Cell to open Imviz
  25. Click Run Button on the next Cell to load images in Imviz
Cheatsheet: Upload MIRI_Imviz_demo.jpynb in Jupyter notebook

Now all set to download the images of the JWST observation:

Cheatsheet: Download JWST images with Imviz

And now all is set to open and edit the images in Imviz

Cheatsheet: Open Images in Imviz

And finally you are ready to follow the video tutorials in order to learn how to use Imviz to manipulate the JWST images.

Video Tutorials for Imviz:

And this is the master Ori Fox of the Imviz demo notebook file if you like to follow him on Twitter


Leave a comment