Email and XML-RPC Interface to bco:TRON: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>bco</category>
<solver>TRON</solver>
<inputMethod>FORTRAN</inputMethod>

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

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

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

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

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

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

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

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

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

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

</document>

Description of input values

n

nf

initpt
You need to specify the absolute path to a file containing a Fortran subroutine that defines the starting point. Remember that since the subroutine is in Fortran, the spacing is important. 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 absolute path to a file containing a Fortran subroutine that defines the values of the element functions which make up the objective. This subroutine needs to be in the following format:

      subroutine fcn(n,x,nf,fvec)
            n - integer (input)
                number of variables
            x - double precision, length n (input)
                vector of variables
           nf - integer (input)
                number of element functions
         fvec - double precision, length nf (output)
                element functions at x

xbound
You need to specify the absolute path to a file containing a Fortran subroutine that defines the lower and upper 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 bound
      xu - double precision, length n (output)
           upper bound

   (If x(i) has no lower bound, then do not assign a value to xl(i), similarly
    if x(i) has no upper bound, then xu(i) should not be set.)

fatol
If provided, these values will affect various halting tolerances.
frtol

gtol

fmin

comments

_{DOE disclaimer

DOE Web privacy policy}