API

API#

Tension#

String tension calculations.

For example:

  • For specified strings, calculate tensions.

  • For specified total or per-string tension, suggest strings.

stringcalc.tension.gauge(density, T, L, pitch)

From density, scale length, pitch, and desired tension, compute gauge.

stringcalc.tension.suggest_gauge(T, L, pitch, *)

For target tension, given scale length, and pitch, return suggested gauge(s).

stringcalc.tension.tension(s[, pitch])

Compute tension for String.

stringcalc.tension.unit_weight(T, L, pitch)

From scale length, pitch, and desired tension, compute unit weight (mass per unit length) [lbm in-1].

Data#

More information on the data and processing is available at zmoon/stringcalc.

stringcalc.tension.load_data()

Load all string data.

stringcalc.tension.load_aquila_data(*[, ...])

Load Aquila NNG (New Nylgut) data.

stringcalc.tension.load_daddario_data(*[, ...])

Load D'Addario data.

stringcalc.tension.load_daddario_stp_data(*)

Load D'Addario data derived from the new String Tension Pro (STP).

stringcalc.tension.load_ghs_data(*[, ...])

Load GHS data.

stringcalc.tension.load_stringjoy_data(*[, ...])

Load Stringjoy data.

stringcalc.tension.load_worth_data(*[, ...])

Load Worth fluorocarbon data.

String class#

stringcalc.tension.String(L, type, gauge, wound)

Frets#

Fret distance calculations.

For example:

  • compute equal-temperament fret locations for a given scale length

  • compute the scale length implied by a given fret-to-fret distance

Distance#

stringcalc.frets.distance_et(n, *, L)

Exact equal-temperament distance from nut for fret(s) n for scale length L.

stringcalc.frets.distances(N, *, L[, method])

Fret distance DataFrame for N frets and scale length L.

stringcalc.frets.length_from_distance(ab, d)

Calculate the scale length implied by a->b distance d.
Contents