Skip to main content

AQL (Acceptable Quality Limit) sampling calculator for garment industry QC. Implements ISO 2859-1 sample size code letters and accept/reject tables. Built and used in production by Scan ERP.

Project description

garment-aql-calculator

AQL (Acceptable Quality Limit) sampling calculator for garment industry quality control. Implements ISO 2859-1 — the universal standard for inspection by attributes used by every garment QC team globally.

Built and used in production by Scan ERP — a garment manufacturing ERP running on a 100+ machine CMT factory in Nepal.

Install

npm install garment-aql-calculator

Why this exists

Every garment factory QC team runs AQL sampling on every shipment. Existing tools (QIMA, HQTS, Tetra Inspection) are web-only — no programmatic library. This package fills that gap so ERP systems, QC apps, and custom dashboards can run AQL calculations natively.

Quick start

const { calculateAQL } = require('garment-aql-calculator');

const result = calculateAQL({
  lotSize: 2400,
  inspectionLevel: 'GII',
  aql: 2.5,
});

console.log(result);
// {
//   lotSize: 2400,
//   inspectionLevel: 'GII',
//   aql: 2.5,
//   codeLetter: 'K',
//   sampleSize: 125,
//   acceptNumber: 7,
//   rejectNumber: 8,
//   decision: [Function]
// }

// Use the decision function with actual defects found
console.log(result.decision(5));   // 'ACCEPT' (5 ≤ 7)
console.log(result.decision(8));   // 'REJECT' (8 ≥ 8)

Full garment inspection (critical + major + minor)

Standard garment QC runs three AQL sampling plans simultaneously. Use the convenience function:

const { calculateGarmentInspection } = require('garment-aql-calculator');

const inspection = calculateGarmentInspection({
  lotSize: 2400,
  inspectionLevel: 'GII',
  // Defaults — standard garment industry values
  criticalAQL: 0.65,
  majorAQL: 2.5,
  minorAQL: 4.0,
});

console.log('Critical:', inspection.critical.sampleSize, 'accept', inspection.critical.acceptNumber);
console.log('Major:',    inspection.major.sampleSize,    'accept', inspection.major.acceptNumber);
console.log('Minor:',    inspection.minor.sampleSize,    'accept', inspection.minor.acceptNumber);

API

calculateAQL({ lotSize, inspectionLevel, aql })

Param Type Default Notes
lotSize number required Total units in the production lot (≥ 2)
inspectionLevel string 'GII' One of S1, S2, S3, S4, GI, GII, GIII
aql number 2.5 One of 0.65, 1.0, 1.5, 2.5, 4.0, 6.5

Returns { codeLetter, sampleSize, acceptNumber, rejectNumber, decision }.

calculateGarmentInspection({ lotSize, inspectionLevel, criticalAQL, majorAQL, minorAQL })

Returns three AQL results — one for each defect tier.

getCodeLetter(lotSize, inspectionLevel)

Lower-level utility: returns just the ISO 2859 code letter.

ISO 2859 reference

Inspection level Use case
GI Lower-risk products, smaller sample
GII Default — most garment inspections
GIII Higher-risk products, larger sample
S1, S2, S3, S4 Special inspection levels for destructive or expensive testing
Garment defect tier Standard AQL
Critical (safety, regulatory) 0.65
Major (workmanship affecting function) 2.5
Minor (cosmetic only) 4.0

License

MIT — © 2026 Santosh Rijal / Scan ERP — https://scanerp.pro

Related packages

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

garment_aql_calculator-1.0.0.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

garment_aql_calculator-1.0.0-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file garment_aql_calculator-1.0.0.tar.gz.

File metadata

  • Download URL: garment_aql_calculator-1.0.0.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.1

File hashes

Hashes for garment_aql_calculator-1.0.0.tar.gz
Algorithm Hash digest
SHA256 be63c0e7654d5d95e7859f495fc4e13ea7666a1c9f49e86affa0bf8a0b1c6fa7
MD5 9e2229e88b7af4d9ab048a8b1beeaccb
BLAKE2b-256 ac761e5b06b206a68f32fe8091201966265ba51e7ed2e4abd351e525dc80b811

See more details on using hashes here.

File details

Details for the file garment_aql_calculator-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for garment_aql_calculator-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c5bf0ce566a120d35249ce3c8bbd9a53275b966f0b3f1d231349a8591767633f
MD5 7677cd42b46a8b94468c991773c3e91b
BLAKE2b-256 71d28f198edf6a2bacedb92193db8ed6323c259fcdf2479e08567964b1040fda

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page