TAMLINK man page
tamlink - TAMLINK Tangent linear and Adjoint Model Linker
SYNOPSIS
tamlink [OPTIONS] <files>
DESCRIPTION
TAMLINK links the TAMC generated files and libraries.
Depending on the given options the program will use the
derivative code for different purposes.
OPTIONS
-help Show usage and give short discription of options.
-cost Generate program to compute the cost function.
-check Generate program to check gradients computed by
adjoint code against finite difference approxima-
tions.
-checktl
Generate program to check gradients computed by
tangent linear code against finite difference
approximations.
-compare
Check generated sensitivities using the definition
of an adjoint operator <Ax,y> := <x,A^*y>.
-tangent
Generate program to run the tangent linear model.
The initial perturbation must be initialized by a
subroutine initper( n, per ).
-adjoint
Generate program to run the adjoint model, in this
case the result is the gradient vector.
-time Generate program to give run times about function,
adjoint, and tangent linear code.
-opti Generate program to minimize the given function.
The adjoint code computes the required gradients.
Per default an simple conjugate gradient algorithm
is used.
-function
Generate program to compute the vector valued func-
tion.
-forward
Generate program to compute the vector valued func-
tion and its Jacobian in forward mode.
Generate program to compute the vector valued func-
tion and its Jacobian in reverse mode.
-jacobian
Generate program to compute full Jacobian in
reverse and forward mode.
-optlib
Specify the optimization library interface:
c_e04dge for NAGLIB e04dge, c_e04uce for NAGLIB
e04uce, c_umcgg for IMSL umcgg, c_m1qn3 for
Gilbert's m1qn3, or c_lsopt for Giering's, lsopt.
The default is c_cgopt, the provided conjugate gra-
dient routine.
-l<lib>
This option will be passed to linker. If you have
used -optlib you probably need to include the opti-
mization library.
-L<path>
This option will be passed to linker. If you have
used -optlib you probably need to give the path of
the optimization library.
All other options will be passed to the Fortran compiler.
FILES
<file>.f original function computing code
<file>_ad.f adjoint and modified code
<file>_ftl.f function and tangent linear code
LIBRARIES
libtamc.a TAMC library
libcgopt.a conjugate gradient optimization library
libc_cgopt.a cgopt interface library
libc_e04dge.a e04dge interface library
libc_e04uce.a e04uce interface library
libc_umcgg.a umcgg interface library
libc_m1qn3.a m1qn3 interface library
libc_lsopt.a lsopt interface library
SEE ALSO
tamc(1)
BUGS
AUTHOR
Written by Ralf Giering <Ralf.Giering Fastopt.de>