Git Product home page Git Product logo

do2021-c11's Introduction

KS-API

Overview

This is a Knapsack API for stress analysis and benchmarking.

This server was scaffolded with oas-wizard, oas-tools and oas-generator; knapsack algorithm is taken from devfacet.

There is a on-line demo deployment available at: https://knapsack-api.herokuapp.com

Running the API using docker

If you have docker, you can use it out of the box: docker run -p 12345:80 -d pafmon/ks-api to run the container at port 12345

Running the API using node

To run the server, just use:

npm install 
npm start

Then, if running in localhost, you can check the swagger UI doc portal in: http://localhost:8080/

Using the API

Stress request

In order to send a request, either GET or POST can be used:

  • POST /api/v1/stress
{
	"problem": "knapsack",
	"parameters": [
		{
			"id": "itemNumber",
			"value": 100000
		},
		{
			"id": "maxWeight",
			"value": 100000
		}
	],
	"config": {
		"maxMemory": -1,
		"maxTime": -1
	}
}
  • GET /api/v1/stress/10000/10 would generate and solve a knapsack problem with 10000 items (each of them with a random weight up to 10).

Knapsack problem solving

In order to solve a given knapsak problem you should send a POST to /api/v1/problems endpoint:

POST /api/v1/problems

{
    "id": "KSProblem",
    "problem": {
        "items": [{
                "item": "item1",
                "value": 3
            },
            {
                "item": "item2",
                "value": 2
            },
            {
                "item": "item3",
                "value": 3
            },
            {
                "item": "item4",
                "value": 2
            },
            {
                "item": "item5",
                "value": 1
            },
            {
                "item": "item6",
                "value": 2
            }
        ],
        "size": 10
    }
}

will get:

{
  "id": "KSProblem",
  "problem": {
    "items": [
      {
        "item": "item1",
        "value": 3
      },
      {
        "item": "item2",
        "value": 2
      },
      {
        "item": "item3",
        "value": 3
      },
      {
        "item": "item4",
        "value": 2
      },
      {
        "item": "item5",
        "value": 1
      },
      {
        "item": "item6",
        "value": 2
      }
    ],
    "size": 10
  },
  "solution": {
    "items": [
      {
        "item": "item1",
        "value": 3
      },
      {
        "item": "item3",
        "value": 3
      },
      {
        "item": "item2",
        "value": 2
      },
      {
        "item": "item4",
        "value": 2
      }
    ],
    "size": 10,
    "stats": {
      "solvingTime": "0.40689898681640624ms"
    }
  }
}

do2021-c11's People

Contributors

pafmon avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.