summaryrefslogtreecommitdiff
path: root/Dragon/src/NXT.f
blob: 566250fc2a740497786a9f44ef04588daed987a6 (plain)
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
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
*DECK NXT
      SUBROUTINE NXT(NENTRY,HENTRY,IENTRY,JENTRY,KENTRY)
*
*-----------------------------------------------------------------------
*
*Purpose:
* Module used to analyze and track a geometry data structure based 
* on the new EXCELL type procedure.
*
*Copyright:
* Copyright (C) 2005 Ecole Polytechnique de Montreal
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
*Author(s):
* G. Marleau
*
*Parameters: input
* NENTRY  number of data structures transfered to this module.
* HENTRY  name of the data structures.
* IENTRY  data structure type where:
*         =1 for LCM memory object;
*         =2 for XSM file;
*         =3 for sequential binary file;
*         =4 for sequential ASCII file.
* JENTRY  access permission for the data structure where:
*         =0 for a data structure in creation mode;
*         =1 for a data structure in modifications mode;
*         =2 for a data structure in read-only mode.
* KENTRY  data structure pointer.
*
*Reference:
*  G. Marleau,
*  New Geometries Processing in DRAGON: The NXT: Module,
*  Report IGE-260, Polytechnique Montreal,
*  Montreal, 2005.
*
*Comments:
* Instructions for the use of the NXT: module:
*   Option 1 -- Analyze and optionnally track a basic geometry
*   [ TRKFIL ] VOLTRK     := NXT: GEOMETRY :: (nxtget) ;
*   Option 2 -- Track a geometry already analyzed
*   TRKFIL     VOLTRK     := NXT: VOLTRK   :: (nxtget) ;
*   where
*     TRKFIL   : sequential binary tracking file to be created
*     VOLTRK   : tracking data structure
*                (signature L_TRACK)
*     GEOMETRY : geometry data structure
*                (signature L_GEOM)
*     (nxtget) : Processing options
*                (read from input using the NXTGET routine).
*
*-----------------------------------------------------------------------
*
      USE              GANLIB
      IMPLICIT         NONE
*----
*  Subroutine arguments
*----
      INTEGER          NENTRY,IENTRY(NENTRY),JENTRY(NENTRY)
      TYPE(C_PTR)      KENTRY(NENTRY)
      CHARACTER        HENTRY(NENTRY)*12
*----
*  Local parameters
*----
      INTEGER          IOUT
      CHARACTER        NAMSBR*6
      PARAMETER       (IOUT=6,NAMSBR='NXT   ')
      INTEGER          ILCMUP,ILCMDN
      PARAMETER       (ILCMUP=1,ILCMDN=2)
      INTEGER          NSTATE,MAXENT
      PARAMETER       (NSTATE=40,MAXENT=2)
      INTEGER          IUTYPE
      PARAMETER       (IUTYPE=2)
*----
*  Local variables
*----
      TYPE(C_PTR)      IPGEO,IPTRK
      INTEGER          IMGEO,IMTRK,IFTRK,IMFTRK
      INTEGER          IGANA,IGTRK
      INTEGER          IEN,ITC
      INTEGER          IQUA10,IBIHET
      CHARACTER        HSIGN*12
      CHARACTER        TEXT12*12
      INTEGER          ISTATT(NSTATE)
      REAL             RSTATT(NSTATE)
      CHARACTER        TITLE*72
      INTEGER          IPRINT,ITITL(18)
      INTEGER          NBSLIN
      INTEGER          ILONG,ITYLCM
*----
*  Validate entry parameters
*----
      IF(NENTRY .LT. 2) CALL XABORT(NAMSBR//
     >  ': At least two data structures required')
      IF(NENTRY .GT. 3) CALL XABORT(NAMSBR//
     >  ': Maximum of three data structures permitted')
      IPGEO=C_NULL_PTR
      IMGEO=0
      IPTRK=C_NULL_PTR
      IMTRK=0
      IFTRK=0
      IMFTRK=0
      IGANA=0
      IGTRK=0
      NBSLIN=100000
*----
*  Scan data structure to determine type and mode
*----
      DO IEN=1,NENTRY
        IF(IENTRY(IEN) .EQ. 1 .OR. IENTRY(IEN) .EQ. 2) THEN
          IF(JENTRY(IEN) .EQ. 0) THEN
            IPTRK=KENTRY(IEN)
            IMTRK=2
            HSIGN='L_TRACK     '
            CALL LCMPTC(IPTRK,'SIGNATURE',12,HSIGN)
            HSIGN='EXCELL'
            CALL LCMPTC(IPTRK,'TRACK-TYPE',12,HSIGN)
          ELSE
            CALL LCMGTC(KENTRY(IEN),'SIGNATURE',12,HSIGN)
            IF(HSIGN .EQ. 'L_GEOM') THEN
              IPGEO=KENTRY(IEN)
              IF(JENTRY(IEN) .NE. 2) CALL XABORT(NAMSBR//
     >        ': Geometry data structure not in read-only mode')
              TEXT12=HENTRY(IEN)
              CALL LCMPTC(IPTRK,'LINK.GEOM',12,TEXT12)
              IMGEO=-1
            ELSE IF(HSIGN .EQ. 'L_TRACK') THEN
              IPTRK=KENTRY(IEN)
              IF(JENTRY(IEN) .NE. 1) CALL XABORT(NAMSBR//
     >        ': Tracking data structure not in update mode')
              IMTRK=1
              CALL LCMGTC(IPTRK,'TRACK-TYPE',12,HSIGN)
              IF(HSIGN .NE. 'EXCELL') CALL XABORT(NAMSBR//
     >        ': Tracking data structure type is invalid')
            ELSE
              CALL XABORT(NAMSBR//
     >        ': Invalid signature for '//HENTRY(IEN))
            ENDIF
          ENDIF
        ELSE IF(IENTRY(IEN) .EQ. 3) THEN
          IF(JENTRY(IEN) .NE. 0) CALL XABORT(NAMSBR//
     >        ': Geometry data structure not in creation mode')
          IFTRK=FILUNIT(KENTRY(IEN))
          IMFTRK=2
        ELSE
          CALL XABORT(NAMSBR//
     >    ': Invalid data structure format for '//HENTRY(IEN))
        ENDIF
      ENDDO
*----
*  Select processing option from data structures provided
*----
      IF(IMGEO .EQ. -1) THEN
        IF(IMTRK .NE. 2) CALL XABORT(NAMSBR//
     >  ': Creation mode tracking data structure required')
        IGANA=1
        IF(IMFTRK .EQ. 2) IGTRK=1
      ELSE IF(IMTRK .EQ. 1) THEN
        IF(IMFTRK .NE. 2) CALL XABORT(NAMSBR//
     >  ': Creation mode tracking file required')
        IGTRK=1
      ELSE
        CALL XABORT(NAMSBR//': No processing option identified')
      ENDIF
*----
*  Initialize tracking parameters to 0
*----
      ISTATT(:NSTATE)=0
      RSTATT(:NSTATE)=0.0
*----
*  Read state vectors available
*----
      IF(IMTRK .EQ.  1) THEN
        CALL LCMGET(IPTRK,'STATE-VECTOR',ISTATT)
        CALL LCMGET(IPTRK,'EXCELTRACKOP',RSTATT)
        CALL LCMGET(IPTRK,'TITLE',ITITL)
        WRITE(TITLE,'(18A4)') (ITITL(ITC),ITC=1,18)
        IF(ISTATT(7) .NE. 4 ) CALL XABORT(NAMSBR//
     >  ': Tracking data structure incompatible with current module')
        ISTATT(23)=1
      ELSE
*----
*  Define default tracking options that are different from 0
*----
        ISTATT(6)=1
        ISTATT(7)=4
        ISTATT(11)=1
        ISTATT(12)=-1
        ISTATT(13)=1
        ISTATT(15)=1
        ISTATT(22)=0
        ISTATT(23)=1
        IF(IMFTRK .EQ. 0) ISTATT(22)=3
        IF(IMTRK .EQ. 2 .AND. IMGEO .EQ. -1) THEN
          CALL LCMLEN(IPGEO,'BIHET',ILONG,ITYLCM)
          IF(ILONG.NE.0) ISTATT(40)=1
        ENDIF
        RSTATT(11)=1.0
        TITLE=' '
        HSIGN='EXCELL'
      ENDIF
*----
*  Recover processing option
*----
      CALL NXTGET(NSTATE,IPRINT,TITLE ,ISTATT,RSTATT,NBSLIN,IQUA10,
     >            IBIHET)
*----
*  Save updated STATE-VECTOR, TITLE and EXCELL track options
*  on tracking data structure
*----
      CALL LCMPUT(IPTRK,'STATE-VECTOR',NSTATE,1,ISTATT)
      CALL LCMPUT(IPTRK,'EXCELTRACKOP',NSTATE,2,RSTATT)
      READ(TITLE,'(18A4)') (ITITL(ITC),ITC=1,18)
      CALL LCMPUT(IPTRK,'TITLE',18,3,ITITL)
*----
*  Analyse geometry if required
*----
      IF(IGANA .EQ. 1) THEN
        CALL NXTACG(IPGEO ,IPTRK ,IPRINT)
      ENDIF
*----
*  If a prismatic 3D tracking is requested,
*  create 2D projected geometry analysis 
*----
      IF(ISTATT(39) .NE. 0) THEN
         CALL NXTPR3(IPTRK)     
      ENDIF
*----
*  Track geometry if required
*----
      IF(ISTATT(9) .GE. 0 .AND. ISTATT(23) .EQ. 1) THEN
        IF(ISTATT(39) .NE. 0) CALL LCMSIX(IPTRK,'PROJECTION',1)
        CALL NXTTCG(IPTRK ,IFTRK ,IPRINT,IGTRK ,NBSLIN)
        IF(ISTATT(39) .NE. 0) CALL LCMSIX(IPTRK,' ',2)
      ENDIF
*----
*  Add useful information for the Monte-Carlo method
*----
      IF(ISTATT(23) .EQ. -1) THEN
         CALL NXTMCA(IPTRK)
      ENDIF
*----
*  Process double heterogeneity (BIHET) data (if available)
*----
      IF(ISTATT(40) .NE. 0) THEN
         CALL XDRTBH(IPGEO,IPTRK,IQUA10,IBIHET,IPRINT,RSTATT(39))
      ENDIF
*----
*  Processing finished, return
*----
      IF(IPRINT .GT. 1) THEN
         CALL LCMGET(IPTRK,'STATE-VECTOR',ISTATT)
         WRITE(IOUT,100) (ISTATT(ITC),ITC=1,10)
         WRITE(IOUT,120) (ISTATT(ITC),ITC=11,22)
         WRITE(IOUT,130) ISTATT(23),ISTATT(25:27),ISTATT(40)
      ENDIF
      RETURN
*----
*  Warning formats
*----
  100 FORMAT(/
     1 14H STATE VECTOR:/
     2 7H NREG  ,I9,22H   (NUMBER OF REGIONS)/
     3 7H KPN   ,I9,23H   (NUMBER OF UNKNOWNS)/
     4 7H ILK   ,I9,39H   (0=LEAKAGE PRESENT/1=LEAKAGE ABSENT)/
     5 7H NBMIX ,I9,36H   (MAXIMUM NUMBER OF MIXTURES USED)/
     6 7H NSURF ,I9,29H   (NUMBER OF OUTER SURFACES)/
     7 7H NANI  ,I9,48H   (1=P0 CROSS SECTIONS/2=P1 CROSS SECTIONS/...)/
     8 7H GEOT  ,I9,21H   (TYPE OF GEOMETRY)/
     9 7H NORM  ,I9,48H   (NORMALIZATION OPTION 1=ABSENT/0=GLOBAL/-1=NO,
     1 21HRMALIZATION BY ANGLE)/
     2 7H TRKT  ,I9,36H   (TRACKING TYPE 0=FINITE/1=CYCLIC)/
     3 7H BOUND ,I9,48H   (BOUNDARY CONDITIONS TYPE 0=ISOTROPIC/1=SPECU,
     4 4HLAR))
  120 FORMAT(
     1 7H NANG  ,I9,30H   (NUMBER OF TRACKING ANGLES)/
     2 7H ASYM  ,I9,28H   (ANGULAR SYMMETRY FACTOR)/
     3 7H POLQUA,I9,32H   (POLAR ANGLE QUADRATURE TYPE)/
     4 7H POLOAQ,I9,33H   (POLAR ANGLE QUADRATURE ORDER)/
     5 7H AZMQUA,I9,47H   (AZIMUTHAL OR SOLID ANGULAR QUADRATURE TYPE)/
     6 7H NDIM  ,I9,25H   (NUMBER OF DIMENSIONS)/
     7 7H NPOINT,I9,40H   (NUMBER OF TRACKING POINTS ON A LINE)/
     8 7H MAXSGL,I9,30H   (MAXIMUM LENGTH OF A TRACK)/
     9 7H NTLINE,I9,37H   (TOTAL NUMBER OF TRACKS GENERATED)/
     1 7H NBTDIR,I9,47H   (TOTAL NUMBER OF TRACK DIRECTIONS PROCESSED)/
     2 7H NANGL ,I9,47H   (NUMBER OF TRACK DIRECTION ANGLES CONSIDERED,
     3 20H IN THE INTEGRATION)/
     4 7H INSB  ,I9,25H   (VECTORIZATION OPTION))
  130 FORMAT(
     1 7H ITRACK,I9,47H   (-1=MONTE-CARLO/0=DESACTIVATES TRACKING FILE,
     2 39H BUILD/1=ACTIVATES TRACKING FILE BUILD)/
     3 7H NPLANE,I9,39H   (NUMBER OF NORMAL PLANES CONSIDERED)/
     4 7H MERGMX,I9,33H   (0/1= MERGMIX ACTICATION FLAG)/
     5 7H NBATCH,I9,41H   (NUMBER OF TRACKS IN EACH OPENMP CORE)/
     6 7H IBIHET,I9,46H   (0/1=DOUBLE HETEROGENEITY IS NOT/IS ACTIVE))
      END