Email and XML-RPC Interface to bco:BLMVM:C

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>BLMVM</solver>
<inputMethod>C</inputMethod>

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

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

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

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

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

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

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

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

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

</document>

Description of input values

dimension
How many variables are in your problem
ad_type
Are you providing a subroutine that calculates both function and gradient evaluations or a subroutine that only provides function evaluations. The second choice will invoke Automatic Differentiation using the AD tool of your choice.
adtool

nfelements
If your function is in partially separable form, then enter the number of function elements
funceval
In what file is the function to evaluate function and gradient? If you are using the function/gradient option, then your function must be called 'fcn' and have this prototype:

C:
void fcn(int ndim, double *x, double *f, double *g)

int *ndim -- # of dimensions in the problem
double *x -- vector to evaluate the function at

double *f -- address of a double to store function value
double *g -- array to store gradient

If you are using the function/automatic differentiation option, then your function must be called 'fcn' and have this prototype.

void fcn(int ndim, double *x, double *f)

bounds
In what file is the function to set the variable bounds? The default values are +,- infinity, insert only the boundary values that are not at infinity. If you do not want any variable bounds, then you can leave this entry blank. Otherwise, the function must be called 'xbound' and have this prototype:

void xbound(int ndim, double *l, double *u)

int *ndim -- # of dimensions in the problem

double *l -- array of lower bounds
double *u -- array of upper bounds

initpt
In what file is the function to set the initial vector? The function must be called 'initpt' and have this prototype:

void initpt(int ndim, double *x)

int *ndim -- # of dimensions in the problem
double *x -- the initial vector

options
Enter optional command-line arguments. Below are selected options. See TAO User Manual for details and a complete listing.

-tao_fatol (0.0001): Stop if solution is within
-tao_frtol (0.0001): Stop if relative solution is within
-tao_gatol (0.0): Stop if norm of gradient is less than
-tao_grtol (0.0): Stop if norm of gradient divided by function value is less than
-tao_gttol (0.0): Stop if the norm of the gradient is less than the norm of the initial gradient times this value
-tao_max_it (10000): Maximum number of iterations
-tao_max_funcs (10000): Maximum number of function evaluations
-tao_fmin (-1e30): Stop if function less than
-tao_lmvm_lm (5): Number of vectors to retain for hessian approximation
-tao_monitor : Display information at every iteration

comments

_{DOE disclaimer

DOE Web privacy policy}