Email and XML-RPC Interface to nco:SNOPT:FORTRAN

Follow these steps to submit a job to NEOS via email or XML-RPC clients:

Save the following template using your browser's copy and paste tools
Using your favorite editor, plug your data files and parameters into the message in the indicated spots
Descriptions of the input are written with the web interface in mind. If the description asks for the name of a file, then you will instead need to insert the contents of the file itself.
The <![CDATA[ ... ]]> tag is an escape indicator. This will ensure that any special characters in your inputs (such as <, >, &, etc.) will be interpreted correctly.

For email, send this file as the message body or as a plain text attachment to neos@mcs.anl.gov. Do not send .doc, .rtf, .xsw, or other files that aren't plain text. The job results will be mailed to you.

For XML-RPC, you need to submit the contents of this file to NEOS with the submitJob() method, and retrieve the results with the getResults() method. Go here for more information on using the XML-RPC interface to NEOS.

<document>
<category>nco</category>
<solver>SNOPT</solver>
<inputMethod>FORTRAN</inputMethod>

<N><![CDATA[
...Insert Value Here...
]]></N>

<M><![CDATA[
...Insert Value Here...
]]></M>

<initpt><![CDATA[
...Insert Value Here...
]]></initpt>

<fcn><![CDATA[
...Insert Value Here...
]]></fcn>

<cfcn><![CDATA[
...Insert Value Here...
]]></cfcn>

<xbound><![CDATA[
...Insert Value Here...
]]></xbound>

<cbound><![CDATA[
...Insert Value Here...
]]></cbound>

<spec><![CDATA[
...Insert Value Here...
]]></spec>

<comments><![CDATA[
...Insert Value Here...
]]></comments>

</document>

Description of input values

N
You need to tell us the number of variables
M
You need to tell us the number of constraints
initpt
You need to specify the location of a file containing a subroutine that defines the starting point. This subroutine needs to be in the following format:

    subroutine initpt(n,x)
       n - integer (input)
           number of variables
       x - double precision, length n (output)
           starting point

fcn
You need to specify the location of a file containing a subroutine that evaluates the objective function. This subroutine needs to be in the following format:

    subroutine fcn(n,x,f)
       n - integer (input)
           number of variables
       x - double precision, length n (input)
           vector of variables
       f - double precision, objective function evaluated at x

cfcn
You need to specify the locatin of a file containing a subroutine that evaluates the general constraint functions. This subroutine needs to be in the following format:

    subroutine cfcn(n,x,m,c)
       n - integer (input)
           number of variables
       x - double precision, length n (input)
           vector of variables
       m - integer (input)
           number of general constraints
       c - double precision, length m (output)
           general constraint functions at x

xbound
You need to specify the location of a file containing a subroutine that defines the bounds on the variables. This subroutine needs to be in the following format:

    subroutine xbound(n,xl,xu)
        n - integer (input)
            number of variables
       xl - double precision, length n (output)
            lower bounds
       xu - double precision, length n (output)
            upper bounds

   If x(i) has no lower bound, then xl(i) should be set to a large
   negative number (e.g., -1.00d+10), similarly if x(i) has no upper
   bound, then xu(i) should be set to a large positive number
   (e.g., 1.00d+00).

cbound
You need to specify the location of a file containing a subroutine that defines the bounds on the general constraints. This subroutine needs to be in the following format:

    subroutine cbound(m,cl,cu)
        n - integer (input)
            number of general constraints
       cl - double precision, length m (output)
            lower bounds
       cu - double precision, length m (output)
            upper bounds

   If c(i) has no lower bound, then cl(i) should be set to a large
   negative number (e.g., -1.00d+10), similarly if c(i) has no upper
   bound, then cu(i) should be set to a large positive number
   (e.g., 1.00d+00).

spec
Optionally, you may specify the location of a file containing the SNOPT specifications file (SPECS file).
comments
Enter any additional comments here (e.g. to identify the data for your own information.) These comments will be returned with your results.
_{DOE disclaimer

DOE Web privacy policy}