ballistics-engine 0.13.32

High-performance ballistics trajectory engine with professional physics
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

# Online Service Terms and Privacy

This document describes the terms of use and privacy practices for the `--online` feature of the ballistics-engine CLI.

## Overview

The ballistics-engine includes an optional `--online` flag that sends trajectory calculations to a cloud-based API for ML-enhanced predictions. **This feature is entirely optional** - all core functionality works locally without any network communication.

## Open Source vs. Proprietary

| Component | License | Network Required |
|-----------|---------|------------------|
| ballistics-engine library | MIT (Open Source) | No |
| CLI tool | MIT (Open Source) | No |
| Local physics solver | MIT (Open Source) | No |
| FFI bindings | MIT (Open Source) | No |
| BC5D table downloader | MIT (Open Source) | First download only |
| **BC5D table data files** | **Free to use** | **First download only** |
| **Online API service** | **Proprietary** | **Yes** |
| **ML models** | **Proprietary** | **Yes** |

The online service (API, ML models, cloud infrastructure) is **proprietary software** and is not covered by the MIT license. The source code for the online service will not be made available.

BC5D table data files are free to download and use, but the ML models used to generate them are proprietary. Once downloaded, tables work fully offline.

## Data Collection

### BC5D Table Downloads (--bc-table-auto flag)

When you use `--bc-table-auto`, BC5D correction tables are downloaded from `ballistics.tools`:

**Data transmitted:**
- HTTP GET requests for manifest.json and caliber-specific .bin files
- Your IP address (standard HTTP request)
- No trajectory parameters or personal data

**Data stored locally:**
- Downloaded tables are cached in platform-specific directories
- macOS: `~/Library/Caches/ballistics-engine/bc5d/`
- Linux: `~/.cache/ballistics-engine/bc5d/`
- Windows: `%LOCALAPPDATA%\ballistics-engine\cache\bc5d\`

Tables are static files (~1-1.5 MB each) and are not personalized. Once cached, subsequent calculations use local files without network access.

### Online API (--online flag)

When you use the `--online` flag, the following data is transmitted to `api.ballistics.7.62x51mm.sh`:

### Trajectory Parameters
- Ballistic coefficient (value and type: G1, G7, etc.)
- Bullet specifications (mass, diameter)
- Muzzle velocity and target distance
- Zero distance and shooting angle
- Wind conditions (speed, direction)
- Atmospheric conditions (temperature, pressure, humidity, altitude)
- Geographic coordinates (latitude, longitude) if provided
- Weather model settings (wind shear model, weather zones)

### Technical Data
- Your IP address
- Client version (e.g., `ballistics-cli/0.13.29`)
- Request timestamp
- Response status and latency

## Data Usage

Your data is used **solely for service delivery**:
- Processing your trajectory calculation request
- Returning results to your client
- Maintaining operational logs for debugging

**We do NOT:**
- Use your data to train or improve ML models
- Share your data with third parties
- Use your data for marketing or advertising
- Build user profiles from your requests

## Data Retention

- Request logs are retained for **30 days**
- Logs are automatically deleted after 30 days by Google Cloud Platform
- We do not maintain any permanent database of trajectory calculations

## Data Location

The online service is hosted on Google Cloud Platform (Cloud Run) in the United States. All data is transmitted over HTTPS.

## Opting Out

To use ballistics-engine without any network communication:

### Option 1: Don't use online flags
Simply omit `--online` and `--bc-table-auto`. All local calculations work without network access.

```bash
# Local calculation (no network)
ballistics trajectory -v 2700 -b 0.475 -m 168 -d 0.308 --max-range 1000

# Online calculation (sends data to API)
ballistics trajectory -v 2700 -b 0.475 -m 168 -d 0.308 --max-range 1000 --online

# BC5D with auto-download (downloads tables once)
ballistics trajectory -v 2700 -b 0.475 -m 168 -d 0.308 --bc-table-auto
```

### Option 2: Use pre-downloaded BC5D tables
Download BC5D tables once, then use `--bc-table-dir` for fully offline operation:

```bash
# Download tables manually (one-time)
curl -O https://ballistics.tools/downloads/bc5d/bc5d_308.bin

# Use local tables (no network)
ballistics trajectory -v 2700 -b 0.475 -m 168 -d 0.308 --bc-table-dir ./bc_tables/
```

### Option 3: Build without online feature
```bash
cargo install ballistics-engine --no-default-features
```

This removes `--online`, `--bc-table-auto`, `--bc-table-url`, and `--bc-table-refresh` flags entirely from the CLI.

## No Warranty

The online service is provided "AS IS" without warranty of any kind. Ballistics calculations are for informational purposes only. You are solely responsible for verifying calculations and for the safe and legal use of firearms.

## Service Availability

We reserve the right to modify, suspend, or discontinue the online service at any time. The open source CLI will continue to function for local calculations regardless of online service status.

## Contact

For questions about the online service:
- Email: email@tinycomputers.io
- Website: https://tinycomputers.io
- Full terms: https://ballistics.rs/terms.html
- Full privacy policy: https://ballistics.rs/privacy.html