/org-fit

Primary LanguagePython

org-fit

The idea is to develop a “fitness tracking utility” (i.e. Strava/Runkeeper) based on org format. I started development mainly to learn a bit of Elisp and because I was disappointed by the switch to closed source license of Runalyze. For now it is just a small prototype

screen.png

export-html.png

The architecture consists of three components:

  • org-mode (actually the org-mode text format) to store data in human readable format. Org-mode format will play the same role of maildir for mu4e and ledger files for ledger.
  • a command line utility (server) to process and index org-mode files. This plays the same role of mmu for mu4e and ledger
  • a user interface (GUI) to present graph and statistics produced via the server

org-fit format

For now I’m only working on gym notes: i.e. notes taken while training in the gym. The idea is to have functionalities on par with https://play.google.com/store/apps/details?id=com.github.jamesgay.fitnotes&hl=en

Each workout is a top-level entity. The second string of the entity title must be a date in format YYYY-MM-DD. The date will probably become a property of the entity.

 * Workout
:PROPERTIES:
:date: 2018-01-24
:END:

Each exercise is a sub-entity of a workout entity. An exercise can have the following optional properties :

  • name; it’s the name of the entity
  • muscle: a string to identifying the type of exercise. E.g Cardio, Abs, Legs.
  • duration: duration of the exercise in format hh:mm:ss
  • distance: distance in meters, i.e. 3200.0 m
 ** Rowing Machine
:PROPERTIES:
:muscle: Cardio 
:duration: 0:15:39 
:distance: 3200.0 m
:END:

 ** Crunch Machine
:PROPERTIES:
:muscle: Abs  
:END:

An exercise can have multiple sets. Sets are expressed as a - list.

- 11.0 kgs x 10 reps
- 11.0 kgs x 15 reps
- 11.0 kgs x 15 reps

Weight property for sets is optional

- 10 reps
- 15 reps
- 15 reps

You can find a complete example in example.org

server

The server is implemented via a small command line python utility in cli/cly.py. The server has a prompt, which allows to load org-files (and in future indexes) and process them without need of reloading them for each invocation.

The server supports the following commands

  • import csvfile orgfile Converts a CSV file exported by fitnotes Android app to org-fit format
  • quit Quit the program
  • load_org orgfile Loads an org-fit file
  • list_muscles List the tags used to classify exercises
  • graph value groupby months muscle filename produces a linear graph from the loaded fit file
    • value is the value displayed and can be count (number of exercises), sets (number of sets), reps (total number of repetitions), volume (weight x reps)
    • groupsby is the resolution of the x axis and can be day, week, or month
    • months is the interval of the x axis and can be all (no limit) or an integer representing the number of months
    • muscle filters the exercises and can be all or one of the strings used to tag the exercises (i.e. Chest)
    • filename filename of the produced png

The server uses pandas, numpy, matplotlib, and orgparser

GUI

The GUI consists of an org-file where you can add graph and statistics and emacs functions defined in emacs/gym.el.

Configuration

There are three variables to customize:

  • org-fit-data-file full-path of your org-fit file
  • org-fit-export-path full-path of the directory used to produce the graphs
  • org-fit-cli-exec full-path of cli.py

Using the GUI

Open an org file like analysis.org. This is your main GUI. Graph are produced by manipulating org-babel snippets.

  • To start the org-fit execute org-fit-start.
  • To add a graph for historical data execute org-fit-add-graph-history
  • To add a table for historical data execute org-fit-add-table-summary
  • To add a pie chart graph execute org-fit-add-graph-breakout
  • To add a table for breakout data execute org-fit-add-table-breakout
  • You can update a graph by moving the cursor in the corresponding org-babel fragment and use the following keybinding
    • C-q 1 display volume (i.e. kg * reps)
    • C-q 2 display reps
    • C-q 3 display max weight
    • C-q 4 display sets
    • C-q 5 display max reps
    • C-q 6 display 1RM Epley formula
    • C-w 1 group per month
    • C-w 2 group per week
    • C-w 3 group per day
    • C-e 1 limit results to last month
    • C-e 2 limit results to two months
    • C-e 3 limit results to three months
    • C-e 6 limit results to six month
    • C-e 0 no time limit
    • C-e e filter per exercise
    • C-e 0 filter per muscle

Work in progress

  • breakout graph per exercise
  • selection of time range for breakout graph
  • Import/merging
  • Compute additional data per workout