/Herschels

A repository for the Herschels project code

Primary LanguageC++

Herschels

This repository is dedicated to working on the Herschels in a Box project. The goal of the project is to create a Stellarium plugin which can run the various exploratory sweeps the Herschels did (starting with Caroline and William, though we might add John).

Version information

This was built for Stellarium 0.18.x and has not been tested on newer versions. Same goes for this documentation. (prior documentation used a deprecated version numbering system. the below documentation uses v0.18.0) For more packages, see https://github.com/Stellarium/stellarium/tags?after=v0.19.0

Download instructions

  1. Download Stellarium into /home/{{user}}/StelDev/stellarium
    1. cd /home/{{user}}/StelDev
    2. wget https://github.com/Stellarium/stellarium/archive/refs/tags/v0.18.0.tar.gz
  2. Download this repo
    1. git clone https://github.com/Adolfo1519/Herschels
    2. cd Herschels

Installation instructions

  1. Copy the plugin folder (Herschels) to the stellarium dev directory you've set up
    1. cp -r Herschels /home/{{user}}/StelDev/stellarium/plugins
  2. Our plugin needs a specific telescope and lens setting installed into the Oculars plugin, on which it depends. 2 options here:
    1. Overwrite the Oculars default file prior to installation
      1. cp default_ocular.ini /home/{{user}}/StelDev/stellarium/plugins/Oculars/
    2. Take a look at those settings and use the stellarium gui to add them in the GUI after installation
  3. This app requires a new function in the stellarium core to manage telescope motion in the sweeps.
    1. Overwrite the StelMovementMgr.* files in /home/{{user}}/StelDev/stellarium/src/core/ with the copies in this repo.
  4. Create a build directory and build the app from the altered source code
    1. export STELROOT=/home/{{user}}/StelDev/stellarium
    2. cd /home/{{user}}/StelDev/stellarium
    3. mkdir -p builds/macosx
    4. cd builds/macosx
    5. cmake ../..
    6. make
  5. Optional: make the mac app
    1. to delete from installations: rm -rf Stellarium.app
    2. make install
    3. make mac_app
  6. Launch the app (/home/{{user}}/StelDev/stellarium/builds/macosx/src/stellarium executable)
  7. Open plugins dashboard from left-hand toolbar
    1. Make sure your Herschel oculars exist and are properly configured
    2. Set Herschels to launch at startup
  8. Quit, and restart the app
    1. The Herschels plugin will now be available on the bottom toolbar

Sweep data

  • sweeps_data.csv is the transcription of the sweeps
  • formatSweepFile.py takes the data in this csv and creates default_sweep.ini
  • ini_to_db.py imports the data into herschels_data.db

Updating sweep dataset:

  1. Update sweeps_data.csv
  2. Run formatSweepFile.py
  3. Overwrite the file in /home/{{user}}/StelDev with the resulting ini file
  4. Delete the Herschel plugin application defaults for Stellarium, for example:
    1. rm -rf ~/Library/Application\ Support/Stellarium/modules/Herschels
  5. Run through the installation instructions again, including checking and resetting the appropriate application default settings

Humanities Research Center and Center for Research Computing, Rice University

Canonical Repository link available at: https://scholarship.rice.edu/handle/1911/109852

License/Rights: CC0 1.0 Universal Link to License http://creativecommons.org/publicdomain/zero/1.0/

Article on this repository available at: https://doi.org/10.1162/leon_a_01832