You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Updated example problems and README to include problems with remelting (#111)
* Updated example problems and README to include problems with remelting
* Don't run spot remelting example w/ 1 rank, modified README wording
Co-authored-by: MattRolchigo <[email protected]>
Copy file name to clipboardExpand all lines: README.md
+4-1Lines changed: 4 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -145,12 +145,15 @@ make install
145
145
ExaCA-Kokkos runs using an input file, passed on the command line. Example problems are provided in the `examples/` directory - A separate README file located in the `examples/` directory goes into more detail on the problem types, the optional and required arguments needed for each problem type, and additional files used by ExaCA. The example input files present in this repository are:
146
146
*`Inp_DirSolidification.txt`: simulates grain growth from a surface with a fixed thermal gradient and cooling rate
147
147
*`Inp_SmallDirSolidification.txt`: a smaller and simpler version of the previous
148
-
*`Inp_SpotMelt.txt`: simulates overlapping spot melts with fixed a fixed thermal gradient and cooling rate
148
+
*`Inp_SpotMelt.txt`: simulates overlapping spot melts with fixed a fixed thermal gradient and cooling rate, where cells are only allowed to undergo solidification one time (i.e., overlap regions only solidify when they've cooled below the liquidus for the final time in the simulation)
149
149
*`Inp_SmallSpotMelt.txt`: a smaller and simpler version of the previous
150
+
*`Inp_SpotMelt_RM.txt`: simulates overlapping spot melts with fixed a fixed thermal gradient and cooling rate, where cells in the overlap region are allowed to melt and solidify as many times as needed
151
+
*`Inp_SmallSpotMelt_RM.txt`: a smaller and simpler version of the previous
150
152
151
153
Example problems only possible with external data (available via https://github.com/LLNL/ExaCA-Data):
152
154
*`Inp_AMBenchMultilayer.txt`: simulates 4 layers of a representative even-odd layer alternating scan pattern for AM builds
153
155
*`Inp_SimpleRaster.txt`: simulates a single layer consisting of four overlapping melt pools
156
+
*`Inp_TwoLineTwoLayer.txt`: simulates two layers consisting of segments of two overlapping melt pools
154
157
155
158
Run by calling the created executable with an ExaCA input file:
Copy file name to clipboardExpand all lines: examples/README.md
+7-5Lines changed: 7 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
# ExaCA problem types and auxiliary files
2
-
ExaCA currently can model three types of problems:
2
+
ExaCA currently can model three types of problems, two of which have the option of whether or not to include multiple melting and solidification events in cells:
3
3
4
4
* Problem type C is a directional solidification problem, with the bottom surface initialized with some fraction of sites home to epitaxial grains and at the liquidus temperature and a positive thermal gradient in the +Z direction. The domain is then cooled at a constant rate.
5
5
* Problem type S is an array of hemispherical spots, with the number of spots in X, Y, and the number of layers for which the pattern is repeated (offset by a specified number of cells in the positive Z direction) specified. This problem type also uses fixed thermal gradient magnitude and cooling rate for each spot.
@@ -8,6 +8,7 @@ ExaCA currently can model three types of problems:
8
8
* Each line following the first should have six comma-separated values corresponding to x, y, z, tm, tl, cr. x, y, and z are cell coordinates, in meters, of a given location in the simulation. The spacing between locations should correpond to a Cartesian grid, with a cell size equivalent to that specified in the input file. For each time that an x,y,z coordinate went above and below the liqiuidus temperature of the alloy during a heat transport simulation, a tm (time at which the point went above the liquidus), tl (time at which the point went below the liquidus), and cr (instantaneous cooling rate at the liquidus) should be recorded.
9
9
* If an x,y,z coordinate melted and solidified multiple times, it should appear in the file multiple times on separate lines. The order of the lines do not matter, except that the header line must be before any data.
10
10
* The top surface (the largest Z coordinate in a file) is assumed to be flat. Additionally, if multiple temperature files are being used (for example, a scan pattern consisting of 10 layers of repeating even and odd file data), the Z coordinate corresponding to this flat top surface should be the same for all files.
11
+
* Problem types SM and RM modify problem types S and R to include multiple melting and solidification events per cell. For problem types S and R all cells that will eventually undergo melting are initialized as liquid, and only the final time that a given cell goes below the liquidus temperature is considered. To obtain the most accurate results, all melting and solidification events should be considered; however, for some problem geometries, the microstructure resulting from only considering the final solidification event in each cell is a reasonable approximation (and faster))
11
12
12
13
All problem types rely on two files in addition to the main input file. First,
13
14
a file containing the interfacial response function data governing
@@ -29,7 +30,7 @@ to simplfy use the file name in the input file. Custom files must either be
29
30
added to the ExaCA CMake build, use an absolute file path, or a path relative
30
31
to the ExaCA source.
31
32
32
-
Problems of type R rely on a third file for temperature input, with the path
33
+
Problems of type R or RM rely on a third file for temperature input, with the path
33
34
and name of this file given in the master input file. Examples of these
34
35
temperature field assembly files are given in
35
36
`examples/Temperatures/T_SimpleRaster.txt` and
@@ -47,6 +48,7 @@ The below lines are required regardless of problem type. They can be in any orde
47
48
| Problem type | C for directional solidification (thermal gradient in build direction, fixed cooling rate)
48
49
| | S for spot melt array problem (fixed thermal gradient/constant cooling rate for each hemispherical spot)
49
50
| | R for use of temperature data provided in the appropriate format (see README file in examples/Temperatures)
51
+
| | M should be appended to problem type if multiple melting and solidifcation events are desired (i.e, SM or RM)
50
52
| Decomposition strategy | 1 for a 1D domain decomposition along the Y direction
51
53
| | 2 for a decomposition along the Y direction, with a single partiton along the X direction
52
54
| | 3 for a decomposition with roughly equal partitions along the X and Y directions
@@ -78,7 +80,7 @@ All inputs are required.
78
80
| Domain size in z | Domain size in z
79
81
| Fraction surface sites active| What fraction of cells at the bottom surface of the domain are the source of a grain?
80
82
81
-
### Problem type S
83
+
### Problem type S or SM
82
84
Some additional inputs are optional while others are required
83
85
84
86
|Input | Required Y/N | Details |
@@ -100,7 +102,7 @@ Some additional inputs are optional while others are required
100
102
(a) One of these inputs must be provided, but not both
101
103
(b) This is optional, but if this is given, "Extend baseplate through layers" must be set to N
102
104
103
-
### Problem type R
105
+
### Problem type R or RM
104
106
Some additional inputs are optional while others are required
105
107
106
108
|Input | Required Y/N | Details |
@@ -129,7 +131,7 @@ A comment line starting with an asterisk separates the first half of the file, c
129
131
The deprecated form for temperature field input data, where these 3 input lines exist in the top level input file, alongside inputs "Number of temperature files in series: N" and "Temperature filename(s): Data.txt" (which would indicate reading temperature data from files "1Data.txt", "2Data.txt".... "NData.txt", is still allowed but will be removed in a future release.
130
132
131
133
## Additional optional inputs for all problem types
132
-
These values govern the printing intermediate data, for debugging or visualization, either following initialization or at specified increments during simulation
134
+
These values govern the printing intermediate data, for debugging or visualization, either following initialization or at specified increments during simulation. Debug check options are currently only available for simulations that do not include multiple melting/soldification events per cell (i.e., only problem types C, S, and R, not SM nor RM)
0 commit comments