Trigonometry rules to solve equations for angles and sides

calvinmikael

trigonometry-equations

# trigonometry-equations
[![Build Status](https://travis-ci.org/calvinmikael/trigonometry-equations.svg?branch=master)](https://travis-ci.org/calvinmikael/trigonometry-equations)
[![Coverage Status](https://coveralls.io/repos/github/calvinmikael/trigonometry-equations/badge.svg?branch=master)](https://coveralls.io/github/calvinmikael/trigonometry-equations?branch=master)
[![Greenkeeper badge](https://badges.greenkeeper.io/calvinmikael/trigonometry-equations.svg)](https://greenkeeper.io/)

Trigonometry rules to solve equations for angles and sides

## Installation
Run:
```javascript
npm install trigonometry-equations --save
```

## Usage
1. Construct an object mapping angles and sides to their respective objects where the key is a number in the range [0, 3) and the value is the given number.
2. Pass the object to an equation function that corresponds with an appropriate mathematical rule.
3. The function will return an object similar to the input except it will include a key-value pair containing the solution with full numerical precision.

```javascript
import {
  ambiguousCaseRule,
  angleRule,
  cosineRule,
  sineRule
} from 'trigonometry-equations';
// ES5 / CommonJS require works in addition to ES6 import
// var equations = require('trigonometry-equations');
// In ES5 call equations.sineRule, etc
let unsolvedTriangle = {
  angles: { 1: 35, 2: 105 },
  sides: { 1: 7 }
};
console.log(sineRule(unsolvedTriangle));
/*
{
  angles: { 1: 35, 2: 105 },
  sides: { 1: 7, 2: 11.788282006559363 }
}
*/

unsolvedTriangle = {
  angles: { 2: 59 },
  sides: { 0: 3.6, 1: 5.3 }
};
console.log(cosineRule(unsolvedTriangle));
/*
{
  angles: { 2: 59 },
  sides: { 0: 3.6, 1: 5.3, 2: 4.6255969410912074 }
}
*/

/*
cosineRule has an optional parameter
allowing you to specify the angle solved
when you pass it three sides.
If you don't pass in this parameter it will
solve the first unsolved angle of the triangle.
*/
unsolvedTriangle = {
  sides: { 0: 8, 1: 5, 2: 9 }
};
const findAngle = {
  findAngle: 1
};
console.log(cosineRule(unsolvedTriangle, findAngle));
/*
{
  angles: { 1: 33.55730976192071 },
  sides: { 0: 8, 1: 5, 2: 9 }
}
*/

unsolvedTriangle = {
  angles: { 0: 60, 1: 60 },
  sides: { 1: 20 }
};
console.log(angleRule(unsolvedTriangle));
/*
{
  angles: { 0: 60, 1: 60, 2: 60 },
  sides: { 1: 20 }
}
*/

unsolvedTriangle = {
  angles: { 1: 39 },
  sides: { 1: 28, 2: 41 }
};
// if there is no solution ambiguousCaseRule will return null
console.log(ambiguousCaseRule(unsolvedTriangle));
/*
{
ambiguous: {
  angles: { 0: 28.147082985775114, 1: 39, 2: 112.85291701422489 },
  sides: { 0: 20.988713127721486, 1: 28, 2: 41 }
  }
}
*/
```

## Contributing
A new function or a fixed regression should include matching test coverage. Commits should adhere to cz-conventional-changelog which can be done easily by running git cz or npm run commit.

### License
MIT License Copyright (c) 2017 Calvin Mikael


trigonometry-equations

trigonometry-equations

Installation

Usage

Contributing

License

Keywords

FAQs

What is trigonometry-equations?

Is trigonometry-equations popular?

Is trigonometry-equations well maintained?