Node.js wrapper for the official ATIH grouping engine (PMSI GHM/GHS) used in French hospital medical coding. This package provides access to the native C groupage module for classifying inpatient stays into GHM and GHS codes as part of the PMSI/T2A system
npm install @beparallel/groupingA Node.js wrapper for the official ATIH grouping engine used in the French PMSI (Programme de Médicalisation des Systèmes d'Information).
This package allows integration of the native C-based groupage module to classify hospital stays into GHM (Groupe Homogène de Malades) and GHS (Groupe Homogène de Séjours) codes, in compliance with the T2A billing system in France.
This project implements a Node.js native addon using Node-API to wrap the official ATIH (Agence Technique de l'Information sur l'Hospitalisation) grouping engine. The grouping engine is a critical component of the French healthcare system's billing and classification infrastructure.
The French healthcare system uses the PMSI (Programme de Médicalisation des Systèmes d'Information) for medical activity coding and hospital billing under the T2A (Tarification À l'Activité) system. This project specifically addresses the need for automated grouping of medical stays into standardized categories.
For comprehensive background on grouping algorithms and medical coding in France, refer to this detailed overview.
This package consists of:
1. Native C/C++ Module: The core ATIH grouping engine in the atih folder (see doc/grouping_method.md)
2. JavaScript Interface: High-level Node.js API for application integration
3. Type Definitions: TypeScript definitions for development support
1. Install the package
``bash`
pnpm add @beparallel/grouping
2. Export Github Token
`bash`
export GITHUB_TOKEN=your_github_token
or set it in the .env.dev file and run dotenv -f .env.dev run XXX
3. Build the native module
`bash`
cd node_modules/@beparallel/grouping && pnpm prebuild:install
- Node.js 22.0.0 or higher
- Compatible with macOS and Linux
- Native compilation tools (node-gyp)
- Release process: doc/package/publish.md
- Format of the RSS non grouped data: doc/atih/022_format.md
- Format of the RSS grouped data: doc/atih/122_format.md
- Grouping algorithm: doc/atih/grouping_method.md
`javascript
import { grp } from '@beparallel/grouping'
const result = grp.grp2025({...})
`
The module expects RSS (Résumé de Sortie Standardisé) formatted data conforming to ATIH specifications:
`javascript
const rssData = {
// Patient demographics
age: 65,
sex: 'M',
// Medical coding
mainDiagnosis: 'I21.0',
secondaryDiagnoses: ['E11.9', 'N18.6'],
procedures: ['DEQP003'],
// Stay information
entryMode: '6',
exitMode: '9',
lengthOfStay: 7,
// Additional classification data
severity: 2,
complexity: 1
}
`
`javascript``
{
ghm: 'GHM_CODE', // Groupe Homogène de Malades
ghs: 'GHS_CODE', // Groupe Homogène de Séjours
severity: 2, // Severity level
complexity: 1, // Complexity level
errors: [], // Array of error codes/messages
warnings: [], // Array of warning messages
processingTime: 1.2 // Processing time in milliseconds
}