starBliss

KO | EN

gitlite — search

#python #claude-code #ai #mcp-server #llm #ai-agent #mcp #typescript #llm-tools #agentic-ai #automation #genpark

★ 51 Open GitHub ↗

Create beautiful, print quality maps of the night sky in R

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# starBliss  <a href='https://github.com/benyamindsmith/starBliss'><img src='https://github.com/benyamindsmith/starBliss/blob/main/starBliss.png' align="right" height="300" /></a>

Initially inspired by an issue posted on the [`mapBliss`](https://github.com/benyamindsmith/mapBliss/issues/10) package. The goal of this package is to create print quality starmap art similar to what is available online on many websites like [Maps For Moments](https://mapsformoments.co.uk) and [Etsy](https://www.etsy.com/ca/market/star_map) within the R console.

As is the case with all projects. This one is a work in progress. So this repository will change over time!

<details>
<summary>
<h3>Installing this package</h3>
</summary>

```r
# install.packages("devtools")
devtools::install_github("benyamindsmith/starBliss")
```

</details>

<details>
<summary>
<h3>Why this isn't included in `mapBliss`</h3>
</summary>

The `mapBliss` package utlizes leafleat and creates dynamic maps which can be screenshot to make custom maps. For visualization `starBliss` uses `ggplot2` creates static visuals which can be saved by using the `ggsave`. Since the approaches to making visuals were so different, I thought it was best make keep `mapBliss` and `starBliss` seperate in their construction.

</details>

<details>
<summary>
<h3>Dependencies</h3>
</summary>
This package has the following dependencies:
 
 (In no particular order)
 
 * `dplyr`
 
 * `ggplot2` 
 
 * `magrittr`
 
 * `tidygeocoder`
 
 * `sf`
 
 * `lubridate`
 
 * `tibble`
 
 * `grid`

* `s2`
 
</details>

<details>
<summary>
<h3>Basic Usage/Sample Visuals</h3>
</summary>

<details>
<summary>
"Black" Style
</summary>

```r
library(ggplot2)
library(starBliss)
p<- plot_starmap(location= "Toronto, ON, Canada",
             date="2022-01-17",
             style="black",
             line1_text="Toronto",
             line2_text ="January 17th, 2023",
             line3_text="43.6532° N, 79.3832° W")
ggsave('toronto_black.png', plot = p, width = unit(10, 'in'), 
       height = unit(15, 'in'))
```

![](https://raw.githubusercontent.com/benyamindsmith/starBliss/main/toronto_black.png)
</details>

<details>
<summary>
"Green" Style
</summary>

```r
library(ggplot2)
library(starBliss)
p<- plot_starmap(location= "Toronto, ON, Canada",
             date="2022-01-17",
             style="green",
             line1_text="Toronto",
             line2_text ="January 17th, 2023",
             line3_text="43.6532° N, 79.3832° W")
ggsave('toronto_green.png', plot = p, width = unit(10, 'in'), 
       height = unit(15, 'in'))
```

![](https://raw.githubusercontent.com/benyamindsmith/starBliss/main/toronto_green.png)
</details>
</details>

<details>
<summary>
<h3>Using the Web App</h3>
</summary>

If using the R console is not something you're interested in doing. I created a [Shiny App](https://github.com/benyamindsmith/starBlissGUI) that you can check out and use. Check out the [hosted version](https://benyamindsmith.shinyapps.io/starBlissGUI/) on shinyapps.io 
</details>

<details>
<summary>
<h3>Acknowledgements</h3>

</summary>
This package is largely based on the heavy lifting done by other talented developers. Among them including:

* [Kim Fitter](https://github.com/kimnewzealand) for her [Celestial Maps in R](https://kimnewzealand.github.io/2019/02/21/celestial-maps/) blog.

* [Allan Cameron](https://stackoverflow.com/users/12500315/allan-cameron) for [supplying the code](https://stackoverflow.com/questions/75064069/creating-star-map-visualizations-based-on-location-and-date/75064359#75064359) which got this started.

* [Bernardo Lares](https://github.com/laresbernardo) for opening up issues!

* [Diego Hernangómez](https://github.com/dieghernan) for helping with the [constellation lines problem](https://stackoverflow.com/questions/75205747/how-to-remove-random-diagonal-lines-from-star-map-vizualizations-produced-by-geo/75212722#75212722) and for helping with making a [rotation function](https://github.com/benyamindsmith/starBliss/pull/10) which accurately matches MapsForMoments.
</details>

starBliss

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README