Package: py-ballisticcalc.exts
BallisticCalculatorLGPL library for small arms ballistic calculations (Python 3.9+)Table of contentsInstallationLatest stableFrom sourcesClone and buildUsageUnits of measureAn example of calculationsOutput exampleOlder versionsv1.0.xContributorsAbout projectInstallationLatest stable release from pypi**pipinstallpy-ballisticcalcInstalling from sourcesMSVCorGCCrequiredDownload and installMSVCorGCCdepending on target platformUse one of the references you need:# no binary from PyPipipinstallpy-ballisticcalc==<version>--no-binarypy-ballisticcalc# master brunchpipinstallgit+https://github.com/o-murphy/py_ballisticcalc# specific branchpipinstallgit+https://github.com/o-murphy/py_ballisticcalc.git@<target_branch_name>Clone and buildMSVCorGCCrequiredgitclonehttps://github.com/o-murphy/py_ballisticcalccdpy_ballisticcalc
python-mvenvvenv
.venv/bin/activate
pipinstallcython
pythonsetup.pybuild_ext--inplaceUsageThe library supports all the popular units of measurement, and adds different built-in methods to define and manipulate itUnit manipulation syntax:frompy_ballisticcalc.unitimport*# ways to define value in units# 1. old syntaxunit_in_meter=Distance(100,Distance.Meter)# 2. short syntax by Unit type classunit_in_meter=Distance.Meter(100)# 3. by Unit enum classunit_in_meter=Unit.METER(100)# >>> <Distance>: 100.0 m (3937.0078740157483)# convert unit# 1. by methodunit_in_yard=unit_in_meter.convert(Distance.Yard)# 2. using shift syntaxunit_in_yards=unit_in_meter<<Distance.Yard# '<<=' operator also supports# >>> <Distance>: 109.36132983377078 yd (3937.0078740157483)# get value in specified units# 1. by methodvalue_in_km=unit_in_yards.get_in(Distance.Kilometer)# 2. by shift syntaxvalue_in_km=unit_in_yards>>Distance.Kilometer# '>>=' operator also supports# >>> 0.1# getting unit raw value:rvalue=Distance.Meter(10).raw_valuervalue=float(Distance.Meter(10))# units comparison:# supports operators like < > <= >= == !=Distance.Meter(100)==Distance.Centimeter(100)# >>> False, compare two units by raw valueDistance.Meter(100)>10# >>> True, compare unit with float by raw valueAn example of calculationsfrompy_ballisticcalcimportVelocity,Temperature,Distancefrompy_ballisticcalcimportDragModel,TableG7frompy_ballisticcalcimportAmmo,Atmo,Windfrompy_ballisticcalcimportWeapon,Shot,Calculatorfrompy_ballisticcalcimportSettingsasSet# set global library settingsSet.Units.velocity=Velocity.FPSSet.Units.temperature=Temperature.Celsius# Set.Units.distance = Distance.MeterSet.Units.sight_height=Distance.CentimeterSet.set_max_calc_step_size(Distance.Foot(1))Set.USE_POWDER_SENSITIVITY=True# enable muzzle velocity correction my powder temperature# define params with default unitsweight,diameter=168,0.308# or define with specified unitslength=Distance.Inch(1.282)# length = Distance(1.282, Distance.Inch)weapon=Weapon(9,100,2)dm=DragModel(0.223,TableG7,weight,diameter)ammo=Ammo(dm,length,2750,15)ammo.calc_powder_sens(2723,0)zero_atmo=Atmo.icao(100)# defining calculator instancecalc=Calculator(weapon,ammo,zero_atmo)current_atmo=Atmo(110,1000,15,72)current_winds=[Wind(2,90)]shot=Shot(1500,atmo=current_atmo,winds=current_winds)shot_result=calc.fire(shot,trajectory_step=Distance.Yard(100))forpinshot_result:print(p.formatted())Example of the formatted output:python-mpy_ballisticcalc.example['0.00 s', '0.000 m', '2750.0 ft/s', '2.46 mach', '-9.000 cm', '0.00 mil', '0.000 cm', '0.00 mil', '3825 J']
['0.12 s', '100.000 m', '2528.6 ft/s', '2.26 mach', '0.005 cm', '0.00 mil', '-3.556 cm', '-0.36 mil', '3233 J']
['0.26 s', '200.050 m', '2317.2 ft/s', '2.08 mach', '-7.558 cm', '-0.38 mil', '-13.602 cm', '-0.69 mil', '2715 J']
['0.41 s', '300.050 m', '2116.6 ft/s', '1.90 mach', '-34.843 cm', '-1.18 mil', '-30.956 cm', '-1.05 mil', '2266 J']
['0.57 s', '400.000 m', '1926.5 ft/s', '1.73 mach', '-85.739 cm', '-2.18 mil', '-57.098 cm', '-1.45 mil', '1877 J']
['0.75 s', '500.000 m', '1745.0 ft/s', '1.56 mach', '-165.209 cm', '-3.37 mil', '-94.112 cm', '-1.92 mil', '1540 J']
['0.95 s', '600.000 m', '1571.4 ft/s', '1.41 mach', '-279.503 cm', '-4.74 mil', '-144.759 cm', '-2.46 mil', '1249 J']ContributorsThis project exists thanks to all the people who contribute.Special thanks to:David Bookstaber- Ballistics Expert, Financial EngineerFor the help in understanding and improvement of some calculation methodsNikolay GekhtFor the sources code on C# and GO-lang from which this project firstly was forked fromAbout projectThe 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.)The online version of Go documentation is located here:https://godoc.org/github.com/gehtsoft-usa/go_ballisticcalcC# version of the package is located here:https://github.com/gehtsoft-usa/BallisticCalculator1The online version of C# API documentation is located here:https://gehtsoft-usa.github.io/BallisticCalculator/web-content.htmlGo documentation can be obtained using godoc tool.The current status of the project is ALPHA version.RISK NOTICEThe 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.