Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/o-murphy/js-ballistics
ISC library for small arms ballistic calculations based on point-mass (3 DoF) plus spin drift.
https://github.com/o-murphy/js-ballistics
ballistic-calculator ballistics basllistic-solver js nodejs npm
Last synced: about 1 month ago
JSON representation
ISC library for small arms ballistic calculations based on point-mass (3 DoF) plus spin drift.
- Host: GitHub
- URL: https://github.com/o-murphy/js-ballistics
- Owner: o-murphy
- License: isc
- Created: 2023-12-12T20:36:20.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-09-16T13:06:50.000Z (3 months ago)
- Last Synced: 2024-11-08T06:05:48.458Z (about 1 month ago)
- Topics: ballistic-calculator, ballistics, basllistic-solver, js, nodejs, npm
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/js-ballistics
- Size: 191 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# BallisticCalculator
## ISC library for small arms ballistic calculations (JavaScript ES6+)
[![SWUbanner]][SWUdocs]
[SWUbanner]:
https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner-direct-single.svg
[SWUdocs]:
https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md
### Table of contents
* **[Installation](#installation)**
* **[About project](#about-project)**
## Installation
### Via NPM
```shell
npm i js-ballistics@latest
```
### Load dynamically
```html
Your HTML Page
// Link via unpkg.com CDN
import * as JSBallisics from 'https://unpkg.com/js-ballistics@latest';
// Make all exports available globally
Object.assign(window, JSBallisics);
// Create a Measure object (example)
const exampleMeasure = window.UNew.Meter(10);
const exampleMeasureFoot = exampleMeasure.to(window.Unit.Foot);
const exampleValueFoot = exampleMeasure.In(window.Unit.Foot);
// Log the Measure object to the console
console.log('Example Measure in meter:', `${exampleMeasure}`);
console.log('Example Conversion meter to foot:', `${exampleMeasureFoot}`);
console.log('Example Conversion meter to number in foot:', `${exampleValueFoot}`);
```
## About project
The library provides trajectory calculation for projectiles including for various
applications, including air rifles, bows, firearms, artillery and so on.
3DF model that is used in this calculator is rooted in old C sources of version 2 of the public version of JBM
calculator, ported to C#, optimized, fixed and extended with elements described in
Litz's "Applied Ballistics" book and from the friendly project of Alexandre Trofimov
and then ported to Go.
Now it's also ported to python3 and expanded to support calculation trajectory by
multiple ballistics coefficients and using custom drag data (such as Doppler radar data ©Lapua, etc.)
Next stage is porting it to JavaScript
**[The online version of Go documentation is located here](https://godoc.org/github.com/gehtsoft-usa/go_ballisticcalc)**
**[C# version of the package is located here](https://github.com/gehtsoft-usa/BallisticCalculator1)**
**[The online version of C# API documentation is located here](https://gehtsoft-usa.github.io/BallisticCalculator/web-content.html)**
**[The online version of Python module is located here](https://github.com/o-murphy/py_ballisticcalc)**
Go documentation can be obtained using godoc tool.
The current status of the project is ALPHA version.
#### RISK NOTICE
The library performs very limited simulation of a complex physical process and so it performs a lot of approximations. Therefore, the calculation results MUST NOT be considered as completely and reliably reflecting actual behavior or characteristics of projectiles. While these results may be used for educational purpose, they must NOT be considered as reliable for the areas where incorrect calculation may cause making a wrong decision, financial harm, or can put a human life at risk.
THE CODE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS.