MTB Dynamics in intervals.icu

// intervals.icu custom activity stream: MTB Grit (grit points per second)
// Settings: Code MtbGrit · Units grit · tick "Processes fit file messages"
//
// Only needed if you also ride with a Garmin: it reads the Karoo developer field mtb_grit and
// falls back to Garmin's native "grit" field. Karoo-only riders can instead create the stream
// with Record field = mtb_grit (no script).
{
  for (let m of icu.fit.record || []) {
    if (!m.timestamp) continue
    let f = m.mtb_grit || m.grit
    if (f && f.value != null) data.setAt(m.timestamp.value, f.value)
  }
}

// intervals.icu custom activity stream: MTB Flow (unnecessary braking, metres per second)
// Settings: Code MtbFlow · Units m · tick "Processes fit file messages"
//
// The Karoo writes mtb_flow a few seconds late (Flow looks ahead: braking before a tight corner
// is fine). This script moves every value back to the second it belongs to.
// Garmin Edge files: falls back to the native "flow" record field.
{
  let session = icu.fit.session ? icu.fit.session[0] : null
  let lag = session && session.mtb_flow_lag ? session.mtb_flow_lag.value : 3
  for (let m of icu.fit.record || []) {
    let ts = m.timestamp
    if (!ts) continue
    if (m.mtb_flow && m.mtb_flow.value != null) {
      data.setAt(ts.value - lag, m.mtb_flow.value)
    } else if (m.flow && m.flow.value != null) {
      data.setAt(ts.value, m.flow.value)
    }
  }
}

// intervals.icu custom activity stream: MTB Braking (deceleration, m/s²)
// Settings: Code MtbBrake · Units m/s2 · tick "Processes fit file messages"
//
// Like mtb_flow, the Karoo writes mtb_brake mtb_flow_lag seconds late; realign it here.
{
  let session = icu.fit.session ? icu.fit.session[0] : null
  let lag = session && session.mtb_flow_lag ? session.mtb_flow_lag.value : 3
  for (let m of icu.fit.record || []) {
    if (m.timestamp && m.mtb_brake && m.mtb_brake.value != null) {
      data.setAt(m.timestamp.value - lag, m.mtb_brake.value)
    }
  }
}

// intervals.icu custom activity stream: Rear cog (teeth) from SRAM AXS shifts
// Settings: Code RearCog · Units T · tick "Processes fit file messages"
//
// The Karoo writes one FIT event per rear shift (rear_gear = teeth). This turns them into a
// second-by-second "cog in use" stream.
{
  // FIT event 43 = rear_gear_change (name casing differs between FIT SDKs)
  const isRearShift = m => m.event && (m.event.value === 43 || String(m.event.valueName).toLowerCase() === 'rear_gear_change')
  let teeth = null
  for (let m of icu.fit) {
    if (m._name === 'event' && isRearShift(m) && m.rear_gear) {
      teeth = m.rear_gear.value
    } else if (m._name === 'record' && m.timestamp && teeth != null) {
      data.setAt(m.timestamp.value, teeth)
    }
  }
}

// intervals.icu custom activity field: MTB Grit (ride difficulty)
// Settings: Code MtbGrit · Units kGrit · tick "Processes fit file messages"
// Karoo MTB Dynamics session field "mtb_total_grit", Garmin MTB Dynamics fallback.
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_total_grit ? s.mtb_total_grit.value : null
  if (v == null) {
    v = s && s.total_grit ? s.total_grit.value : null
  }
  v
}

// intervals.icu custom activity field: MTB Flow (lower = smoother)
// Settings: Code MtbFlow · Units flow · tick "Processes fit file messages"
// Karoo MTB Dynamics session field "mtb_flow_score", Garmin MTB Dynamics fallback.
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_flow_score ? s.mtb_flow_score.value : null
  if (v == null) {
    v = s && s.avg_flow ? s.avg_flow.value : null
  }
  v
}

// intervals.icu custom activity field: MTB Jumps
// Settings: Code MtbJumps · Units jumps · tick "Processes fit file messages"
// Karoo MTB Dynamics session field "mtb_jumps", Garmin MTB Dynamics fallback.
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_jumps ? s.mtb_jumps.value : null
  if (v == null) {
    // Empty rather than 0 for rides without MTB Dynamics: intervals.icu gives every ride a jump list.
    if (s && s.jump_count) v = s.jump_count.value
    else if (icu.fit.jump && icu.fit.jump.length) v = icu.fit.jump.length
  }
  v
}

// intervals.icu custom activity field: MTB longest airtime
// Settings: Code MtbMaxAir · Units s · tick "Processes fit file messages"
// Karoo MTB Dynamics session field "mtb_max_air", Garmin MTB Dynamics fallback.
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_max_air ? s.mtb_max_air.value : null
  if (v == null) {
    for (let j of icu.fit.jump || []) if (j.hang_time && (v == null || j.hang_time.value > v)) v = j.hang_time.value
  }
  v
}

// intervals.icu custom activity field: MTB total airtime
// Settings: Code MtbTotalAir · Units s · tick "Processes fit file messages"
// Karoo MTB Dynamics session field "mtb_total_air", Garmin MTB Dynamics fallback.
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_total_air ? s.mtb_total_air.value : null
  if (v == null) {
    for (let j of icu.fit.jump || []) if (j.hang_time) v = (v || 0) + j.hang_time.value
  }
  v
}

// intervals.icu custom activity field: MTB score (0-100)
// Settings: Code MtbScore · Units score · tick "Processes fit file messages"
// Karoo MTB Dynamics session field "mtb_score".
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_score ? s.mtb_score.value : null
  v
}

// intervals.icu custom activity field: MTB descent braking
// Settings: Code MtbDescentBraking · Units % · tick "Processes fit file messages"
// Karoo MTB Dynamics session field "mtb_descent_braking".
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_descent_braking ? s.mtb_descent_braking.value : null
  v
}

// intervals.icu custom activity field: MTB corners
// Settings: Code MtbCorners · Units corners · tick "Processes fit file messages"
// Karoo MTB Dynamics session field "mtb_corners".
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_corners ? s.mtb_corners.value : null
  v
}

// intervals.icu custom activity field: MTB max cornering g
// Settings: Code MtbMaxCornerG · Units g · tick "Processes fit file messages"
// Karoo MTB Dynamics session field "mtb_max_lat_g".
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_max_lat_g ? s.mtb_max_lat_g.value : null
  v
}

// intervals.icu custom activity field: Flight Attendant Open on descents (%)
// Settings: Code MtbFaOpenDesc · Units % · tick "Processes fit file messages"
// Session field mtb_fa_open_desc (MTB Dynamics 0.2+), else computed from the Karoo's
// front_suspension record field (0 Open, 1 Pedal, 2 Lock) on records with grade <= -2.5 %.
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_fa_open_desc ? s.mtb_fa_open_desc.value : null
  if (v == null) {
    let open = 0, n = 0
    for (let m of icu.fit.record || []) {
      if (!m.front_suspension || !m.grade || m.grade.value > -2.5) continue
      let speed = m.enhanced_speed || m.speed
      if (speed && speed.value < 1) continue
      n++
      if (m.front_suspension.value === 0) open++
    }
    v = n >= 30 ? 100 * open / n : null
  }
  v
}

// intervals.icu custom activity field: Flight Attendant locked on rough ground (s)
// Settings: Code MtbFaLockRough · Units s · tick "Processes fit file messages"
// Seconds in Lock while MTB Dynamics measured >= 0.9 g trail vibration.
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_fa_lock_rough ? s.mtb_fa_lock_rough.value : null
  if (v == null) {
    let n = 0, seen = false
    for (let m of icu.fit.record || []) {
      if (!m.front_suspension || !m.mtb_rough) continue
      seen = true
      if (m.front_suspension.value === 2 && m.mtb_rough.value >= 0.9) n++
    }
    v = seen ? n : null
  }
  v
}

// intervals.icu custom activity field: AXS shifts per km
// Settings: Code MtbShiftsKm · Units /km · tick "Processes fit file messages"
{
  // FIT event 43 = rear_gear_change (name casing differs between FIT SDKs)
  const isRearShift = m => m.event && (m.event.value === 43 || String(m.event.valueName).toLowerCase() === 'rear_gear_change')
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_shifts_km ? s.mtb_shifts_km.value : null
  if (v == null) {
    let shifts = 0
    for (let e of icu.fit.event || []) if (isRearShift(e)) shifts++
    let km = s && s.total_distance ? s.total_distance.value / 1000 : 0
    v = km > 0.5 && shifts > 0 ? shifts / km : null
  }
  v
}

// intervals.icu custom activity field: average power on climbs (W)
// Settings: Code MtbClimbPower · Units W · tick "Processes fit file messages"
// Session field mtb_climb_power, else records with grade >= 2.5 % and speed >= 1 m/s.
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_climb_power ? s.mtb_climb_power.value : null
  if (v == null) {
    let sum = 0, n = 0
    for (let m of icu.fit.record || []) {
      if (!m.power || !m.grade || m.grade.value < 2.5) continue
      let speed = m.enhanced_speed || m.speed
      if (speed && speed.value < 1) continue
      sum += m.power.value
      n++
    }
    v = n >= 30 ? sum / n : null
  }
  v
}

// intervals.icu custom activity field: pedalling on descents (% of descending time)
// Settings: Code MtbDescPedal · Units % · tick "Processes fit file messages"
{
  let s = icu.fit.session ? icu.fit.session[0] : null
  let v = s && s.mtb_desc_pedal ? s.mtb_desc_pedal.value : null
  if (v == null) {
    let ped = 0, n = 0
    for (let m of icu.fit.record || []) {
      if (!m.grade || m.grade.value > -2.5) continue
      let speed = m.enhanced_speed || m.speed
      if (speed && speed.value < 1) continue
      n++
      if (m.cadence && m.cadence.value > 0) ped++
    }
    v = n >= 30 ? 100 * ped / n : null
  }
  v
}

// intervals.icu custom interval field: Interval Grit (difficulty of the selection / lap)
// Settings: Code IntMtbGrit · Units kGrit · needs the custom stream MtbGrit
{
  const stream = code => { try { const s = icu.streams.get(code); if (s && s.data) return s.data } catch (e) {} return null }
  const grit = stream('MtbGrit')
  let sum = 0
  if (grit) for (let i = interval.start_index; i < interval.end_index; i++) sum += grit[i] || 0
  grit ? sum / 1000 : null
}

// intervals.icu custom interval field: Interval Flow (unnecessary braking per 100 m, lower = smoother)
// Settings: Code IntMtbFlow · Units flow · needs the custom stream MtbFlow
{
  const stream = code => { try { const s = icu.streams.get(code); if (s && s.data) return s.data } catch (e) {} return null }
  const flow = stream('MtbFlow'), dist = icu.streams.distance, vel = stream('velocity_smooth')
  let f = 0, d = 0
  if (flow && dist) {
    for (let i = Math.max(1, interval.start_index); i < interval.end_index; i++) {
      if (vel && (vel[i] || 0) < 1) continue
      f += flow[i] || 0
      d += Math.max(0, (dist[i] || 0) - (dist[i - 1] || 0))
    }
  }
  flow && d >= 50 ? 100 * f / d : null
}

// intervals.icu custom interval field: Interval Jumps
// Settings: Code IntMtbJumps · Units jumps · needs the custom stream MtbJumpAir
{
  const stream = code => { try { const s = icu.streams.get(code); if (s && s.data) return s.data } catch (e) {} return null }
  const air = stream('MtbJumpAir')
  let n = 0
  if (air) for (let i = interval.start_index; i < interval.end_index; i++) if ((air[i] || 0) > 0) n++
  air ? n : null
}

// intervals.icu custom interval field: Interval longest airtime
// Settings: Code IntMtbMaxAir · Units s · needs the custom stream MtbJumpAir
{
  const stream = code => { try { const s = icu.streams.get(code); if (s && s.data) return s.data } catch (e) {} return null }
  const air = stream('MtbJumpAir')
  let best = 0
  if (air) for (let i = interval.start_index; i < interval.end_index; i++) best = Math.max(best, air[i] || 0)
  air ? best : null
}

// intervals.icu custom interval field: Interval braking (% of moving time slowing down hard)
// Settings: Code IntMtbBraking · Units % · needs the custom stream MtbBrake
{
  const stream = code => { try { const s = icu.streams.get(code); if (s && s.data) return s.data } catch (e) {} return null }
  const brake = stream('MtbBrake'), vel = stream('velocity_smooth')
  let moving = 0, braking = 0
  if (brake) {
    for (let i = interval.start_index; i < interval.end_index; i++) {
      if (vel && (vel[i] || 0) < 1) continue
      moving++
      if ((brake[i] || 0) >= 0.6) braking++
    }
  }
  brake && moving ? 100 * braking / moving : null
}

// intervals.icu custom interval field: Interval trail roughness (average vibration, g)
// Settings: Code IntMtbRough · Units g · needs the custom stream MtbRough
{
  const stream = code => { try { const s = icu.streams.get(code); if (s && s.data) return s.data } catch (e) {} return null }
  const rough = stream('MtbRough')
  let sum = 0, n = 0
  if (rough) for (let i = interval.start_index; i < interval.end_index; i++) if (rough[i] != null && rough[i] > 0) { sum += rough[i]; n++ }
  n ? sum / n : null
}

// intervals.icu custom interval field: Flight Attendant Open (% of the selection)
// Settings: Code IntFaOpen · Units % · needs the custom stream FaFront (record field front_suspension)
{
  const stream = code => { try { const s = icu.streams.get(code); if (s && s.data) return s.data } catch (e) {} return null }
  const fa = stream('FaFront')
  let open = 0, n = 0
  if (fa) for (let i = interval.start_index; i < interval.end_index; i++) if (fa[i] != null) { n++; if (fa[i] === 0) open++ }
  n ? 100 * open / n : null
}

// intervals.icu custom interval field: Flight Attendant Lock (% of the selection)
// Settings: Code IntFaLock · Units % · needs the custom stream FaFront (record field front_suspension)
{
  const stream = code => { try { const s = icu.streams.get(code); if (s && s.data) return s.data } catch (e) {} return null }
  const fa = stream('FaFront')
  let lock = 0, n = 0
  if (fa) for (let i = interval.start_index; i < interval.end_index; i++) if (fa[i] != null) { n++; if (fa[i] === 2) lock++ }
  n ? 100 * lock / n : null
}

// intervals.icu custom interval field: rear shifts in the selection
// Settings: Code IntShifts · Units shifts · needs the custom stream RearCog
{
  const stream = code => { try { const s = icu.streams.get(code); if (s && s.data) return s.data } catch (e) {} return null }
  const cog = stream('RearCog')
  let shifts = 0, prev = null
  if (cog) for (let i = interval.start_index; i < interval.end_index; i++) {
    if (cog[i] == null) continue
    if (prev != null && cog[i] !== prev) shifts++
    prev = cog[i]
  }
  cog ? shifts : null
}

// intervals.icu custom interval field: most used rear cog in the selection (teeth)
// Settings: Code IntCog · Units T · needs the custom stream RearCog
{
  const stream = code => { try { const s = icu.streams.get(code); if (s && s.data) return s.data } catch (e) {} return null }
  const cog = stream('RearCog')
  const seconds = {}
  if (cog) for (let i = interval.start_index; i < interval.end_index; i++) if (cog[i] != null) seconds[cog[i]] = (seconds[cog[i]] || 0) + 1
  let best = null
  for (const t in seconds) if (best == null || seconds[t] > seconds[best]) best = t
  best == null ? null : Number(best)
}