3e:null 3f:["$","title",null,{"children":"The Periodization Algorithm | remainstheday's Workspace | Observable"}] 45:T980, ## A Brief Overview Before we take a look under the hood at the different components of this algorithm let's review the definition of periodization training. > _In Matveyev’s model the fundamental concept is that training should gradually progress from high-volume/low-intensity to low-volume/high-intensity to prepare an athlete for peak performance. Tools such as Hans Selye’s General Adaptation Syndrome (GAS), Specific Adaptations to Imposed Demands (SAID) Principle, and Progressive Overloading (PO) are great examples of mechanisms that support the periodization model._ ~[NASM](https://blog.nasm.org/periodization-training-simplified) Additional resources on the science of periodization can be found below in the appendix of this notebook. ### So what goes into the algorithm? - **Input race data.** Before the algorithm can compute daily workouts it needs input values for all races planned this season. Races should be broken into `priority_race`, `secondary_races`, and `tertiary_races`. These races should be mapped to a `season_calendar` for use later on in the algorithm. - **Estimated difficulty and safety.** The human body needs time to adapt to the stress of training in order to develop performance and avoid injury. The number of days between `training_start_date` and `priority_race` will determine if the algorithm has enough time to allocate to each phase of periodization. - **Defined periodization phases.** The phases: Prep, Base, Build, Peak, and Race will each have the following properties: - `start_date` - `end_date` - `total_days` - `objective` - `weekly_workouts` These phases will map to the season_calendar with a start_date and end_date value that depends on the priority_race date. - **Compute daily workouts.** The `weekly_workouts` property for each phase is a starting point to ensure overall volume is met. However there will need to be some refinement based on the `overall_training_duration` we estimated earlier. - **Output results.** At this point the algorithm can provide the user with customized training workouts based on their race season. In a future version the algorithm will accept input data during training to update workouts in real time. That's nice now show me the algorithm! ## The Algorithm The first step is to collect input data about the user's priority race. This can be a simple html form that feeds values into the algorithm.46:T61a,prep_workouts = ({ "period_1": [ { "date": "2023-12-28T19:47:19.253Z", "activity": "easy run", "distance": 2, "heart_rate": 0, "duration": "", "details": "", "periodization_phase": "Base" }, { "date": "2023-12-28T19:47:19.253Z", "activity": "easy run", "distance": 3, "heart_rate": 0, "duration": "", "details": "", "periodization_phase": "Base" }, { "date": "2023-12-28T19:47:19.253Z", "activity": "sprints", "distance": 0.7, "heart_rate": 0, "duration": "", "details": "2 x 800 meter repeats", "periodization_phase": "Base" }, { "date": "2023-12-28T19:47:19.253Z", "activity": "easy run", "distance": 3, "heart_rate": 0, "duration": "", "details": "", "periodization_phase": "Base" }, { "date": "2023-12-28T19:47:19.253Z", "activity": "easy run", "distance": 2, "heart_rate": 0, "duration": "", "details": "run negative splits", "periodization_phase": "Base" }, { "date": "2023-12-28T19:47:19.253Z", "activity": "long run", "distance": 4, "heart_rate": 0, "duration": "", "details": "Long slow run", "periodization_phase": "Base" }, { "date": "2023-12-28T19:47:19.253Z", "activity": "Rest", "distance": 0, "heart_rate": 0, "duration": "", "details": "Rest and recover", "periodization_phase": "Base" } ] })47:T478,## Future Possibilities Initially the algorithm was programmed for running but it can be expanded into other endurance sports. Theoretically this form of training could even be used on hybrid events like Hyrox or any sport that has seasons and race/game days with a 1+ hour duration. The only major change needed to make this work for alternative sports would be the daily workouts. With some additional effort this algorithm has many different applications including: - a browser plugin to populate your calendar with daily workouts. - a mobile coaching app that synchronizes with your health data to modify the periodization workouts in real time. - a simple webpage (like this one) to get instant feedback while planning your season. There's also plenty of room for improvement in making the code behind this algorithm more efficient. Next step would be to explore what this could look like with real time data and/or integration of a large language model (LLM) for fine tuning the workouts. This notebook is dynamic in nature and can be updated at anytime. For more information or to contribute, please email trenton@remainstheday.org48:[] 43:{"id":"7a963ad8d669e609","slug":null,"title":"The Periodization Algorithm","thumbnail":"622d892fd7abd3523d272752870568ff4e9b9e88d592d32169d79b5b91ce2aac","access_level":"public","create_time":"$D2024-01-07T08:20:18.194Z","update_time":"$D2024-01-30T14:13:55.978Z","view_time":null,"first_public_time":"$D2024-01-17T22:10:16.836Z","has_unpublished_edits":null,"fork":false,"stars":1,"starred":false,"owner":{"type":"team","id":"e41debb2fbc37636","login":"remainstheday-ws","name":"remainstheday's Workspace","avatar_url":"https://avatars-next.observableusercontent.com/460e7a03dc1bf035760764d90ba2e76ff3a095a468e6a94bf45674d4efb156f5","tier":"starter_2024","bio":"","following":false},"version":1173,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"67ee9e35973807df","login":"remainstheday","name":"remainstheday","avatar_url":"https://avatars-next.observableusercontent.com/f62ac5f4be26f057fdccfb6fc40fc269c2e8a93b1796afac32dda0a515a8c430","tier":null,"bio":"Remains The Day Labs focuses on improving the experiences people have with health and fitness.","following":false}],"members":[{"type":"individual","id":"67ee9e35973807df","login":"remainstheday","name":"remainstheday","avatar_url":"https://avatars-next.observableusercontent.com/f62ac5f4be26f057fdccfb6fc40fc269c2e8a93b1796afac32dda0a515a8c430","tier":null,"role":"editor"},{"type":"team","id":"e41debb2fbc37636","login":"remainstheday-ws","name":"remainstheday's Workspace","avatar_url":"https://avatars-next.observableusercontent.com/460e7a03dc1bf035760764d90ba2e76ff3a095a468e6a94bf45674d4efb156f5","tier":"starter_2024","role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"titling":"auto","title":"The Periodization Algorithm","cells":[{"id":0,"value":"# The Periodization Algorithm\nFounded in the 1960's periodization training has been a pillar in sports science to this day. It’s concepts can be found in textbooks and are widely used by athletes of all skill levels. Since periodization training has a set of scientifically tested principles, we can break them down into an algorithm that computes daily training data leading to an optimal performance on race day. Many coaches (sometimes unknowingly) already use a form of the periodization algorithm to manually program workouts for their athletes in a seasonal calendar. Our goal is to demystify the process of planning a race season by sharing this algorithm publicly through open source code.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":107,"value":"$45","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":334,"value":"viewof form_values = form(html``)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":902,"value":"For this example we need to import several javascript utility functions which will make it easier to work with dates. Calendar dates are integral to this algorithm as you'll see later on, but working with data related to date & time can be tricky. If using this algorithm in production make sure to thoroughly review the output dates.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":919,"value":"import {form} from \"@mbostock/form-input\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":914,"value":"dateFns = import(\"https://esm.run/date-fns\")","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":922,"value":"dateFormatter = (date, days) => {\n return dateFns.format(dateFns.sub(new Date(date), {days}), \"MM/dd/yyyy\")\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":929,"value":"Now we need to declare some default values. The durations of each phase are set to a max number of days that should be spent in each, but these values will later be modified depending on the form's `training_start` and `race_date` inputs.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":984,"value":"training_duration_total = dateFns.differenceInDays(\n new Date(form_values.race_date),\n new Date(form_values.training_start),\n);","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":884,"value":"phase_durations = ({\n prep_phase: 28,\n base_phase: 84,\n build_phase: 56,\n peak_phase: 14,\n race_phase: 7,\n})","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":887,"value":"priority_race = ({\n \"type\": form_values.sport,\n \"date\": new Date(form_values.race_date),\n \"distance_in_miles\": form_values.distance\n});","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":904,"value":"Next we should determine a \"safety score\" also known as a \"difficulty score\". As mentioned earlier the human body needs time to adapt to the stress of training in order to develop performance and avoid injury. The number of days between training_start and `race_date` will determine if the algorithm has enough time to allocate to each phase of periodization. If there isn't enough time to train properly the risk of injury goes up, hence the term \"safety score\". \n\n_The safety/difficulty score below will update in real time depending on the values you enter into the form above._","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":933,"value":"determineSafetyScore()","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":907,"value":"function determineSafetyScore() {\n const safety_scores = [\n { days: 268, message: \"safety score: 10. You have enough time for multiple peaks.\" },\n { days: 200, message: \"safety score: 7-9. You have plenty of time to peak on race day.\" },\n { days: 150, message: \"safety score: 5-6. You need to start today if you plan on peaking race day.\" },\n { days: 75, message: \"safety score: 3-5. Warning! If you start today there are not enough days to peak on race day.\" },\n { days: 1, message: \"safety score: 1-2. Danger! There is a high possibility of injury if you start training now.\" }\n ];\n\n for (let i = 0; i < safety_scores.length; i++) {\n if (training_duration_total >= safety_scores[i].days) {\n return safety_scores[i].message;\n }\n }\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":944,"value":"Assuming the user has provided enough time between training start and race date we can proceed with calculating the number of days allotted to each periodization phase based on how far out the race is. Technically the minimum number of days (min_value) can be adjusted here based on the sport and race distance. For the sake of this demo we are using the marathon (26.2 miles) as the baseline.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":1016,"value":"function calculateDaysInPhases() {\n let calculated_durations = phase_durations;\n let phases_duration_total = Object.values(calculated_durations).reduce((a, b) => a + b, 0);\n const phases = [\n { name: 'prep_phase', min_value: 7 },\n { name: 'base_phase', min_value: 63 },\n { name: 'build_phase', min_value: 42 },\n { name: 'peak_phase', min_value: 7 }\n ];\n\n while (phases_duration_total > training_duration_total) {\n for (let phase of phases) {\n if (calculated_durations[phase.name] > phase.min_value) {\n calculated_durations = {\n ...calculated_durations,\n [phase.name]: calculated_durations[phase.name] - 1,\n };\n phases_duration_total--;\n break;\n }\n }\n }\n return calculated_durations;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":959,"value":"With the dates of each periodization phase defined we can begin mapping workouts to each day in the training season. \n\nAbove each function are sample workouts for the first week in that phase. Each function maps over these workouts and increments the values for the total duration of the phase. The default workouts provided are malleable, if you know what you're doing and want to modify them you can customize the algorithm to your liking. For everyone else these workouts can be followed out of the box. They use a fairly standard format that includes: \n- several short to medium distance runs\n- speed work/track workouts\n- weekly long run\n- recovery day\n\n_disclaimer: Although the workouts generated by this algorithm have been tested by real people they are still in an experimental phase. Follow at your own risk._","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":967,"value":"$46","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":961,"value":"function mapWorkoutsInPrepPhase(duration) {\n let workouts = {};\n let increment = 0;\n\n for (let i = 0; i <= duration; i++) {\n let resetDistance = 6 + increment * 2;\n if (resetDistance > 20) {\n resetDistance = 6;\n increment = 0;\n } else {\n increment += 1;\n }\n workouts[`period_${i + 1}`] = prep_workouts.period_1.map((workout, idx) => {\n if (workout.activity === \"long run\") {\n let incrementedDistance = workout.distance + i;\n let adjustedDistance =\n incrementedDistance > 20 ? resetDistance : incrementedDistance;\n return {\n ...workout,\n distance: adjustedDistance,\n };\n } else {\n return {\n ...workout,\n };\n }\n });\n }\n\n return { workouts };\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1057,"value":"To keep this notebook digestible the remaining phases have been left out but the same logic above applies to every phase (prep, base, build, peak, race) the only difference being what workouts are fed into each mapping function.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":677,"value":"$47","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":1064,"value":"## Appendix\n- https://www.ncbi.nlm.nih.gov/pmc/articles/PMC4637911/\n- https://blog.nasm.org/periodization-training-simplified\n- https://en.wikipedia.org/wiki/Sports_periodization\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"}],"files":"$W48","stdlib":"1"}} 44:"$43:body"