View source for Template:Infobox firearm cartridge/doc

{{#ifeq:{{{noheader|}}}|yes || {{Documentation subpage}}

==Usage==
}}

=== Firearm cartridge infobox ===
A firearm cartridge infobox may be used to summarize information about a particular [[Cartridge (firearms)|cartridge]] or [[Shell (projectile)|artillery shell]].  The infobox should be added using the {{Tlx|Infobox firearm cartridge}} template, as shown below:

{{Parameter names example | name | image | image_size | alt | caption | type | origin | service | used_by | wars | designer | design_date | manufacturer | production_date | number | variants | parent | case_type | bullet | land | neck | shoulder | base | rim_dia | rim_thick | case_length | length | rifling | primer | filling | filling_weight | detonation | yield | is_SI_specs | bullet_ref | neck_ref | shoulder_ref | base_ref | rim_dia_ref | rim_thick_ref | case_length_ref | length_ref | case_capacity | case_capacity_ref | pressure_method | max_pressure | max_pressure_ref | pressure_method2 | max_pressure2 | max_pressure2_ref | pressure_method3 | max_pressure3 | max_pressure3_ref | max_cup | max_cup_ref | bw1 | bw2 | bw3 | bw4 | bw5 | is_SI_ballistics | bwunit | bwround | btype1 | vel1 | en1 | test_barrel_length | balsrc | btype2 | vel2 | en2 | btype3 | vel3 | en3 | btype4 | vel4 | en4 | btype5 | vel5 | en5 }}

<pre style="overflow:auto; white-space:pre;">
{{Infobox firearm cartridge
| name = 
| image = 
| alt = 
| caption = 
| type = 
| origin = 
<!-- Service history -->
| service = 
| used_by = 
| wars = 
<!-- Production history -->
| designer = 
| design_date = 
| manufacturer = 
| production_date = 
| number = 
| variants = 
<!-- Specifications -->
| is_SI_specs = 
| parent = 
| case_type = 
| bullet = 
| bullet_ref = 
| land = 
| land_ref = 
| neck = 
| neck_ref = 
| shoulder = 
| shoulder_ref = 
| base = 
| base_ref = 
| rim_dia = 
| rim_dia_ref = 
| rim_thick = 
| rim_thick_ref = 
| case_length = 
| case_length_ref = 
| length = 
| length_ref = 
| case_capacity = 
| case_capacity_ref = 
| rifling = 
| primer = 
| max_pressure = 
| max_pressure_ref = 
| pressure_method = 
| max_pressure2 = 
| max_pressure2_ref = 
| pressure_method2 = 
| max_pressure3 = 
| max_pressure3_ref = 
| pressure_method3 = 
| max_cup = 
| max_cup_ref = 
| filling = 
| filling_weight = 
| detonation = 
| yield = 
<!-- Ballistic performance -->
| is_SI_ballistics = 
| bwunit = 
| bw1 = 
| btype1 = 
| vel1 = 
| en1 = 
| bw2 = 
| btype2 = 
| vel2 = 
| en2 = 
| bw3 = 
| btype3 = 
| vel3 = 
| en3 = 
| bw4 = 
| btype4 = 
| vel4 = 
| en4 = 
| bw5 = 
| btype5 = 
| vel5 = 
| en5 = 
| test_barrel_length = 
| balsrc = 
}}
</pre>
{{clear}}

=== Parameters ===
'''Note''': When using parameters, avoid the ambiguous abbreviation "N/A", and instead use "unknown" or "none". All subjective or qualitative judgements and numerical quantities or statistics must be cited to a reliable source (see [[WP:MILMOS#CITE]]).  References for numerically converted parameters (e.g., {{para|bullet}}) can be appended using the corresponding <code>ref</code> parameter (e.g., {{para|bullet_ref}}).  Sources for the ballistic performance table, and more general sources, can be included using the {{para|balsrc}} parameter.

General parameters:
* '''name''' – the formal name of the cartridge.
* '''image''' – ''optional'' – an image of the cartridge, should be given in the form <code>Example.jpg</code>.
* '''image_size''' – ''optional'' – width of image, should be given in the form <code>300px</code>.
* '''alt''' – ''optional'' – alternative text describing the image for visually impaired users, see [[WP:ALT]].
* '''caption''' – ''optional'' – the text to be placed below the image.
* '''type''' – the type of cartridge or its designed use (e.g. "[[Pistol]]", "[[Rifle]]", "Hunting", etc.).
* '''origin''' – the country or place where the cartridgeoriginated or was first manufactured.

Service history parameters:
* '''service''' – ''optional'' – the period (usually given in years) when the cartridge was in service.
* '''used_by''' – ''optional'' – the countries, armed forces, or other groups using the cartridge; this may be omitted for cartridges employed only in their country of origin.
* '''wars''' – ''optional'' – any wars during which the cartridge saw service.

Production history parameters:
* '''designer''' – ''optional'' – the person or group responsible for designing the cartridge.
* '''design_date''' – ''optional'' – the date (usually given as a year) when the cartridge was designed.
* '''manufacturer''' – ''optional'' – the manufacturer of the cartridge.
* '''production_date''' – ''optional'' – the period (usually given in years) when the cartridge was produced.
* '''number''' – ''optional'' – the number of cartridge of this type that were manufactured.
* '''variants''' – ''optional'' – any variant models of the cartridge.

Specification parameters:
* '''is_SI_specs''' – ''optional'' – "''yes''" if the specifications are entered in [[International System of Units|SI units]]; any other value causes it to be interpreted as [[English unit]]s.
* '''parent''' – ''optional'' – the cartridge that the cartridge was based on, if any.
* '''case_type''' – ''optional'' – the type of case used for the cartridge (e.g. rimmed, rimless, straight, bottlenecked, etc.).
* '''bullet''' – ''optional'' – the diameter of the bullet used in the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
* '''land''' – ''optional'' – the land diameter of the rifling in the barrel, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
* '''neck''' – ''optional'' – the neck diameter of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
* '''shoulder''' – ''optional'' – the shoulder diameter of the cartridge, if any, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
* '''base''' – ''optional'' – the base diameter of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
* '''rim_dia''' – ''optional'' – the rim diamter of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
* '''rim_thick''' – ''optional'' – the rim thickness of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
* '''case_length''' – ''optional'' – the case length of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
* '''length''' – ''optional'' – the overall length of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
* '''case_capacity''' – ''optional'' – the volume of the casing, expressed in cm<sup>3</sup> or [[Grain (measure)|grains of water]]; only include the number, and not the units of measurement, and omit any commas.
* '''rifling''' – ''optional'' – typical [[rifling]] to stabilize the bullet fired from the cartridge.
* '''primer''' – ''optional'' – the type of primer used in the cartridge (e.g. large pistol, small rifle, rimfire, etc.).
* '''max_pressure''' – ''optional'' – the maximum chamber pressure of the round, expressed in MPa or psi; only include the number, and not the units of measurement, and omit any commas.
* '''pressure_method''' – ''optional'' – the methodology used to measure pressure, such as SAAMI, CIP, EPVAT, SCATP.
* '''max_pressure2''' – ''optional'' as above, second pressure with method
* '''pressure_method2''' – ''optional'' as above, second pressure's method
* '''max_pressure3''' – ''optional'' as above, third pressure with method
* '''pressure_method2''' – ''optional'' as above, third pressure's method
* '''max_cup''' – ''optional'' – the maximum chamber pressure of the round, expressed in [[Copper units of pressure|CUP]]; only include the number, and not the units of measurement, and omit any commas.  Note that this parameter is not affected by the ''is_SI_specs'' parameter.
* '''filling''' – ''optional'' – the explosive filling material of the shell, if any.
* '''filling_weight''' – ''optional'' – the weight of the explosive material of the shell, if any.
* '''detonation''' – ''optional'' – for explosive shells, the detonation trigger type (e.g. "timer", "pressure", "motion sensor").
* '''yield''' – ''optional'' – for explosive shells, the yield (in tons of [[trinitrotoluene|TNT]]) of the device.

Ballistic performance parameters:

Ballistic data for up to five different weight bullets can be specified; it may be provided in either SI or English units, but this choice must be consistent for all five sets.  The ''x'' in the field name should be replaced with 1–5 as displayed in the template format shown above (e.g. ''bw1, bw2, btype1, btype2, vel1, vel2, en1, en2'', etc.):
* '''is_SI_ballistics''' – ''optional'' – "''yes''" if the energy and velocity ballistics data is entered in [[International System of Units|SI units]]; any other value causes it to be interpreted as [[English unit]]s.
* '''bwunit''' – ''optional'' – "''gram''" if the weights are given in grams; any other value causes them to be interpreted as [[Grain (mass)|grains]].
* '''bwround''' – ''optional'' – specify the number of digits after the decimal point in the converted weight (the default is 0 if not specified; if specified but empty, defaults to the same default as convert).
* '''bw'''''x'' – ''optional'' – the weight of the bullet for given data, expressed in grams or [[Grain (mass)|grains]]; only include the number, and not the units of measurement.
** '''btype'''''x'' – ''optional'' – the type of bullet (e.g. ''JHP, FMJ, BHP'', etc.).
** '''vel'''''x'' – ''required if bw field is specified'' – velocity of the bullet at the muzzle, expressed in m/s or ft/s; only include the number, and not the units of measurement, and omit any commas.
** '''en'''''x'' – ''required if bw field is specified'' – energy of the bullet at the muzzle, expressed in J or ft·lbf; only include the number, and not the units of measurement, and omit any commas.
* '''test_barrel_length''' – ''optional'' – the length of the barrel used when generating the ballistics data.
* '''balsrc''' – ''optional'' – the source from which the ballistics data was obtained.
{{#ifeq:{{{noheader|}}}|yes ||

=== Example ===
{{Infobox firearm cartridge
| name = .357 SIG
| image = 9mm 7,62mm 357sig 10mm 45SW 45GAP 50AE 002.jpg
| image_size = 300px
| caption = Comparison to other cartridges.  .357 SIG third from left.
| type = Pistol
| origin = [[United States]]
| designer = [[SIGARMS]]/[[Federal Cartridge Company|Federal Cartridge Co.]]
| design_date = 1994
| parent = 
| case_type = Rimless, bottleneck
| bullet = .355
| land = .343
| neck = .381
| shoulder = .424
| base = .424
| rim_dia = .424
| rim_thick = .055
| case_length = .865
| length = 1.14
| rifling = 
| primer = Small pistol
| bw1 = 115
| btype1 = [[Hollow point bullet|BHP]]
| vel1 = 1564
| en1 = 624
| bw2 = 124
| btype2 = [[Hollow point bullet|JHP]]
| vel2 = 1329
| en2 = 486
| bw3 = 125
| btype3 = JHP
| vel3 = 1299
| en3 = 468
| bw4 = 147
| btype4 = JHP
| vel4 = 1186
| en4 = 459
| bw5 = 150
| btype5 = JHP
| vel5 = 1130
| en5 = 425
| test_barrel_length = 4 in
| balsrc = [http://stevespages.com/page8f357sig.html Steve's 357 SIG Ballistic Page]
}}

<pre style="overflow:auto; white-space:pre;">
{{Infobox firearm cartridge
| name = .357 SIG
| image = 9mm 7,62mm 357sig 10mm 45SW 45GAP 50AE 002.jpg
| image_size = 300px
| caption = Comparison to other cartridges.  .357 SIG third from left.
| type = Pistol
| origin = [[United States]]
| designer = [[SIGARMS]]/[[Federal Cartridge Company|Federal Cartridge Co.]]
| design_date = 1994
| parent = 
| case_type = Rimless, bottleneck
| bullet = .355
| land = .343
| neck = .381
| shoulder = .424
| base = .424
| rim_dia = .424
| rim_thick = .055
| case_length = .865
| length = 1.14
| rifling = 
| primer = Small pistol
| bw1 = 115
| btype1 = [[Hollow point bullet|BHP]]
| vel1 = 1564
| en1 = 624
| bw2 = 124
| btype2 = [[Hollow point bullet|JHP]]
| vel2 = 1329
| en2 = 486
| bw3 = 125
| btype3 = JHP
| vel3 = 1299
| en3 = 468
| bw4 = 147
| btype4 = JHP
| vel4 = 1186
| en4 = 459
| bw5 = 150
| btype5 = JHP
| vel5 = 1130
| en5 = 425
| test_barrel_length = 4 in
| balsrc = [http://stevespages.com/page8f357sig.html Steve's 357 SIG Ballistic Page]
}}
</pre>
{{clear}}

== Microformat ==
{{UF-hprod}}

}}<noinclude>
[[Category:WikiProject Military history template instructions|Firearm Cartridge]]
</noinclude><includeonly>{{Sandbox other||

{{#ifeq:{{{noheader|}}}|yes||
[[Category:Weapon infobox templates|Firearm Cartridge]]
}}
}}</includeonly>