%% Backpack And Shoe Energy Estimator (BASE)
% J.McDowell 19/12/2018.
% Based on the equations of Pandolf (1970), ACSM (2000) and Hall et al. (2004).

% This script calculates the additional calories that carrying a backpack
% and/or varying weights of running shoes will require per hour of running. It uses
% published approximation methods for the calculation of calories and VO2max,
% accounting for the users weight and pace, as well as gradient and terrain.

%% Output Structures
% ACSM, Pandolf
% Each structure contains kCalperH (kCalories per hour) and PercentImpact (Percentage impact of weight of backpack/shoes).

%% Example Inputs
%[ACSM, Pandolf] = base(85, 0, [0.286], 5, 0.01, 1.01, 0)
% Example call for one pair of shoes [0.286] with no back pack.
%[ACSM, Pandolf] = base(85, 0, [0.286, 0.325], 5, 0.01, 1.01, 0)
% Comparison between two pairs of shoes [0.286, 0.325] with no back pack.

% M_You = 85; % Your weight (Mass) in kg.
% Pace = 5; % Pace in Minutes/km. For example, 4:30/km would be input as 4.5.
% Gradient = 0.01; % Gradient Percentage (0 to 1, with 0 being no incline and 1 being vertical).
% Terrain = 1.01; % Terrain Factor (1 to 2, with 1 being a paved road, 1.2 being a gravel road).
% M_BP = 0; % Mass of Back Pack (kg).
% M_Shoe = 0.286; % Mass of pair of Shoes (kg). Alternatively for comparing two pairs of shoes, M_Shoe = [0.286, 0.325];
% VO2max = 0; % VO2 Max. Input as 0 if this is unknown and the ACSM approximation will be used.