~ubuntu-branches/ubuntu/trusty/nwchem/trusty-proposed

« back to all changes in this revision

Viewing changes to src/tools/ga-5-2/ma/man/man3/MA_sizeof_overhead.3

  • Committer: Package Import Robot
  • Author(s): Michael Banck, Daniel Leidert, Andreas Tille, Michael Banck
  • Date: 2013-07-04 12:14:55 UTC
  • mfrom: (1.1.2)
  • Revision ID: package-import@ubuntu.com-20130704121455-5tvsx2qabor3nrui
Tags: 6.3-1
* New upstream release.
* Fixes anisotropic properties (Closes: #696361).
* New features include:
  + Multi-reference coupled cluster (MRCC) approaches
  + Hybrid DFT calculations with short-range HF 
  + New density-functionals including Minnesota (M08, M11) and HSE hybrid
    functionals
  + X-ray absorption spectroscopy (XAS) with TDDFT
  + Analytical gradients for the COSMO solvation model
  + Transition densities from TDDFT 
  + DFT+U and Electron-Transfer (ET) methods for plane wave calculations
  + Exploitation of space group symmetry in plane wave geometry optimizations
  + Local density of states (LDOS) collective variable added to Metadynamics
  + Various new XC functionals added for plane wave calculations, including
    hybrid and range-corrected ones
  + Electric field gradients with relativistic corrections 
  + Nudged Elastic Band optimization method
  + Updated basis sets and ECPs 

[ Daniel Leidert ]
* debian/watch: Fixed.

[ Andreas Tille ]
* debian/upstream: References

[ Michael Banck ]
* debian/upstream (Name): New field.
* debian/patches/02_makefile_flags.patch: Refreshed.
* debian/patches/06_statfs_kfreebsd.patch: Likewise.
* debian/patches/07_ga_target_force_linux.patch: Likewise.
* debian/patches/05_avoid_inline_assembler.patch: Removed, no longer needed.
* debian/patches/09_backported_6.1.1_fixes.patch: Likewise.
* debian/control (Build-Depends): Added gfortran-4.7 and gcc-4.7.
* debian/patches/10_force_gcc-4.7.patch: New patch, explicitly sets
  gfortran-4.7 and gcc-4.7, fixes test suite hang with gcc-4.8 (Closes:
  #701328, #713262).
* debian/testsuite: Added tests for COSMO analytical gradients and MRCC.
* debian/rules (MRCC_METHODS): New variable, required to enable MRCC methods.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH MA_SIZEOF_OVERHEAD 3 "20 February 1997" "MA Release 1.8" "MA LIBRARY ROUTINES"
 
2
.SH NAME
 
3
MA_sizeof_overhead -
 
4
compute size of block overhead
 
5
.SH "C SYNOPSIS"
 
6
.nf
 
7
#include "macdecls.h"
 
8
 
 
9
Integer MA_sizeof_overhead(datatype)
 
10
    Integer     datatype;       /* read-only */
 
11
.fi
 
12
.SH "FORTRAN SYNOPSIS"
 
13
.nf
 
14
#include "mafdecls.fh"
 
15
 
 
16
integer function MA_sizeof_overhead(datatype)
 
17
    integer     datatype
 
18
.fi
 
19
.SH DESCRIPTION
 
20
MA_sizeof_overhead() returns the number of elements of type
 
21
.I datatype
 
22
required to contain the worst case number of bytes of overhead for any block.
 
23
.SH USAGE
 
24
The following FORTRAN code illustrates the use of MA_sizeof_overhead()
 
25
by computing the space required for
 
26
100 integers in 5 allocations in the heap,
 
27
200 logicals in 4 allocations in the heap,
 
28
300 reals in 3 allocations in the stack,
 
29
and 400 doubles in 2 allocations in the stack.
 
30
 
 
31
.nf
 
32
#include "mafdecls.fh"
 
33
 
 
34
    logical ok
 
35
    integer heap_bytes_data
 
36
    integer heap_bytes_overhead
 
37
    integer heap_bytes_total
 
38
    integer stack_bytes_data
 
39
    integer stack_bytes_overhead
 
40
    integer stack_bytes_total
 
41
 
 
42
    heap_bytes_data = MA_sizeof(MT_INT, 100, MT_BYTE)
 
43
                    + MA_sizeof(MT_LOG, 200, MT_BYTE)
 
44
    heap_bytes_overhead = (5 + 4) * MA_sizeof_overhead(MT_BYTE)
 
45
    heap_bytes_total = heap_bytes_data + heap_bytes_overhead
 
46
    stack_bytes_data = MA_sizeof(MT_REAL, 300, MT_BYTE)
 
47
                     + MA_sizeof(MT_DBL, 400, MT_BYTE)
 
48
    stack_bytes_overhead = (3 + 2) * MA_sizeof_overhead(MT_BYTE)
 
49
    stack_bytes_total = stack_bytes_data + stack_bytes_overhead
 
50
    ok = MA_init(MT_BYTE, stack_bytes_total, heap_bytes_total)
 
51
.fi
 
52
.SH DIAGNOSTICS
 
53
unable to set sizes of FORTRAN datatypes
 
54
.in +0.5i
 
55
This indicates either that the internal state of MA is corrupted
 
56
or that there is a problem in the C-FORTRAN linkage.
 
57
.in
 
58
invalid datatype: %d
 
59
.in +0.5i
 
60
.I datatype
 
61
must be one of those listed in macdecls.h or mafdecls.fh.
 
62
.in
 
63
.SH "RETURN VALUE"
 
64
C: The number of elements, as described above.
 
65
.br
 
66
FORTRAN: The number of elements, as described above.
 
67
.\" .SH NOTES
 
68
.SH FILES
 
69
.nf
 
70
Include files: /msrc/proj/hpctools/ma/release/current/include
 
71
Library:       /msrc/proj/hpctools/ma/release/current/lib/\fIplatform\fR/libma.a
 
72
Man pages:     /msrc/proj/hpctools/ma/release/current/man/man3
 
73
Source code:   /msrc/proj/hpctools/ma/release/current/tar/ma\fIrelease\fR.tar
 
74
.fi
 
75
.SH "SEE ALSO"
 
76
.na
 
77
MA(3),
 
78
MA_sizeof(3)
 
79
.ad
 
80
.SH AUTHOR
 
81
Gregory S. Thomas, Pacific Northwest National Laboratory