File: basisinfo.h

package info (click to toggle)
ergo 3.8.2-1.1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 17,568 kB
  • sloc: cpp: 94,763; ansic: 17,785; sh: 10,701; makefile: 1,403; yacc: 127; lex: 116; awk: 23
file content (246 lines) | stat: -rw-r--r-- 7,492 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
/* Ergo, version 3.8.2, a program for linear scaling electronic structure
 * calculations.
 * Copyright (C) 2023 Elias Rudberg, Emanuel H. Rubensson, Pawel Salek,
 * and Anastasia Kruchinina.
 * 
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 * 
 * Primary academic reference:
 * Ergo: An open-source program for linear-scaling electronic structure
 * calculations,
 * Elias Rudberg, Emanuel H. Rubensson, Pawel Salek, and Anastasia
 * Kruchinina,
 * SoftwareX 7, 107 (2018),
 * <http://dx.doi.org/10.1016/j.softx.2018.03.005>
 * 
 * For further information about Ergo, see <http://www.ergoscf.org>.
 */

/** @file basisinfo.h

    \brief Code for setting up basis functions starting from shells.

    @author: Elias Rudberg <em>responsible</em>.
*/

#ifndef BASISINFO_HEADER
#define BASISINFO_HEADER

/* for NULL */
#include <stdlib.h>

#include "realtype.h"
#include "integral_info.h"
/* for Molecule */
#include "molecule.h"

#include "basisset.h"

struct DistributionSpecStruct {
  ergo_real coeff;           /**< Coefficient A */
  ergo_real exponent;        /**< exponent alfa */
  ergo_real extent;          /* FIXME ELIAS: remove this here since the "extent" you want to use depends on what you are doing? */
  ergo_real centerCoords[3]; /**< x0, y0, z0    */
  char monomialInts[4];  /**< nx, ny, nz    */
};

struct DistributionSpecStructLabeled {
  int basisFuncIndex_1;
  int basisFuncIndex_2;
  int pairIndex;
  int groupID;
  ergo_real limitingFactor; // squareroot of repulsion integral of this distr with itself.
  ergo_real dmatElement;
  DistributionSpecStruct distr;
};


#define MAX_NO_OF_CONTR_GAUSSIANS 20

struct ShellSpecStruct {
  ergo_real coeffList[MAX_NO_OF_CONTR_GAUSSIANS];
  ergo_real exponentList[MAX_NO_OF_CONTR_GAUSSIANS];
  ergo_real sizeList[MAX_NO_OF_CONTR_GAUSSIANS];
  ergo_real padding; /* We keep this for compatibility with old density files... */
  ergo_real centerCoords[3]; /* x0, y0, z0 */
  int noOfContr;
  int shellType; 
  int shell_ID;
  int noOfBasisFuncs;
  int startIndexInMatrix; /* start index in density matrix  */
  int dummy; /* padding to make sure the size of this structure is a multiple of 8 bytes */
};

struct BasisFuncStruct {
  int noOfContr;
  ergo_real coeffList[MAX_NO_OF_CONTR_GAUSSIANS];
  ergo_real exponentList[MAX_NO_OF_CONTR_GAUSSIANS];
  ergo_real extent;
  Vector3D centerCoords; /* x0, y0, z0 */
  int shellType; /* 0 <-> 's', 1 <-> 'p', 2 <-> 'd' etc */
  int functionNumber; /* -1,0,1 for 'p', -2,-1,0,1,2 for 'd', etc */
  int noOfSimplePrimitives;
  int simplePrimitiveIndex;
  int noOfTermsInPolynomial;
  basis_func_term_struct poly[MAX_NO_OF_TERMS_IN_BASIS_FUNC_POLY];
};


struct basis_set_range_struct {
  int startAtomIndex;
  int count;
  basisset_info* basisset;
};

struct BasissetNameRange {
  int startAtomIndex;
  int count;
  char* basisSetFileName;
};

struct BasisInfoStruct {
  int use_6_d_funcs; /**< Whether to use 6 d-type basis functions
			instead of the usual 5 functions. This option
			exists to make it possible to get results
			compatible with other codes that have d-type
			functions defined in that way.  */
  int noOfShells;
  ShellSpecStruct* shellList;
  int noOfBasisFuncs;
  BasisFuncStruct* basisFuncList;
  int noOfSimplePrimitives;
  DistributionSpecStruct* simplePrimitiveList;

  /** Initializes all the fields to sane values. */
  BasisInfoStruct(int use_6_d_funcs_ = 0);

  /** Copies values from another BasisInfoStruct. */
  BasisInfoStruct(const BasisInfoStruct & b);

  ~BasisInfoStruct();

  void addBasisfuncsForPoint(ergo_real x,
			     ergo_real y,
			     ergo_real z,
			     int shellType,
			     ergo_real exponent,
			     const IntegralInfo & integralInfo,
			     int print_raw,
			     int do_normalization,
			     int skip_sort_shells);

  void addBasisfuncsForAtomList(const Atom* atomList,
				int noOfAtoms,
				const basisset_info & basissetDefault,
				int noOfRanges,
				const basis_set_range_struct* rangeList,
				const IntegralInfo & integralInfo,
				int print_raw,
				int do_normalization,
				int skip_sort_shells);

  int addBasisfuncsForMolecule(const Molecule& molecule,
				  const char* basisset_filename_default,
				  int noOfRanges,
				  const BasissetNameRange* rangeList,
				  const IntegralInfo& integralInfo,
				  int print_raw,
				  int do_normalization,
				  int skip_sort_shells);

  static int getNoOfBasisFuncsForAtomType(const basisset_info & basisset,
					  const IntegralInfo & integralInfo,
					  int atomCharge,
					  int use_6_d_funcs);

  BasisInfoStruct *permuteShells(const int *shellMap,
                                 const IntegralInfo& ii) const;

  int normalizeShells(const IntegralInfo& integralInfo);

  int get_basis_funcs();

  int getSimplePrimitivesAll(const IntegralInfo& integralInfo);

  // Stuff needed for Chunks&Tasks usage
  void write_to_buffer ( char * dataBuffer, size_t const bufferSize ) const;
  size_t get_size() const;
  void assign_from_buffer ( char const * dataBuffer, size_t const bufferSize);
};



/** Provides temporary storage for
    compute_integral_of_square_of_basis_func.  Stack used to be the
    storage but many operating systems do not like to allocate so
    much space for stack, particularly when many threads are
    present. */
struct SquareFuncIntegrator {
  const int MAX_NO_OF_PRIMS;
  DistributionSpecStruct *list;
  DistributionSpecStruct *productlist;
SquareFuncIntegrator() :  MAX_NO_OF_PRIMS(44444)
  {
    list = new DistributionSpecStruct[MAX_NO_OF_PRIMS];
    productlist = new DistributionSpecStruct[MAX_NO_OF_PRIMS];
  }
  ~SquareFuncIntegrator() 
  {
    delete []list;
    delete []productlist;
  }
  ergo_real computeIntegralOfSquareOfBasisFunc
  (const IntegralInfo& integralInfo, BasisFuncStruct* basisFunc, int use_6_d_funcs);

  ergo_real getShellFactor(const IntegralInfo& integralInfo,
			   ergo_real exponent, int shellType, int use_6_d_funcs);
};




#ifdef ERGO_ENABLE_DEPRECATED

int basisinfo_construct_multi_basis(BasisInfoStruct* result_basisInfo, 
				    const Molecule* molecule,
				    const char* basisset_filename_default,
				    const Molecule* ghostMolecule,
				    const char* ghost_molecule_basisset_filename,
				    int noOfRanges,
				    const BasissetNameRange* rangeList,
				    IntegralInfo* integralInfo,
				    int print_raw,
				    int do_normalization,
				    int skip_sort_shells,
				    int skip_standard_basis);
struct AtomInfoStruct_{
  int charge;
  ergo_real coords[3];
};
typedef struct AtomInfoStruct_ AtomInfoStruct;
#endif

int get_basis_funcs(BasisInfoStruct* basisInfo,
		    const IntegralInfo* integralInfo,
		    int do_normalization);

int get_simple_primitives_all(BasisInfoStruct* basisInfo,
			      const IntegralInfo* integralInfo);

int output_basisinfo(const BasisInfoStruct & basisInfo);

ergo_real getSafeMaxDistance(const BasisInfoStruct & basisInfo);


#endif