rider Module

configure_rider(pathToRider, bicycle, bicyclePar, measuredPar, draw)

Returns the rider parameters, bicycle paramaters with a rider and a human object that is configured to sit on the bicycle.

Parameters:
pathToRiderstring

Path to the rider’s data folder.

bicyclestring

The short name of the bicycle.

bicyclePardictionary

Contains the benchmark bicycle parameters for a bicycle.

measuredPardictionary

Contains the measured values of the bicycle.

drawboolean, optional

If true, visual python will be used to draw a three dimensional image of the rider.

Returns:
riderpardictionary

The inertial parameters of the rider with reference to the benchmark coordinate system.

humanyeadon.human

The human object that represents the rider seated on the bicycle.

bicycleRiderPardictionary

The benchmark parameters of the bicycle with the rider added to the rear frame.

rider_on_bike(benchmarkPar, measuredPar, yeadonMeas, yeadonCFG, drawrider)

Returns a yeadon human configured to sit on a bicycle.

Parameters:
benchmarkPardictionary

A dictionary containing the benchmark bicycle parameters.

measuredPardictionary

A dictionary containing the raw geometric measurements of the bicycle.

yeadonMeasstr

Path to a text file that holds the 95 yeadon measurements. See yeadon documentation.

yeadonCFGstr

Path to a text file that holds configuration variables. See yeadon documentation. As of now, only ‘somersalt’ angle can be set as an input. The remaining variables are either zero or calculated in this method.

drawriderbool

Switch to draw the rider, with vectors pointing to the desired position of the hands and feet of the rider (at the handles and bottom bracket). Requires python-visual.

Returns:
humanyeadon.Human

Human object is returned with an updated configuration. The dictionary, taken from H.CFG, has the following key’s values updated:

‘PJ1extension’ ‘J1J2flexion’ ‘CA1extension’ ‘CA1adduction’ ‘CA1rotation’ ‘A1A2extension’ ‘somersault’ ‘PK1extension’ ‘K1K2flexion’ ‘CB1extension’ ‘CB1abduction’ ‘CB1rotation’ ‘B1B2extension’

Notes

Requires that the bike object has a raw data text input file that contains the measurements necessary to situate a rider on the bike (i.e. <pathToData>/bicycles/<short name>/RawData/<short name>Measurements.txt).

yeadon_vec_to_bicycle_vec(vector, measured_bicycle_par, benchmark_bicycle_par)
Parameters:
vectorndarray, shape(3, 1)

A vector from the Yeadon origin to a point expressed in the Yeadon reference frame.

measured_bicycle_pardictionary

The raw bicycle measurements.

benchmark_bicycle_pardictionary

The Meijaard 2007 et. al parameters for this bicycle.

Returns:
vector_wrt_bikendarray, shape(3, 1)

The vector from the bicycle origin to the same point above expressed in the bicycle reference frame.