hleroy / climbing_route_chart

Climbing Route Chart Generator is a Python application designed for generating visual pie charts of indoor climbing routes. The tool is ideal for climbing gyms who wish to visualize route distributions in an easy-to-understand format.

Climbing Route Chart Generator

Version française

Overview

Climbing Route Chart Generator is a Python application designed to generate pie chart graphics to visualize indoor climbing routes. These charts are produced from a CSV input, illustrating the distribution of the route grades and the associated setters. The tool is ideal for climbing gym managers to quickly and easily update the labels after a setting campaign.

Online tool

The simplest way to use this tool is to use the online version hosted by Adrénaline Escalade, a climbing club from Hauts de Seine (92) in France.

https://etiquettes.adrenaline-escalade.com/

Using locally with Docker

This is the simplest option, assuming you already have Docker installed:

  $ docker build -t climb-routes .
  $ docker run -p 8080:8080 climb-routes

Open your browser and navigate to localhost:8080

Using locally with CLI (command line interface)

Setup

To set up Climbing Route Chart Generator, follow these steps:

1. Create a virtual environment in a folder named "venv":

   python -m venv venv

2. Activate the virtual environment:
   • On Windows:

     .\venv\Scripts\activate

   • On Linux or MacOS:

     source venv/bin/activate

3. Install the required dependencies:

   pip install -r requirements.txt

Usage

Run the script with the following command:

cd src
./route-charts.py -i <input_file.csv> [-o <output_file.pdf>]

Arguments

Refer to the output of ./route-charts.py --help for a list of all optional arguments.

Input Format

The input should be a CSV file with the following columns:

• Relais
• Couleur
• Cotation
• Ouvreur

License

This project is unlicensed and free for public domain use. For more details, see UNLICENSE.