Lisless is a non-LIS for those without one: the LIS-less. It is a LIS-in-name-only that does less.
This is a work-in-progress prototype. The plan is that Lisless will receive ASTM E1381/1394 test results from laboratory instruments and convert them to FHIR v4 documents for other data systems to process. Currently Lisless only outputs the raw, decoded records.
The Seattle Flu Study has a number of data systems, including our own ID3C and NWGC's "Samplify" LIMS (which isn't a LIS), but none of them speak HL7 v2/3 or ASTM E1381/1394. These protocols are commonly used by clinical-grade laboratory instruments to report results directly to a hospital LIS and onwards into the medical record. As the Study starts to use Cepheid's GeneXpert instruments to test samples, we want to use the instruments' LIS-integration capabilities to capture results automatically instead of parsing PDF exports or manual data entry.
Lisless requires Python 3.8.
Install dependencies into a Pipenv environment:
pipenv sync
Start the server:
pipenv run lisless
The server listens on localhost:11211 and logs quite a bit of information to
stderr.
Send the server some very minimal records for testing:
pipenv run ./dev/send-records
Raw representations of the received records are printed to the server's stdout as JSON, which you may want to redirect to a file to capture the data.
If you observe protocol errors in your own testing, you can run Lisless with
the environment variable DEBUG_EXCEPTIONS=1 and Lisless will drop you into
pdb when any exception is logged.