← Back to branch summary

~ubuntu-branches/ubuntu/utopic/nwchem/utopic

« back to all changes in this revision

Viewing changes to src/tools/ga-5-2/ma/man/man3/MA_get_index.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
http://bugs.debian.org/696361
* 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:
src/tools/ga-5-2/ma/man/man3/MA_get_index.3
 
1
.TH MA_GET_INDEX 3 "20 February 1997" "MA Release 1.8" "MA LIBRARY ROUTINES"
 
2
.SH NAME
 
3
MA_get_index -
 
4
get the base index for a block
 
5
.SH "C SYNOPSIS"
 
6
.nf
 
7
#include "macdecls.h"
 
8
 
 
9
Boolean MA_get_index(memhandle, index)
 
10
    Integer     memhandle;      /* read-only */
 
11
    Integer     *index;         /* write-only */
 
12
.fi
 
13
.SH "FORTRAN SYNOPSIS"
 
14
.nf
 
15
#include "mafdecls.fh"
 
16
 
 
17
logical function MA_get_index(memhandle, index)
 
18
    integer     memhandle
 
19
    integer     index
 
20
.fi
 
21
.SH DESCRIPTION
 
22
MA_get_index() returns in
 
23
.I index
 
24
the base index
 
25
for the type-specific data array that is appropriate
 
26
for the block corresponding to the handle
 
27
.I memhandle
 
28
(which was returned by MA_allocate_heap() or MA_push_stack()
 
29
when the block was allocated).
 
30
.SH USAGE
 
31
The following FORTRAN code illustrates the use of MA_get_index()
 
32
by allocating a block of 5 integers on the heap
 
33
and then storing values into the integers.
 
34
 
 
35
.nf
 
36
#include "mafdecls.fh"
 
37
 
 
38
    logical ok
 
39
    integer mhandle
 
40
    integer index
 
41
    integer i
 
42
 
 
43
    ok = MA_allocate_heap(MT_INT, 5, 'heap int block', mhandle)
 
44
    if (ok) then
 
45
        ok = MA_get_index(mhandle, index)
 
46
        if (ok) then
 
47
            do 10 i = 0, 4
 
48
                int_mb(index + i) = 0
 
49
10          continue
 
50
        endif
 
51
    endif
 
52
.fi
 
53
.SH DIAGNOSTICS
 
54
invalid memhandle: %d
 
55
.in +0.5i
 
56
.I memhandle
 
57
is not a valid handle.
 
58
.in
 
59
invalid checksum for memhandle %d (name: '%s')
 
60
.in +0.5i
 
61
The block's computed checksum does not match its stored checksum.
 
62
This indicates that the block has been corrupted
 
63
by having its internal state overwritten.
 
64
.in
 
65
invalid guard(s) for memhandle %d (name: '%s')
 
66
.in +0.5i
 
67
This indicates that the block has been corrupted
 
68
by being overwritten at one or both ends.
 
69
The likely cause of this is an application indexing bug.
 
70
.in
 
71
memhandle %d (name: '%s') not in heap or stack
 
72
.in +0.5i
 
73
The block is not currently allocated in the heap or the stack.
 
74
.in
 
75
 
 
76
Other diagnostics are possible.
 
77
If seen,
 
78
they indicate corruption of the internal state of MA,
 
79
caused by bugs in either MA or the application.
 
80
.SH "RETURN VALUE"
 
81
C: MA_TRUE upon success, MA_FALSE upon failure.
 
82
.br
 
83
FORTRAN: .true. upon success, .false. upon failure.
 
84
.SH NOTES
 
85
Type-specific data arrays are not yet available in C,
 
86
so employ pointers instead of indices
 
87
by using MA_get_pointer()
 
88
instead of MA_get_index().
 
89
.SH FILES
 
90
.nf
 
91
Include files: /msrc/proj/hpctools/ma/release/current/include
 
92
Library:       /msrc/proj/hpctools/ma/release/current/lib/\fIplatform\fR/libma.a
 
93
Man pages:     /msrc/proj/hpctools/ma/release/current/man/man3
 
94
Source code:   /msrc/proj/hpctools/ma/release/current/tar/ma\fIrelease\fR.tar
 
95
.fi
 
96
.SH "SEE ALSO"
 
97
.na
 
98
MA(3),
 
99
MA_alloc_get(3),
 
100
MA_allocate_heap(3),
 
101
MA_get_pointer(3),
 
102
MA_push_get(3),
 
103
MA_push_stack(3)
 
104
.ad
 
105
.SH AUTHOR
 
106
Gregory S. Thomas, Pacific Northwest National Laboratory