Node.js API to Analyze OMR Documents & Extract Data

Getting Started with Aspose.OMR Cloud SDK for Node.js

The recommend way to use Aspose.OMR Cloud SDK for Node.js is via NPM. Please use the following command for a smooth installation.

npm install && npm run-script build 

git clone https://github.com/aspose-omr-cloud/aspose-omr-cloud-nodejs.git --recurse-submodules	 

Dynamic OMR Template Generation in Node.js

One of the most powerful features of the Aspose.OMR Cloud SDK for Node.js is its ability to dynamically generate OMR templates. Unlike traditional methods that require predefined templates, this SDK allows software developers to create templates on the fly using simple text markup or JSON configurations. This flexibility is ideal for situations where you need to customize forms to meet specific requirements, such as changing the layout or adding new questions. The following example shows, how software developers can dynamically generate OMR templates inside Node.js environment.

const asposeomrcloud = require("asposeomrcloud");
const config = new asposeomrcloud.Configuration({
    appSID: "YOUR_APP_SID",
    appKey: "YOUR_APP_KEY",
});

const omrApi = new asposeomrcloud.OmrApi(config);

const templateJson = {
    "templateName": "Survey",
    "elements": [
        {
            "elementType": "Text",
            "x": 100,
            "y": 50,
            "value": "Please fill out this survey",
        },
        {
            "elementType": "ChoiceBox",
            "x": 100,
            "y": 150,
            "choices": ["Yes", "No", "Maybe"],
        }
    ]
};

omrApi.generateTemplate(templateJson).then(result => {
    console.log("Template Generated:", result);
}).catch(err => {
    console.error("Error generating template:", err);
});

Accurate OMR Sheet Recognition in Node.js

Aspose.OMR Cloud SDK for Node.js excels in recognizing filled-out OMR sheets and provides highly accurate recognition of filled OMR sheets inside Node.js applications. After forms are filled out and scanned, the SDK can recognize the marked areas, even when the marks are not perfectly filled in. This feature is particularly useful in real-world scenarios where user input may be less than perfect. Here is an example that shows how software developers can recognize OMR sheet inside Node.js.

const omrSheetPath = "filled_survey_sheet.jpg";
omrApi.recognizeImage(omrSheetPath, "SurveyTemplate.json").then(result => {
    console.log("Recognized Data:", result.data);
}).catch(err => {
    console.error("Recognition Error:", err);
});

Customizable Marking and Grading in Node.js

For educational institutions or organizations that require specific grading criteria, the SDK allows for customizable marking and grading rules. Aspose.OMR Cloud SDK for Node.js allows software developers to define custom rules for marking and grading OMR sheets. This feature is very beneficial for educational institutions and organizations. You can configure how marks are detected, how errors are handled, and how results are calculated. Here is an example that shows how software developers can perform grading operations inside Node.js applications.

const gradingSettings = {
    "markingThreshold": 0.6, // minimum mark detection threshold
    "errorMargin": 0.1, // margin of error for detection
};

omrApi.recognizeImage("filled_exam_sheet.jpg", "ExamTemplate.json", gradingSettings).then(result => {
    console.log("Grading Results:", result.grades);
}).catch(err => {
    console.error("Grading Error:", err);
});

Wide Range Input Formats Support

Aspose.OMR Cloud SDK for Node.js supports multiple input formats, including popular image formats such as JPEG, PNG, BMP, TIFF and many more. This flexibility allows you to work with different types of scanned forms without worrying about format compatibility, ensuring seamless integration into your existing workflows. Moreover, it is designed to work globally, supporting multiple languages for text on OMR sheets.