Weltgeist

"Wind and emission of light with time-dependent gas evolution for interstellar structures and targets"

Introduction

Spherical hydrodynamics for feedback from massive stars

This is a Python/Numpy module based on the code Virginia Hydrodynamics 1 designed to simulate 1D spherically symmetric flows around massive stars.

Pre-requisites

1. Install the Unix packages: sudo apt get build-essential gfortran git git-lfs python3 python-dev python3-pip cmake ninja-build

2. Set up a virtual python3 environment to put the code in and activate it e.g. https://docs.python.org/3/library/venv.html

3. Install the required Python packages: pip install numpy scipy h5py scikit-build h5py

Optional: if you also want the real-time visualiser (used in some of the examples): pip install pyglet

Install Weltgeist

Make sure you activate your python3 environment (see above)

1. Clone the repository to your computer and go to the Weltgeist folder where the setup.py file is: git clone git@github.com:samgeen/Weltgeist.git

2. Get the big stellar evolution files by running "bash downloaddata.sh", or by dowloading and unzipping the repository found at https://zenodo.org/record/8192816 (there should be a folder in the main directory called StellarSources/data)

3. Run "python3 setup.py build" to build the code.

4. Run "python3 setup.py install" to install it to your python environment

If this all works, great! Otherwise get in touch with the problem and I'll take a look.

Uninstall Weltgeist

If you change your mind and want it gone, call "pip uninstall weltgeist" (you might need to do this ouside the Weltgeist folder)

Quickstart

To get an idea of the code, go through the worked examples in examples/

They're written to take you gently through how the code works. The comments also invite you to play with the code and learn how changing things affects the result

Advanced Use

Here is a rough overview of the different parts of the code: