Feldreferenz

78 Felder

Verschachtelte Objekte

Die Objekte, die ein Detaildatensatz unter calibers, images, users, schematics und provenance einbettet. Provenance tragen auch eine Patrone und ein Anbauteil; die Bedeutung steht unter Datenkonfidenz weiter unten.

Produktionsstatus-Werte

Was status an einem Datensatz enthalten kann.

• in_productionCurrently manufactured
• discontinuedNo longer manufactured
• out_of_productionProduction has ended; may return
• in_serviceOut of production but still in active service
• limited_productionProduced in limited numbers
• prototypePrototype, never mass-produced

Alle sechs akzeptiert ?status= auf GET /v1/firearms.

Verschlussarten

Das actionType-Vokabular, wie es im Katalog vorkommt, häufigste zuerst. Keine geschlossene Liste: GET /v1/firearms/action-types liefert jeden verwendeten Wert mit Anzahl.

• short_recoilBarrel and slide recoil locked together, then unlock (most semi-auto pistols)
• bolt_actionManually cycled rotating bolt
• blowbackBolt held only by spring and mass, no locking (smaller cartridges)
• break_actionBarrels hinge open to load
• gas_operatedGas-operated, pattern not further specified
• gas_operated_long_strokeGas piston fixed to the carrier, travels its full length (e.g. AK)
• gas_operated_direct_impingementGas vented straight onto the bolt carrier (e.g. AR-15)
• revolvingCylinder indexes a fresh chamber behind the barrel
• gas_operated_short_strokeGas piston travels a short distance to drive the carrier
• muzzleloaderLoaded from the muzzle; no cartridge
• pump_actionManually cycled by sliding the forend
• lever_actionManually cycled by a finger lever
• double_actionTrigger both cocks and releases the hammer or striker
• falling_blockBreechblock drops vertically to expose the chamber
• roller_delayed_blowbackRollers delay bolt opening (e.g. MP5, G3)
• single_actionHammer or striker cocked before the trigger will fire
• gas_operated_short_stroke_pistonShort-stroke piston, the piston named explicitly in the source
• single_action_revolverRevolver; hammer manually cocked before each shot
• double_action_revolverRevolver; trigger cocks and releases the hammer
• inertia_operatedRecoil inertia of the bolt body unlocks the action (some shotguns)
• recoil_operatedRecoil-operated, pattern not further specified
• delayed_blowbackBlowback with a mechanical delay other than rollers
• long_recoilBarrel and bolt recoil the full stroke together (e.g. Auto-5)
• gas_operated_rotating_boltGas-operated with a rotating bolt lock
• breech_loadingLoaded at the breech; single-shot, mechanism not further specified
• rolling_blockBreechblock rotates back to open (single-shot)
• straight_pullBolt cycled with a straight pull, no rotation of the handle
• trapdoorHinged breechblock lifts forward to load (e.g. Springfield 1873)
• spring_pistonAir gun; a spring-driven piston compresses the charge
• hinged_breechblockBreechblock hinges away from the chamber to load
• lever_delayed_blowbackA lever delays bolt opening (e.g. FAMAS)
• blow_forwardBarrel driven forward off the standing breech
• electric_gatlingExternally powered rotary barrels
• double_action_onlyTrigger always cocks and releases; no single-action mode
• rotating_barrelBarrel rotates to unlock from the slide
• pneumaticAir gun; pre-charged or pumped air
• gas_operated_dual_modeGas system switchable between two modes
• delayed_blowback_rotating_barrelBlowback delayed by a rotating barrel rather than by rollers
• gas_delayed_blowbackBlowback delayed by gas pressure bled against the bolt
• radial_delayed_blowbackBlowback delayed by lugs camming radially out of the carrier
• short_recoil_rotating_barrelShort recoil in which the barrel rotates to unlock
• gas_operated_balanced_automaticsGas-operated with a counter-mass moving against the carrier to cancel recoil
• gas_operated_balanced_recoilGas-operated with a balanced recoil system damping the impulse
• gas_operated_blow_forwardGas-operated in which the barrel moves forward rather than the bolt back
• gas_operated_open_boltGas-operated, firing from an open bolt
• gas_operated_tilting_boltGas-operated with a bolt that tilts to lock (e.g. FN FAL)

Datenkonfidenz

dataConfidence ist ein Wert von 0 bis 1 dafür, für wie viel eines Datensatzes eine Quelle einsteht. Er wird aus dem gesetzt, was beim Anlegen oder Prüfen tatsächlich belegt wurde, und nie von Hand angehoben: ein Mensch kann ihn nach einem gefundenen Widerspruch senken, nur eine neue Quelle kann ihn heben. Er ist ein Maß auf Datensatzebene, keine Wahrscheinlichkeit pro Feld, dass eine Zahl stimmt: 0,95 heißt nicht, dass die Lauflänge zu 95 % korrekt ist.

Bei einer Waffe spiegelt der Wert auch die Abdeckung: wie viel des Datensatzes die zitierten Seiten abdeckten und welcher Art diese Seiten waren. Ein voller Datensatz vom Herstellerdatenblatt, den zwei Referenzen bestätigen, liegt über 0,9; eine einzelne unbestätigte Quelle unter 0,7. Eine Anzahl allein sagt wenig, denn vier Händlerseiten, die eine Herstellerangabe wiederholen, sind eine Quelle. Deshalb provenance.sourceKinds jede Seite einordnet und provenance.bestSourceKind die stärkste nennt. Bei einer Patrone oder einem Anbauteil folgt der Wert genau den Stufen unten, weil diese Datensätze Quelle für Quelle geprüft werden.

Was jede Stufe bedeutet

Die Obergrenze, die ein Datensatz für das Gefundene tragen darf. Ein Datensatz landet in der höchsten Stufe, die seine Belege stützen, und nie darüber.

Zwei Dinge drücken einen Wert unter seine Stufe. Eine vom Validator markierte Zahl, die keine zweite Quelle auflösen konnte, deckelt den Datensatz bei 0,6, und der Widerspruch steht in notes. Eine Montageschnittstelle, der die Herstellerseite widerspricht, senkt ein Anbauteil bis zur Korrektur auf 0,6, weil ein falsches Gewinde eine Sicherheitsfrage ist.

verifiedFields ist der Beleg

Ein Patronen- oder Anbauteil-Datensatz trägt verifiedFields: genau die Felder, die seine Quelle genannt hat, und nichts darüber hinaus. Ein dort nicht gelistetes Feld steht auf dem Stand der Erstbefüllung, was auch immer der Wert sagt. Kategorische Felder wie Hülsenform oder Geschossart sind Einschätzung, keine Belegung, und heben den Wert nie für sich allein. verifiedAt ist der Zeitpunkt dieser Prüfung; null heißt, niemand hat den Datensatz bisher gegen eine Quelle geprüft.

Was mit einem niedrigen Wert zu tun ist

• Alles, worauf Sie nicht ungeprüft bauen würden, als ungeprüft behandeln. Bei 0,6 wurde nur die Existenz des Artikels bestätigt; bei 0,5 gar nichts.
• Eine konkrete Zahl gegen sources prüfen, nie gegen den Wert. Der Wert sagt, wie gut der Datensatz als Ganzes belegt ist; die Seiten sagen, wo jede Zahl bestätigt werden konnte.
• Filtern statt raten. GET /v1/data/confidence listet Datensätze unter einer Schwelle, niedrigste zuerst; auf den Kompatibilitäts-Endpunkten blendet min_confidence Passungen aus, die über schwache Belege berechnet wurden.
• Melden, was Sie finden. Eine falsche Zahl ist eine Datenmeldung, auf die ein Mensch reagiert, und die Korrektur erreicht jeden Aufrufer.

Die Quellenhierarchie

Jede Seite, die ein Datensatz zitiert, wird als eine SourceKind eingeordnet, stärkste zuerst, und der Datensatz trägt das Ergebnis: provenance.sourceKinds ist ein { url, kind } pro Seite und provenance.bestSourceKind die stärkste davon. Gewichten Sie eine Zahl nach der besten Art dahinter, nie nach der Zahl der zitierten Seiten. Spezifikationen unterscheiden sich legitim nach Jahr, Werk und Markt, also widersprechen sich Seiten; dann gewinnt die höhere Art, und die notes des Datensatzes vermerken den Widerspruch.

1. manufacturer Die eigene Produktseite, Anleitung, das Datenblatt oder der Katalog des Herstellers. Die Autorität für alles, was der Hersteller veröffentlicht.
2. standards_body SAAMI, C.I.P. oder eine NATO-Norm. Die Autorität für Patronenmaße und -drücke.
3. government Ein Beschaffungsdokument, eine technische Vorschrift, die Seite einer Truppe, ein Nationalmuseum. Jeder .mil- oder .gov-Host wird per Regel hier eingeordnet.
4. reference Eine unabhängige Referenz, die nennt, woher ihre Zahlen stammen: eine Enzyklopädie, Modern Firearms, Forgotten Weapons, eine Museumssammlung, Jane's.
5. aggregator Eine Seite, die Zahlen aus anderen Quellen zusammenträgt, ohne zu sagen, aus welchen. Nützlich für Abdeckung, schwach als Beleg.
6. press Ein Magazin, eine Testseite oder ein Blog: eine eigene Messung eines Journalisten oder eine wiederholte Herstellerangabe.
7. retailer Ein Angebot, geschrieben um zu verkaufen. Beleg dafür, dass es das Modell gibt und wie der Markt es nennt; die Zahlen sind von anderswo kopiert.
8. community Ein Forum, Wiki oder eine Fanseite. Beleg nur für Existenz und Benennung, nie die einzige Quelle für eine Zahl.
9. other Ein Host, der noch nicht in der Quellenkarte steht. Wird als schwächste Art gemeldet, bis er eingeordnet ist, nie geraten, sodass ein für die stärkeren Arten genannter Anteil nur untertrieben sein kann.

Heute zitieren 100% der Waffen mindestens eine Seite, 83% zwei oder mehr und 34% eine manufacturer-, standards_body- oder government-Seite. Bei jedem Build aus dem Katalog berechnet. Ein Datensatz, der noch Modellwissen aus der Erstbefüllung ist, trägt dataConfidence 0,5 mit verifiedAt null, was immer seine Seiten sagen.

Das provenance-Objekt

GET /v1/firearms/{id}, GET /v1/calibers/{id} und GET /v1/attachments/{id} tragen ein provenance-Objekt, die eine Stelle, an der die Herkunft gelesen wird. Es bündelt, was die Abschnitte oben beschreiben: die konsultierten Seiten und welcher Art jede ist, den Wert, wann und welche Felder geprüft wurden, und die zwei Cache-Signale.

• sourcesDie für den Datensatz konsultierten Seiten.
• sourceKindsJede zitierte Seite und ihre Art, in der Reihenfolge von `sources`, auf der Hierarchie oben. Ein Host, der nicht in der Quellenkarte steht, ist `other`.
• bestSourceKindDie stärkste Art unter den Zitaten, oder null, wenn nichts zitiert wird. `manufacturer` oder `standards_body` heißt, eine Zahl lässt sich gegen eine Autorität prüfen; nur `retailer` oder `community` heißt, der Datensatz beruht auf Kopien.
• dataConfidenceDer Wert von 0 bis 1 von oben, oder null, wenn der Datensatz nie bewertet wurde.
• verifiedAtWann der Datensatz zuletzt gegen eine Quelle geprüft wurde; null bei Modellwissen aus der Erstbefüllung.
• verifiedFieldsGenau die Felder, die diese Quelle genannt hat; null, wenn nichts geprüft wurde.
• updatedAtWann sich die gelieferten Spalten zuletzt geändert haben, von der Datenbank gepflegt.
• versionDer Inhalts-Hash des Datensatzes; gleiche Versionen heißen gleiche Daten auf jedem Tarif.
• specSourceNur Patronen: die Seite, von der die Zeichnungsmaße gelesen wurden.

Es gibt noch keine Zuordnung pro Feld und keine Änderungshistorie pro Datensatz: verifiedFields sagt, welche Felder bestätigt wurden, nicht von welcher Seite, und updatedAt sagt, wann sich der Datensatz zuletzt geändert hat, nicht was sich geändert hat. Leiten Sie beides nicht aus den Feldern oben ab.