Skip to content

The code powering the steps in Qualisys Calqulus Pipelines

License

Notifications You must be signed in to change notification settings

qualisys/Calqulus-Steps

Repository files navigation

Calqulus

This repository contains the code powering Calqulus pipelines – a powerful way to analyze and process motion capture data for use in reports without writing complex scripts.

How it works:

The Calqulus engine takes motion capture data together with a Calqulus pipeline (YAML) and maps the steps in the pipeline with the steps found in this repository. The data described in the pipeline is then fed to the step and the output is handled for export or for use in further pipelines.

Each pipeline step defined in your Calqulus pipeline corresponds to a step class defined in this repo.

In simple terms:

  • You define a pipeline using YAML - See our Calqulus Pipelines.
  • You set everything up on Report Center.
  • You initiate the processing from QTM, using the Calqulus Module.

If you're interested in trying out Calqulus to process your own data, please reach out to sales@qualisys.com

Documentation

Read the YAML documentation to learn how the pipelines are constructed and how to use the different steps.

Issues

If you spot any bugs, issues or if you experience any difficulties while using Calqulus, we'd appreciate it if you could let us know by creating an issue.

Your feedback is valuable to us and will help us improve Calqulus, so please don't hesitate to create an issue if you come across anything that needs our attention.

Development

All steps are unit tested with a coverage of 99+%. We also automatically run regression tests against our public Calqulus Pipelines.

Any contributions needs to be fully tested and passing regression tests before they can be approved.

Getting started

Calqulus is written in TypeScript and requires Node 14+.

Install all dependencies by running npm install

Testing

Run the tests to verify that that all tests pass before committing any changes.

Run all tests: npm run test
Run linting tests:  npm run test:lint
Run unit tests: npm run test:unit
Create test coverage report: npm run cov
Run hot-reloading unit tests: npm run watch:test

Building

Build the code to verify that the code compiles and you get no errors before committing any changes.

Run build for production: npm run build
Run hot-reloading builds: npm run watch:build

Documentation

We use TypeDoc to generate documentation for the code and a custom script to extract documentation about steps to build the step documentation. Updates to the step documentation should be checked in with your code, while TypeDoc documentation is ignored in commits.

Build code documentation: npm run doc
Build step documentation:  npm run doc:steps