# string-gauges

**Repository Path**: mirrors_jsantell/string-gauges

## Basic Information

- **Project Name**: string-gauges
- **Description**: Data mapping types of guitar strings by gauge to their unit weight
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# string-gauges

Data mapping types of guitar strings by gauge to their unit weight in `pounds per linear inch (lb/in)`.

## Installing

```
$ npm install string-gauges
```

## Usage

The main export contains simple objects containing additional data about that string type, as well as it's gauge data.

```js
const types = require('string-gauges');

console.log(types['daddario-nw']);
/*
{
  "brand": "D'Addario",
  "type: "wound",
  "name": "XL - Nickelplated Steel Round Wound"
  "data": { ... }
}
*/
```

## Gauge Data

The gauge data maps string gauges via diameter in millimeters to the unit weight in pounds per linear inch.

```js
{
  "0.008": 0.0000142401458191,
  "0.0085": 0.00001607510288,
  ...
}
```

## Types

* Kalium Plain (`kalium-plain`)
* Kalium Wound (`kalium-wound`)
* D'Addario Plain Steel Lock Twist (`daddario-pl`)
* D'Addario XL - Nickelplated Steel Round Wound (`daddario-nw`)
* Elixer Electric NANOWEB (`elixer-nanoweb`)
* Elixer Electric POLYWEB (`elixer-polyweb`)
* Elixer Acoustic Phosphor Bronze NANOWEB (`elixer-acoustic-phosphor-nanoweb`)
* Elixer Acoustic 80/20 Bronze NANOWEB (`elixer-acoustic-80-nanoweb`)
* Elixer Acoustic 80/20 Bronze POLYWEB (`elixer-acoustic-80-polyweb`)

## Data Collection

Data is scraped from string manufacturer websites via scripts. To scrape the latest (most likely won't change), run:

`npm run scrape`

Based off of the defintions in `types.json`, a parser from `./parsers` is used, after being passed in the `$` cheerio function, as well as any additional arguments spread via `parserArgs` in the definition.

For sites unscrapable, like D'Addario's PDFs, they live in `./scripts`, to be pasted into developer tools (recommend Firefox to call `copy(results)` afterwards for adding to clipboard.

## Testing

`npm test`

## License

MIT License, Copyright (c) 2016 Jordan Santell