Stoatworks Anchorage Solar Locations

Welcome

This repository contains code and data regarding locations of solar installations in the Anchorage Alaska area between 2017 and 2023. The maps and visuals generated by this repo are intended for public display, either in publications or presentations, and represent a general portrait of the residential solar sector in Anchorage.

To go straight to the animated heat map, click here

Getting Started

You are welcome to interact with this repo on several levels:

• Embed or link the dynamic Mapbox maps to your website
• Run new/updated data through the geocoding scripts

Questions and comments? If you have a GitHub account, please open a new issue in this repo. Otherwise, contact iamacdougall@alaska.edu

Embed or Link to the Map

To embed the map in your website, use the following HTML code:

<iframe 
    width="600" 
    height="450" 
    frameborder="0" 
    style="border:0" 
    src="https://acep-uaf.github.io/sw_anchorage_solar_locations/" 
    allowfullscreen>
</iframe>

Update, Debug, or Develop

If you would like to update ARCTIC locations, debug problems with the map, or develop new features, start by cloning the repository to your local machine.

The following steps assume you have R, renv (for managing R dependencies), node.js, and npm installed:

Install R Dependencies

Once the repository has been cloned to your computer, install the necessary R dependencies

1. In a terminal window, navigate to the root directory of the repo
2. Start R by typing R and pressing Enter
3. In the R console, run the following command to install renv (renv is a package manager similar to npm):

install.packages("renv")

or if you already have renv on your global system, skip and run:

renv::restore()

This will install the R packages specified in the renv.lock file.

4. Quit R by typing q() and pressing Enter

Install Javascript Dependencies

To install Javascript dependencies, navigate to the repo and run npm install.

Adding Changes

Changes made to update, debug, or develop are best done in a new branch such as feature/your_cool_widget or bugfix/your_solution. This new local branch can be pushed to a new branch on the remote, then a pull request made to merge the changes into main. Please note that direct commits to main are blocked so as not to break the public map. Pull requests will need approval before merging. All merges to main will rebuild the map.

Workflow Diagram