Creation of an ImageJ Macro to Create Pretty Images from JunoCam Gallery

High-Level Project Summary

A macro was created that runs in FIJI and allows the user to process raw JunoCam images. The Macro performs the following operations on the JunoCam images: 1) converts image to 16-bit greyscale, 2) duplicates image, 3) duplicate image is blurred using Gaussian filter, 4) the blurred image is subtracted from original, 5) a fire lookup table (LUT) is applied, 6) the brightness and contrast is adjusted, and 7) the view is magnified 2xfold to see detail. The final image is an artistic rendering of the original and enhances details of the swirling cyclones on Jupiter. This macro creates artistic images, using a Gaussian blur subtraction technique, for the general public to appreciate Jupiter.

Detailed Project Description

Chapter 1

Purpose of SDJRIP ImageJ Macro?

The SD Jovian Raw Image Processor (SDJRIP) ImageJ macro was created in response to the NASA Space International Apps Challenge 2022 competition. The “Visualizing Jovian System Like Never Before” problem tasked competitors with creating an open-source image editing program that uses innovative methods to process raw JunoCam raw images for scientific, artistic, or other fun purposes. The authors chose to tackle the problem by using the freeware program ImageJ and specifically the “batteries included” version of ImageJ called FIJI (Its just ImageJ).

A macro was created that runs in FIJI and allows the user to process raw JunoCam images. The Macro performs the following operations on the JunoCam images: 1) converts image to 16-bit greyscale, 2) duplicates image, 3) duplicate image is blurred using Gaussian filter, 4) the blurred image is subtracted from original, 5) a fire lookup table (LUT) is applied, 6) the brightness and contrast is adjusted, and 7) the view is magnified 2xfold to see detail. The final image is an artistic rendering of the original and enhances details of the swirling clouds of Jupiter, due to loss pass effect of Gaussian filter, with loss of some information and blurring of the image. The loss of information and slight blurring is okay given the purpose of the macro is to create “pretty artistic” pictures. The macro can be used on the raw framelets, RGB image, or individual RGB channels. Future planned features for the macro are discussed in Chapter 5. 


Chapter 2

How to install Fiji [its just imageJ]?

First, install FIJI if not already running on your computer. The FIJI program can be downloaded from the following site https://imagej.net/software/fiji/. The FIJI software can be run on Windows, MacOS, and Linux computer systems (32 or 64-bit). Download and install the appropriate version for your computer system. The files will be downloaded as a zipped folder. Extract the folder (Fiji.app) containing the software files, open folder, and start the program by double-clicking on the ImageJ application file. All files needed to run the program are contained in this downloaded folder.


Chapter 3

How to install SDJRIP Macro in FIJI?

Download the SD Jovian Raw Image Processor (SDJRIP) ijm file to your computer (https://github.com/ryouker/SDJRIP-Macro/blob/main/README.md). Open FIJI and navigate to plugins > install plugins (Crtl + Shift + M). Select location of the SDJRIP.ijm and press open button on window. Restart the FIJI program and the SDJRIP macro should be visible in the plugins > utilities menu. Please make sure you have permission to save to the plugins > utilities menu for your computer. Sometimes you need administrator permission to make changes to certain folders on windows computers. Can also run macro by selecting plugins > macros > run and selecting the SDJRIP.ijm file. 


Chapter 4

Generate “Super Cool Jovian Image”

To generate a “super cool Jovian image”, download an image from NASA’s https://www.missionjuno.swri.edu/junocam/processing, open FIJI, and run the SDJRIP macro. The macro will open a window and you must select an image to process. The macro will perform all the task described in Chapter 1. The final processed image can then be saved in any image format supported by FIJI by using the file > save as command.


Chapter 5

Future Planned SDJRIP Features

The current SDJRIP macro allows the processing of individual images in FIJI. This 1.0 version is an initial macro created due to the time constraints of the NASA competition. The authors plan to add additional features in the feature for subsequent versions of the macro. For example, the ability to batch process multiple images at once. Other potential features that could be added include an more expansive GUI interface and the ability to separate and process individual channels from RGB image files. 

Space Agency Data

Images from the NASA JunoCam website were used to test our macro.

https://www.missionjuno.swri.edu/junocam/processing

Hackathon Journey

Team Space Dragons (A. Youker & R. Youker)


Amber Youker (Age 8)


My space apps experience was cool and fun . My team chose exploring the Jovian system like never before cause I thought it would be a great way to unleash our creativity. My approach to this project was nervous and excited . It took us many tries, trial and error, to resolve our set back but eventually we got the perfect filter to show the swirl clouds on Jupiter and make an artistic picture.


Robert Youker (Father of Amber Youker)


I have never participated in a hackathon before and I was nervous like my daughter. My plan was to have my son and daughter participate as a team but my son decided to join another local team on a different project that interested him. I jumped in and teamed up with my daughter. Even though I was nervous, I am a scientist by training. My daughter chose the topic and her artistic eye and ability were important to completing the project. We chose the topic keeping in mind the abilities of my eight year old daughter and myself which were vastly different but complimentary.


Our approach to the project was to divide and conquer based on our expertise. I showed my daughter some basic functions in ImageJ and she decided on how to process the image to convert it to a "pretty picture". I worked on the creation of the macro. We both worked on the creation of the short user manual for our macro. We resolved setbacks through internet search queries, trial and error, and brainstorming.


We would like to thank the following persons and organizations for setting up our local hackathon and providing the lodging and resources (computer, internet) to complete the project.


Randi Neff, Matt Cass, and Alex Lewis (Southwest Community College) for organizing and running the event. Tim DeLisle and Melanie Crowson from the Pisgah Astronomical Research Institute (PARI) for hosting the event and providing tours of the facilities. 

References

NIH Image to ImageJ: 25 years of image analysis-

Caroline A Schneider, Wayne S Rasband & Kevin W Eliceiri

doi:10.1038/nmeth.2089



Fiji: an open-source platform for biological-image analysis-

Johannes Schindelin, Ignacio Arganda-Carreras, Erwin Frise, Verena Kaynig, Mark Longair, Tobias Pietzsch, Stephan Preibisch, Curtis Rueden, Stephan Saalfeld, Benjamin Schmid, Jean-Yves Tinevez, Daniel James White, Volker Hartenstein, Kevin Eliceiri, Pavel Tomancak & Albert Cardona

doi:10.1038/nmeth.2019

Tags

#art, #macro, #imageJ #Junocam #Jupiter