Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mpc-lab-x/mpc-lab-x

MPC-Lab-X is a powerful problem generation module for educational purposes. It enables developers and educators to create, customize, and generate a variety of problems in subjects like mathematics, physics, and chemistry. With flexible, dynamic generation and parameterized controls, it scales easily from simple exercises to complex assessments.
https://github.com/mpc-lab-x/mpc-lab-x

chemistry generator math mathematics nodejs physics problems-generator teaching-tool

Last synced: 2 months ago
JSON representation

MPC-Lab-X is a powerful problem generation module for educational purposes. It enables developers and educators to create, customize, and generate a variety of problems in subjects like mathematics, physics, and chemistry. With flexible, dynamic generation and parameterized controls, it scales easily from simple exercises to complex assessments.

Awesome Lists containing this project

README

        

# MPC-Lab-X [![npm version](https://badge.fury.io/js/mpclab.svg)](https://npmjs.com/package/mpclab) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![Issues](https://img.shields.io/github/issues/MPC-Lab-X/MPC-Lab-X)](https://github.com/MPC-Lab-X/MPC-Lab-X/issues) [![PRs](https://img.shields.io/github/issues-pr/MPC-Lab-X/MPC-Lab-X)](https://github.com/MPC-Lab-X/MPC-Lab-X/pulls)

MPC-Lab-X is a powerful problem generation module for educational purposes. It enables developers and educators to create, customize, and generate a variety of problems in subjects like mathematics, physics, and chemistry. With flexible, dynamic generation and parameterized controls, it scales easily from simple exercises to complex assessments.

## Features

- **Problem Generation**: Generate problems with a variety of parameters and constraints.
- **Customization**: Customize problems with different types, formats, and difficulty parameters.
- **Scalability**: Scale from simple exercises to complex assessments with ease.
- **Subjects**: Generate problems in mathematics, physics, and chemistry.
- **Dynamic Generation**: Generate problems dynamically with randomization and parameterization.

## Installation

```bash
npm install mpclab
```

## Usage

- **Step 1**: Import the module.

```javascript
const ProblemGenerator = require("mpclab");
```

- **Step 2**: Create a new instance of the problem generator.

```javascript
const generator = new ProblemGenerator();
```

- **Step 3**: Generate a problem with specific parameters.

```javascript
const problem = generator.generateOne([
"math",
"algebra",
"linear-equations",
"standardForm",
]);

console.log(problem);
```

- **Step 4**: Enjoy the generated problem!

> **Note**: This is a basic example. You can customize and generate problems with a wide range of parameters and constraints. Check the [USAGE.md](/docs/USAGE.md) file for detailed usage instructions.

## Contributing

Contributions are welcome! For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate. Check the [CONTRIBUTING.md](/docs/CONTRIBUTING.md) file for more details.

## License

This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](/LICENSE) file for details.