source: trunk/README @ 658

Last change on this file since 658 was 608, checked in by kulshres, 5 years ago

merge branch 'master' of 'gitclone' into 'svn'

The following commits have been merged:

commit 48aee4916d2ed907b772dbd1c1d6ce46cb273651
Author: Kshitij Kulshreshtha <kshitij@…>
Date: Mon Aug 10 21:28:49 2015 +0200

modernise configure.ac

disable static library building. this causes more
problems than it solves.

commit 47332811a4c5c27cb884f75792c910c813378ef4
Merge: 0ee77fd 0d4eeec
Author: Kshitij Kulshreshtha <kshitij@…>
Date: Thu Aug 6 22:33:46 2015 +0200

Merge branch 'edf-memory'

This is to reduce memory allocation and copying in ext_diff_fct

commit 0ee77fd33a1d6d55fcc67ad419937b2cb777ed4e
Author: Kshitij Kulshreshtha <kshitij@…>
Date: Wed Aug 5 15:49:33 2015 +0200

Remove empty file from dist

this can be created during compilation

Signed-off-by: Kshitij Kulshreshtha <kshitij@…>

commit 51505c34571aa61b4b21ebce6cdf1728ff56ddaa
Author: Kshitij Kulshreshtha <kshitij@…>
Date: Tue Aug 4 17:36:26 2015 +0200

adouble(const adub&) should match operator=(const adub&)

Signed-off-by: Kshitij Kulshreshtha <kshitij@…>

commit 03e49097aa0455337647d280cda530064987e6b9
Author: Kshitij Kulshreshtha <kshitij@…>
Date: Fri Jul 3 11:17:53 2015 +0200

make a define for default contiguous locations

this is not needed during compilation of the library
only during compilation of user-code, if the user
wants to have all adouble* allocations to have
contiguous locations.

Signed-off-by: Kshitij Kulshreshtha <kshitij@…>

commit f00cfb5d0dc8a8993581fd8c08dd8c6c5cd23248
Author: Kshitij Kulshreshtha <kshitij@…>
Date: Wed Jul 1 11:56:39 2015 +0200

rename adolc_lie.h to drivers.h

the old name led to an include <adolc/lie/adolc_lie.h>
which looks highly redundant.
new name makes for include <adolc/lie/drivers.h>

Signed-off-by: Kshitij Kulshreshtha <kshitij@…>

commit fcf78bf8426a227750a0bcaa32ff65e57ef329b8
Author: franke <mirko.franke@…>
Date: Wed May 20 16:39:16 2015 +0200

added Lie drivers

commit 0d4eeec7b6212aa64c8997db8a511f81b604b3e1
Author: Kshitij Kulshreshtha <kshitij@…>
Date: Fri Jun 26 14:19:41 2015 +0200

minimise extra memory requirement and copies in ext_diff

This should in theory reduce the amount of memory required
to run an external function with the old interface. It also
reduced some copying operations.

Fingers crossed that we've not broken checkpointing and/or
fixpoint iterations.

Signed-off-by: Kshitij Kulshreshtha <kshitij@…>

commit 8811f02a4d4a15946a18f7513ab17dada66509c3
Author: Kshitij Kulshreshtha <kshitij@…>
Date: Fri May 22 12:41:45 2015 +0200

try to streamline data copies in ext_diff_v2

Signed-off-by: Kshitij Kulshreshtha <kshitij@…>

File size: 3.2 KB
RevLine 
[1]1
[127]2     ADOL-C
[1]3
4This new version of ADOL-C features new library functions for
5
6  - sparse Jacobians and sparse Hessians
7  - external differentiated functions
8  - optimal checkpointing
9  - adapted differentiation of fixed point iterations
10  - parallel differentiation of OpenMP-parallel loops
[608]11  - Lie derivatives of scalar, vector and covector fields
[1]12   
13and many bug fixes.
14
15Furthermore the source code was adapted to allow a compilation with
16WINDOWS compilers. See file "INSTALL" for generic installation
17instructions and special instructions for the installation on a WINDOWS
18platform.
19 
20The complete documentation can be found in the subdirectory "doc".
21
22
23
24LOCAL INSTALLATION
25==================
26
271. Run configure with possibly using one of these options:
28
29  --prefix=PREFIX         install library and header files in PREFIX
30                          (default: ${HOME}/adolc_base)
31 
[106]32  --enable-sparse           build sparse drivers [default=no]
[1]33
34  --with-openmp-flag=FLAG use FLAG to enable OpenMP at compile time
35                          [default=none]
36
[106]37  --enable-docexa           build documented examples [default=no]
38  --enable-addexa           build additional examples [default=no]
39  --enable-parexa           build parallel example [default=no], if yes
[1]40                          -with-openmp-flag=FLAG required
41
42  --with-cflags=FLAGS     use CFLAGS=FLAGS (default: -O3 -Wall -ansi)
43  --with-cxxflags=FLAGS   use CXXFLAGS=FLAGS (default: -O3 -Wall)
44
452. Type make
46
473. Type make install
48
49   By default, `make install' will install all the files in ${PREFIX}/lib and
50   ${PREFIX}/include. You can specify another installation directory by using
51   the --prefix-option in the configure call.
52
53This procedure provides all makefiles required in the approporate directories.
54Execute 'configure --help' for more details on other available option.
55
56
57
58Nonlocal installation
59=====================
60
61As mentioned in INSTALL one can configure the adolc package to be installed
62in a different directory than "${HOME}/adolc_base" by using the "--prefix=PATH"
63configure option. This is typically used for global installations. Common PATHs
64are "/usr" and "/usr/local/", and others are known to be used. Fine control
65over the installation directories can be gained by supplying additional
66configure options. See "./configure --help" for details.
67
68Completing the installation by executing "make install" requires write
69permissions for all target directories. Make sure to have them or the result
70may be surprising otherwise.
71
72A global installation can be helpfull if many users need the library. By adding
73the library's path to "/etc/ld.so.conf" the usage of LD_LIBRARY_PATH and the
74"-L" link switch becomes unnecessary. In many cases, for instance for
75PATH=/usr/local, the use of the -I directive for compiling sources becomes
76unnecessary too.
77
78
79
80Examples
81========
82
83Examples must be configured to build by using the configure switches
[106]84   --enable-docexa or --enable-addexa.
[1]85They will never be installed by make install but can be found in the
86appropriate example subdirectory.
87
88
89
[106]90Windows Compilation with Visual Studio
91======================================
[1]92
[106]93Please refer to the file windows/Readme_VC++.txt for building the library and
94ADOL-C/examples/Readme_VC++.txt for the documented examples.
95
96
97
[1]98Enjoy this new version!
99
Note: See TracBrowser for help on using the repository browser.