A complete XML-RPC client for the Neos Numerical Optimisation Server. Works in the browser and Node.js
For parsing the results of a GAMS job returned by NEOS, check out gams2js!
To install via npm:
npm install neos-js
Or grab a release archive file from the dist folder.
Browser: In the header include
<script src="assets/neos.min.js"></script>then
<script type="text/javascript">
NEOS.xmlstring({
category: 'LP',
solver: 'CPLEX',
inputMethod: 'GAMS',
model: simulationModelString,
email: '[email protected]'
})
.then(NEOS.submitJob)
.then(NEOS.getFinalResults)
.then(res => {
// work with the resulting listing file
})
.catch(err => {
// catch errors
})
</script>Check out the NEOS online editor example
Node.js
const NEOS = require('neos-js')
const fs = require('fs')
// load a simulation model, in this case a GAMS file
const model = fs.readFileSync('transport_model.gms', 'utf-8')
// convert the simulation model into a NEOS XML string,
// solve and await the results
NEOS.xmlstring({
category: 'LP',
solver: 'CPLEX',
inputMethod: 'GAMS',
model: simulationModelString,
email: '[email protected]'
})
.then(NEOS.submitJob)
.then(NEOS.getFinalResults)
.then(res => {
// work with the resulting listing file
})
.catch(err => {
// catch errors
})For a complete list of the available methods, visit the Neos Server XML-RPC API documentation.
Additional methods:
prepareJob(template, model, email)
Convenience method. Converts your simulation model (string) into the required NEOS XML format that you get from the getSolverTemplate method. An email is required for some solvers (e.g. CPLEX), so make sure to pass one.
xmlstring(json)
Convert a JavaScript object containing the properties required for running a NEOS
job into a NEOS compatible XML string. The object properties should adhere to the
properties retrieved from the getSolverTemplate method (without the surrounding document tag).
parseXML(xmlstring)
Parse an XML string retrieved by NEOS, e.g. the result from the getSolverTemplate
call.
Contribution is highly appreciated! Make sure to npm test before submitting a PR
MIT