193 lines
7.9 KiB
JSON
193 lines
7.9 KiB
JSON
{
|
||
"_description": "Ballistic Properties Configuration File",
|
||
"_notes": "This file defines the physical and ballistic characteristics of a projectile. All measurements use imperial units (inches, grains, fps) as is standard in ballistics research. 1 grain = 0.0647989 grams.",
|
||
"_example": "5.56x45mm NATO M193 Ball - Standard military rifle cartridge",
|
||
|
||
"GrainWeight": {
|
||
"_description": "Mass of the projectile in grains (ballistics standard unit)",
|
||
"_unit": "grains (gr)",
|
||
"_conversion": "1 grain = 0.0647989 grams = 0.000142857 pounds",
|
||
"_typical_range": "20-1000 grains depending on caliber",
|
||
"_examples": {
|
||
"22_LR": "40 grains",
|
||
"9mm": "115-147 grains",
|
||
"5.56mm": "55-77 grains",
|
||
"7.62mm": "147-175 grains",
|
||
"50_BMG": "647-750 grains"
|
||
},
|
||
"value": 55.0
|
||
},
|
||
|
||
"DiameterInches": {
|
||
"_description": "Bullet diameter measured across the widest point",
|
||
"_unit": "inches",
|
||
"_conversion": "1 inch = 25.4 millimeters",
|
||
"_note": "This is the actual bullet diameter, not the cartridge designation",
|
||
"_examples": {
|
||
"22_caliber": "0.224 inches (5.56mm)",
|
||
"30_caliber": "0.308 inches (7.62mm)",
|
||
"9mm": "0.355 inches",
|
||
"45_ACP": "0.452 inches",
|
||
"50_BMG": "0.510 inches"
|
||
},
|
||
"value": 0.224
|
||
},
|
||
|
||
"LengthInches": {
|
||
"_description": "Overall length of the bullet from base to tip",
|
||
"_unit": "inches",
|
||
"_note": "Longer bullets generally have higher ballistic coefficients but require faster rifling twist rates",
|
||
"_typical_range": "0.4-2.0 inches depending on caliber and design",
|
||
"value": 0.825
|
||
},
|
||
|
||
"BulletType": {
|
||
"_description": "Construction and intended purpose of the bullet",
|
||
"_options": {
|
||
"0": "Full Metal Jacket (FMJ) - Lead core with copper/brass jacket, military standard",
|
||
"1": "Hollow Point (HP) - Designed to expand on impact, hunting/self-defense",
|
||
"2": "Soft Point (SP) - Exposed lead tip for controlled expansion, hunting",
|
||
"3": "Armor Piercing (AP) - Hardened core for penetrating armor",
|
||
"4": "Armor Piercing Incendiary (API) - AP with incendiary compound",
|
||
"5": "Tracer - Contains pyrotechnic compound for visible trajectory",
|
||
"6": "Match Grade - Precision manufactured for competitive shooting",
|
||
"7": "Frangible - Designed to disintegrate on impact with hard surfaces",
|
||
"8": "Lead Round Nose (LRN) - Basic lead bullet design",
|
||
"9": "Wadcutter (WC) - Flat-nosed design for paper target cutting",
|
||
"10": "Semi-Wadcutter (SWC) - Compromise between wadcutter and round nose",
|
||
"11": "Custom - User-defined characteristics"
|
||
},
|
||
"value": 0
|
||
},
|
||
|
||
"BulletMaterial": {
|
||
"_description": "Primary material composition affecting hardness and penetration",
|
||
"_options": {
|
||
"0": "Lead - Soft, traditional material (BHN ~5-12)",
|
||
"1": "Lead-Antimony - Hardened lead alloy (BHN ~12-18)",
|
||
"2": "Copper - Pure copper construction (BHN ~35-45)",
|
||
"3": "Copper Jacket - Lead core with copper jacket (most common)",
|
||
"4": "Brass - Brass construction (BHN ~60-80)",
|
||
"5": "Steel - Steel core or construction (BHN ~150-300)",
|
||
"6": "Tungsten - Dense, hard material (BHN ~300-400)",
|
||
"7": "Bismuth - Lead-free alternative (BHN ~7-12)",
|
||
"8": "Zinc - Zinc alloy construction (BHN ~80-120)",
|
||
"9": "Custom - User-defined material properties"
|
||
},
|
||
"_note": "BHN = Brinell Hardness Number",
|
||
"value": 3
|
||
},
|
||
|
||
"BallisticCoefficientG1": {
|
||
"_description": "Aerodynamic efficiency compared to G1 standard projectile",
|
||
"_explanation": "Higher values indicate better aerodynamic performance and less velocity loss over distance",
|
||
"_unit": "dimensionless ratio",
|
||
"_typical_range": "0.1-1.0+ (most bullets 0.2-0.7)",
|
||
"_examples": {
|
||
"poor_aerodynamics": "0.15-0.25 (round nose, flat base)",
|
||
"average": "0.25-0.45 (typical spitzer bullets)",
|
||
"good": "0.45-0.65 (boat tail, optimized design)",
|
||
"excellent": "0.65+ (VLD, match bullets)"
|
||
},
|
||
"_reference": "G1 standard: 1 lb, 1 inch diameter, flat base bullet",
|
||
"value": 0.151
|
||
},
|
||
|
||
"BallisticCoefficientG7": {
|
||
"_description": "Aerodynamic efficiency compared to G7 standard projectile",
|
||
"_explanation": "More accurate for modern boat-tail spitzer bullets than G1",
|
||
"_unit": "dimensionless ratio",
|
||
"_note": "G7 model better represents modern bullet shapes, typically 0.5-0.7x the G1 value",
|
||
"_reference": "G7 standard: boat-tail spitzer design",
|
||
"value": 0.076
|
||
},
|
||
|
||
"UseG7Model": {
|
||
"_description": "Whether to use G7 or G1 ballistic coefficient model",
|
||
"_explanation": "G7 is more accurate for modern pointed bullets, G1 is traditional standard",
|
||
"_recommendation": "Use G7 for boat-tail spitzer bullets, G1 for round nose or flat base",
|
||
"value": false
|
||
},
|
||
|
||
"SectionalDensity": {
|
||
"_description": "Ratio of bullet mass to cross-sectional area",
|
||
"_formula": "SD = Weight(grains) / (7000 × Diameter²(inches))",
|
||
"_unit": "dimensionless ratio",
|
||
"_significance": "Higher SD indicates better penetration potential",
|
||
"_typical_ranges": {
|
||
"light": "0.15-0.20 (varmint bullets)",
|
||
"medium": "0.20-0.25 (general purpose)",
|
||
"heavy": "0.25-0.35 (hunting, long range)",
|
||
"very_heavy": "0.35+ (dangerous game, extreme penetration)"
|
||
},
|
||
"_note": "Set to 0.0 for automatic calculation from weight and diameter",
|
||
"value": 0.0
|
||
},
|
||
|
||
"BulletHardness": {
|
||
"_description": "Material hardness of the bullet",
|
||
"_unit": "Brinell Hardness Number (HB or BHN)",
|
||
"_measurement": "Standard 10mm steel ball, 3000kg load, 30 second duration",
|
||
"_typical_values": {
|
||
"pure_lead": "5-8 BHN",
|
||
"wheel_weight_alloy": "12-15 BHN",
|
||
"linotype_alloy": "22-25 BHN",
|
||
"copper_plated": "8-12 BHN",
|
||
"copper_jacket": "15-20 BHN (considers jacket)",
|
||
"mild_steel_core": "150-200 BHN",
|
||
"hardened_steel": "300-600 BHN"
|
||
},
|
||
"_penetration_effect": "Harder bullets penetrate better but may not expand",
|
||
"value": 15.0
|
||
},
|
||
|
||
"PenetrationEnergyThreshold": {
|
||
"_description": "Minimum kinetic energy required for the bullet to penetrate materials",
|
||
"_unit": "foot-pounds (ft-lbs)",
|
||
"_conversion": "1 ft-lb = 1.35582 Joules",
|
||
"_explanation": "Below this energy, bullet will not penetrate and may bounce off",
|
||
"_typical_values": {
|
||
"small_game": "10-25 ft-lbs",
|
||
"medium_game": "25-80 ft-lbs",
|
||
"large_game": "80-200 ft-lbs",
|
||
"dangerous_game": "200+ ft-lbs",
|
||
"armor_piercing": "500+ ft-lbs"
|
||
},
|
||
"_factors": "Depends on bullet construction, target material, and impact angle",
|
||
"value": 58.0
|
||
},
|
||
|
||
"ExpansionVelocityThreshold": {
|
||
"_description": "Minimum impact velocity required for bullet expansion",
|
||
"_unit": "feet per second (fps)",
|
||
"_conversion": "1 fps = 0.3048 meters per second",
|
||
"_explanation": "Below this velocity, expanding bullets (HP, SP) will not expand reliably",
|
||
"_typical_values": {
|
||
"handgun_bullets": "800-1200 fps",
|
||
"rifle_bullets": "1600-2200 fps",
|
||
"premium_hunting": "1400-1800 fps",
|
||
"varmint_bullets": "2000-2800 fps"
|
||
},
|
||
"_note": "Only applies to expanding bullet types (HP, SP, etc.)",
|
||
"value": 1800.0
|
||
},
|
||
|
||
"MaxExpansionMultiplier": {
|
||
"_description": "Maximum diameter increase when bullet expands",
|
||
"_unit": "ratio (expanded diameter / original diameter)",
|
||
"_explanation": "How much the bullet can expand from its original diameter",
|
||
"_typical_values": {
|
||
"controlled_expansion": "1.3-1.6x (premium hunting)",
|
||
"moderate_expansion": "1.6-2.0x (standard hunting)",
|
||
"maximum_expansion": "2.0-2.5x (self-defense)",
|
||
"fragmenting": "2.5x+ (varmint bullets)"
|
||
},
|
||
"_examples": {
|
||
"9mm_hollow_point": "1.5-1.8x (0.355\" to ~0.64\")",
|
||
"30-06_hunting": "1.4-1.7x (0.308\" to ~0.52\")",
|
||
"22-250_varmint": "2.0-3.0x (0.224\" to ~0.67\")"
|
||
},
|
||
"_note": "Only applies to expanding bullet types",
|
||
"value": 1.5
|
||
}
|
||
} |