raichkel/gr_in_vr

Project to display black holes in Virtual Reality

Black Holes in VR

Project using the Gradus package in Julia to display black holes using virtual reality.

Trajectory of the observer is pre-computed using the Gradus package, and then passed to Unity, which will display the scenario in VR.
This project is designed for use on High Performance Computing (HPC) systems.

Docs

The documentation for this project can be found on GitHub Pages, here.

Repository Structure

💫 GR_in_VR/final_simulations/
Contains the output simulations for Schwarzschild and Kerr black holes, as well as a Morris-Thorne wormhole.
💫 GR_in_VR/project/src/pre_computation/
Code to generate the simulation, including test images and test simulations.
💫 GR_in_VR/project/src/accretion_disk/
Process files for modelling the accretion disk.
💫 GR_in_VR/project/src/batch_scripts/
Shell script files for running code on HPC.
💫 GR_in_VR/project/src/sysimage/
Code to generate sysimage using the PackageCompiler package.
💫 GR_in_VR/project/src/VR/
C# code for running the simulation on VR headset with Unity.
💫 GR_in_VR/project/post_processing/
Code for colourising images and compiling it into a video.
💫 GR_in_VR/project/runner_files/
Runner files for use with the batch scripts on HPC systems.
💫 GR_in_VR/project/test_frames/
Miscellaneous frames used in the test code.
💫 GR_in_VR/project/vr_files/
Files to set up Unity Hub for runningthe simulation.\

Installation

This project relies heavily on the Gradus package which, in turn, relies on aspects of the AstroRegistry AstroRegistry. The AstroRegistry can be added as follows:

julia>] registry add https://github.com/astro-group-bristol/AstroRegistry

and then Gradus can be added by running:

julia>] add Gradus
julia> using Gradus

Loading Julia using the command line flag

--project="project"

will load in the necessary packages alongside this.

The repository can then be cloned to your local machine as usual using git clone.

gr_in_vr's Issues

Work Out Colour Emission From Accretion Disk

Look over the code at https://github.com/astro-group-bristol/AccretionFormulae.jl/blob/main/src/emission_profile.jl and find the remperature of each coordinate on the accretion disk

Tasks:

• look over the code and how to use it
• remember to multiply calculated temp by redshift factor g for observed temp.
• convert these temps to a wavelength
• convert wavelength to rgb
• look at storing these in a file for lookup later

Generating Series of Equirectangular Images

Generating the images to be used as part of the .mp4. This doesn't have to initially be acccurate with textures/colours, just looking at how best to generate images along a trajectory.

Tasks for this:

• decide on a trajectory/range of trajectories
• look at the equirectangular images file and generate some example images
• devise a way of parallelising this - embarrasingly parallel