-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathbug.html
2370 lines (2163 loc) · 91.2 KB
/
bug.html
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
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<HTML>
<CENTER><A HREF = "index.html">SPARTA WWW Site</A>
</CENTER>
<HR>
<H3>Latest Features and Bug Fixes in SPARTA
</H3>
<P>This page is a continuous listing of new features and bug fixes for
the SPARTA simulator.
</P>
<P>In some cases, new features change the syntax or operation of an
existing input script command, which can cause SPARTA output to
change, or even "break" an earlier working script. These cases are
highlighted below with a "BACKWARD COMPATIBILITY" note.
</P>
<P>To stay up-to-date with the current SPARTA, you can download the
current tarball from the <A HREF = "https://sjplimp.github.io/download.html">download page</A> at any time, and
re-build the code. It will include all the features/fixes listed
below.
</P>
<HR>
<H4><A NAME = "version"></A>What version of SPARTA do you have?
</H4>
<P>A SPARTA "version" is the date when it was released, such as 10 Aug
2014. SPARTA is updated continuously. Every time we fix a bug or add
a feature, we release it immediately, as listed below. Each dated
copy of SPARTA contains all the features and bug-fixes up to and
including that version date. The version date is printed to the
screen and logfile every time you run SPARTA. It is also in the file
src/version.h and in the SPARTA directory name created when you unpack
a tarball.
</P>
<UL><LI>If you browse the HTML or PDF doc pages on the SPARTA WWW site, they
always describe the most current version of SPARTA.
<LI>If you browse the HTML or PDF doc pages included in your tarball, they
describe the version you have.
</UL>
<HR>
<HR>
<P><B>20 Jan 2025</B>
</P>
<P>Details on what changed in this release are
<A HREF = "https://github.com/sparta/sparta/releases/tag/20Jan2025">here</A>
</P>
<P>Details for all releases are
<A HREF = "https://github.com/sparta/sparta/releases">here</A>
</P>
<P>Only new features or notable changes are highlighted here:
</P>
<UL><LI>Improved explicit to implicit surface conversion in <A HREF = "doc/create_isurf.html">create
isurf</A> command and added a new multi-point decrement for
DSMC ablation in <A HREF = "doc/fix_ablate.html">fix ablate</A> by Andrew Hong (SNL) in <A HREF = "https://github.com/sparta/sparta/pull/495">PR
#495</A>
<LI>More accurate mean free path and new mean collision time in <A HREF = "doc/compute_lambda_grid.html">compute
lambda/grid</A> by Arnaud Borner (NASA Ames) in <A HREF = "https://github.com/sparta/sparta/pull/282">PR
#282</A>
<LI>New <A HREF = "doc/compute_surf.html">compute surf</A> torque option by Steve Plimpton (SNL
retired) and Darrell Robertson (NASA Ames) in <A HREF = "https://github.com/sparta/sparta/pull/517">PR
#517</A>
<LI>Added <A HREF = "doc/fix_halt.html">fix halt</A> which can be used to stop a
simulation early based on a user-specified criteria, copied and
adapted from LAMMPS by Stan Moore (SNL) in <A HREF = "https://github.com/sparta/sparta/pull/524">PR
#524</A>
<LI>Use mean collision time in <A HREF = "doc/compute_lambda_grid.html">compute lambda/grid</A>
for variable timestepping in <A HREF = "doc/compute_dt_grid.html">compute dt/grid</A> by Alan
Stagg (SNL) in <A HREF = "https://github.com/sparta/sparta/pull/540">PR #540</A>
</UL>
<P>BACKWARD COMPATIBILITY: The syntax for <A HREF = "doc/compute_lambda_grid.html">compute lambda/grid</A> changed slightly.
</P>
<HR>
<P><B>4 Sep 2024</B>
</P>
<P>Details on what changed in this release are
<A HREF = "https://github.com/sparta/sparta/releases/tag/4Sep2024">here</A>
</P>
<P>Details for all releases are
<A HREF = "https://github.com/sparta/sparta/releases">here</A>
</P>
<P>Only new features or notable changes are highlighted here:
</P>
<UL><LI>Added <A HREF = "doc/create_isurf.html">create_isurf</A> command to convert explicit
surfaces to implicit surfaces by Andrew Hong (SNL) in <A HREF = "https://github.com/sparta/sparta/pull/447">PR
#447</A>
<LI>Added custom per-surf options to <A HREF = "doc/fix_emit_surf.html">fix
emit/surf</A> command by Steve Plimpton (SNL
retired) in <A HREF = "https://github.com/sparta/sparta/pull/491">PR #491</A>
<LI>Modified small corner value removal in
<A HREF = "doc/fix_ablate.html">fix_ablate</A> command by Andrew Hong (SNL) in <A HREF = "https://github.com/sparta/sparta/pull/463">PR
#463</A>
<LI>Added a <A HREF = "doc/variable.html">variable special function</A> which allows
particle-style variables to access per-grid quantities by Steve
Plimpton (SNL retired) in <A HREF = "https://github.com/sparta/sparta/pull/511">PR
#511</A>
<LI>Added momentum and energy contributions tallied by <A HREF = "doc/fix_emit_surf.html">fix
emit/surf</A> in the results of "compute surf" by
Zak Echo (SNL) in <A HREF = "https://github.com/sparta/sparta/pull/502">PR #502</A>
</UL>
<P>BACKWARD COMPATIBILITY: SPARTA now requires a C++11 compatible compiler
(KOKKOS package requires C++17).
</P>
<HR>
<P><B>7 Mar 2024</B>
</P>
<P>Details on what changed in this release are
<A HREF = "https://github.com/sparta/sparta/releases/tag/7Mar2024">here</A>
</P>
<P>Details for all releases are
<A HREF = "https://github.com/sparta/sparta/releases">here</A>
</P>
<P>Only new features or notable changes are highlighted here:
</P>
<UL><LI>Add <A HREF = "doc/fix_dt_reset.html">global variable time stepping</A> capability
by Alan Stagg (SNL) in <A HREF = "https://github.com/sparta/sparta/pull/385">PR
#385</A>
<LI>Enhance functionality of <A HREF = "doc/custom.html">custom attributes</A> for
particles, grid cells, and surface elements by Steve Plimpton (SNL
retired) in <A HREF = "https://github.com/sparta/sparta/pull/428">PR #428</A>
<LI>Add Kokkos support for <A HREF = "doc/compute_fft_grid.html">FFTs</A> by James
Almgren-Bell (UT Austin), Sam Mish (UC Davis), and Stan Moore (SNL) in
<A HREF = "https://github.com/sparta/sparta/pull/451">PR #451</A>
<LI>Port global and prob <A HREF = "doc/surf_react.html">surface reactions</A> to Kokkos
by Stan Moore (SNL) in <A HREF = "https://github.com/sparta/sparta/pull/396">PR
#396</A>
<LI>Add an option to <A HREF = "doc/compute_surf.html">compute surf</A> to compute the
chemical energy due to catalytic surface reactions by Arnaud Borner
(NASA Ames) in <A HREF = "https://github.com/sparta/sparta/pull/278">PR #278</A>
<LI>TCE chemistry enhancement (new option) + option to compute chemistry
rates without performing reaction by Arnaud Borner (NASA Ames) and
Mitchell Gosma (UIUC) in <A HREF = "https://github.com/sparta/sparta/pull/279">PR
#279</A>
<LI>Extend the <A HREF = "doc/dump.html">dump surf</A> command with the option to dump
the area of surface elements to file by Tim Teichmann (KIT) in <A HREF = "https://github.com/sparta/sparta/pull/438">PR
#438</A>
<LI>Introduce "nflux_incident" and "mflux_incident" to the
<A HREF = "doc/compute_surf.html">compute_surf</A> command by Tim Teichmann (KIT,
ITEP): in <A HREF = "https://github.com/sparta/sparta/pull/416">PR #416</A>
<LI>Add variable Np support to the <A HREF = "doc/fix_emit_surf.html">fix emit/surf</A>
command by Steve Plimpton (SNL retired) in <A HREF = "https://github.com/sparta/sparta/pull/409">PR
#409</A>
<LI>Do not emit particles in cells that are outside of the flow volume by
Tim Teichmann (KIT) in <A HREF = "https://github.com/sparta/sparta/pull/431">PR
#431</A>
</UL>
<P>BACKWARD COMPATIBILITY: The format of stored info in restart files
changed with the enhancement of custom attributes. Thus this version
of the code cannot read older restart files, and vice versa.
</P>
<HR>
<P><B>13 Apr 2023</B>
</P>
<P>Details on what changed in this release are
<A HREF = "https://github.com/sparta/sparta/releases/tag/13Apr2023">here</A>
</P>
<P>Details for all releases are
<A HREF = "https://github.com/sparta/sparta/releases">here</A>
</P>
<P>Only new features or notable changes are highlighted here:
</P>
<UL><LI>Added optimized particle move algorithm with <A HREF = "doc/global.html">global
optmove</A> setting, Alan Stagg (SNL), <A HREF = "https://github.com/sparta/sparta/pull/156">PR
#156</A>
<LI>Implemented a variable surface temperature model based on the
re-radiative equilibrium law, as <A HREF = "doc/fix_surf_temp.html">fix
surf/temp</A> command, Arnaud Borner (NASA Ames),
<A HREF = "https://github.com/sparta/sparta/pull/277">PR #277</A>
<LI>Moved ParaView unit and integration tests under SPARTA CI using CMake,
Tom Otahal (SNL), <A HREF = "https://github.com/sparta/sparta/pull/347">PR #347</A>
<LI>Added support for Python3, Stefan Fechter (DLR), <A HREF = "https://github.com/sparta/sparta/pull/355">PR
#355</A>, <A HREF = "https://github.com/sparta/sparta/pull/392">PR
#392</A>
<LI>Optimized Kokkos package, Stan Moore (SNL), <A HREF = "https://github.com/sparta/sparta/pull/357">PR
#357</A>, <A HREF = "https://github.com/sparta/sparta/pull/401">PR
#401</A>
<LI>Added support for custom per-grid data in the form of integer/double
vectors/arrays, Steve Plimpton, <A HREF = "https://github.com/sparta/sparta/pull/358">PR
#358</A>
<LI>Updated Kokkos library version bundled with SPARTA, Stan Moore (SNL),
<A HREF = "https://github.com/sparta/sparta/pull/367">PR #367</A>, <A HREF = "https://github.com/sparta/sparta/pull/394">PR
#394</A>
<LI>Refactored and improved <A HREF = "doc/Section_howto.html#howto_16">Paraview
documentation</A>, Thomas Otahal (SNL),
<A HREF = "https://github.com/sparta/sparta/pull/369">PR #369</A>
<LI>Added argon shock tube example, Jenny Horing and Marisa Petrusky (CU
Boulder), <A HREF = "https://github.com/sparta/sparta/pull/376">PR #376</A>
<LI>Enabled the <A HREF = "doc/create_particles.html">create_particles</A> command to
insert particles in cut and split cells which are overlapped by
surface elements, Steve Plimpton, <A HREF = "https://github.com/sparta/sparta/pull/381">PR
#381</A>
<LI>Enabled particle/reorder without collisions, Stan Moore (SNL), <A HREF = "https://github.com/sparta/sparta/pull/389">PR
#389</A>
</UL>
<HR>
<P><B>18 Jul 2022</B>
</P>
<P>Details on what changed in this release are
<A HREF = "https://github.com/sparta/sparta/releases/tag/18Jul2022">here</A>
</P>
<P>Details for all releases are
<A HREF = "https://github.com/sparta/sparta/releases">here</A>
</P>
<P>Only new features or notable changes are highlighted here:
</P>
<UL><LI>Update of Kokkos library version bundled with SPARTA, Stan Moore
(SNL), <A HREF = "https://github.com/sparta/sparta/pull/353">PR #353</A>, <A HREF = "https://github.com/sparta/sparta/pull/345">PR
#345</A>
<LI>New compute surf options, Steve Plimpton (SNL), <A HREF = "https://github.com/sparta/sparta/pull/344">PR
#344</A>
<LI>New averaging option for fix temp/rescale, Steve Plimpton (SNL), <A HREF = "https://github.com/sparta/sparta/pull/334">PR
#334</A>
<LI>Surf_collide specular no-slip option, Michael Gallis (SNL), <A HREF = "https://github.com/sparta/sparta/pull/324">PR
#324</A>
<LI>Surf_collide adiabatic model with isotropic scattering, Tim Teichmann
(KIT) <A HREF = "https://github.com/sparta/sparta/pull/329">PR #329</A>
</UL>
<HR>
<P><B>7 Jan 2022</B>
</P>
<P>Details on what changed in this release are
<A HREF = "https://github.com/sparta/sparta/releases/tag/7Jan2022">here</A>
</P>
<P>Details for all releases are
<A HREF = "https://github.com/sparta/sparta/releases">here</A>
</P>
<P>Only new features or notable changes are highlighted here:
</P>
<UL><LI>Update restart file to store all global options (<A HREF = "https://github.com/sparta/sparta/pull/316">PR
#316</A>), Stan Moore (SNL)
<LI>Add fix temp/global/rescale command to use as a global thermostat on
the temperature of the entire system (<A HREF = "https://github.com/sparta/sparta/pull/314">PR
#314</A>), Steve Plimpton (SNL)
<LI>Generalize surf collide rotation check to axisymmetric (<A HREF = "https://github.com/sparta/sparta/pull/311">PR
#311</A>), Steve Plimpton (SNL)
<LI>Allow Kokkos surf_collide_diffuse to use fixes with custom data (<A HREF = "https://github.com/sparta/sparta/pull/310">PR
#310</A>), Stan Moore (SNL)
<LI>Allow the maximum number or discrete vibrational modes to be extended
(<A HREF = "https://github.com/sparta/sparta/pull/307">PR #307</A>), Steve Plimpton
(SNL)
<LI>Add Kokkos version of fix ambipolar (<A HREF = "https://github.com/sparta/sparta/pull/304">PR
#304</A>), Stan Moore (SNL)
<LI>Add more general external fields (<A HREF = "https://github.com/sparta/sparta/pull/303">PR
#303</A>), Steve Plimpton (SNL)
<LI>Allow continuous rotational DOFs = 3 for complex molecular species
(<A HREF = "https://github.com/sparta/sparta/pull/301">PR #301</A>), Steve Plimpton
(SNL)
<LI>Update Kokkos library in SPARTA to v3.5.0 (<A HREF = "https://github.com/sparta/sparta/pull/300">PR
#300</A>), Stan Moore (SNL)
<LI>Enhancements to the Sparta ParaView tools to allow processing of very
large refined grids in parallel (<A HREF = "https://github.com/sparta/sparta/pull/299">PR
#299</A>), Thomas Otahal (SNL)
<LI>Add subset option to compute reduce (<A HREF = "https://github.com/sparta/sparta/pull/297">PR
#297</A>), Steve Plimpton (SNL)
<LI>Add fix temp/rescale command for thermostatting (<A HREF = "https://github.com/sparta/sparta/pull/296">PR
#296</A>), Steve Plimpton (SNL)
<LI>Add Exodus 2 format output to surf2paraview.py (<A HREF = "https://github.com/sparta/sparta/pull/295">PR
#295</A>), Thomas Otahal (SNL)
<LI>Enable reaction tallying in computes for on-surface reactions (<A HREF = "https://github.com/sparta/sparta/pull/294">PR
#294</A>), Steve Plimpton (SNL)
<LI>Add nflux to compute_boundary and compute_surf commands (<A HREF = "https://github.com/sparta/sparta/pull/293">PR
#293</A>), Tim Teichmann (ITEP,
KIT)
</UL>
<P>BACKWARD COMPATIBILITY: The format of stored info in restart files
changed with the addition of global options. Thus this version of the
code cannot read older restart files, and vice versa.
</P>
<HR>
<P><B>20 Oct 2021</B>
</P>
<P>Details on what changed in this release are
<A HREF = "https://github.com/sparta/sparta/releases/tag/20Oct2021">here</A>
</P>
<P>Details for all releases are
<A HREF = "https://github.com/sparta/sparta/releases">here</A>
</P>
<P>Only new features or notable changes are highlighted here:
</P>
<UL><LI>Improve scalability of surf2grid algorithm for the persurf case (<A HREF = "https://github.com/sparta/sparta/pull/241">PR
#241</A>), Steve Plimpton (SNL)
<LI>Insure cut/split cell calculations work robustly when round-off issues
arise (<A HREF = "https://github.com/sparta/sparta/pull/244">PR #244</A>), Steve
Plimpton (SNL)
<LI>Add Kokkos support for tvib and custom per-particle attributes (fix
vibmode, compute tvib/grid) (<A HREF = "https://github.com/sparta/sparta/pull/251">PR
#251</A>), Stan Moore (SNL)
<LI>Allow Kokkos SPARTA to compile with the AMD HIP backend (<A HREF = "https://github.com/sparta/sparta/pull/255">PR
#255</A>), Stan Moore (SNL)
<LI>Update Kokkos library in SPARTA to v3.4.1 (<A HREF = "https://github.com/sparta/sparta/pull/256">PR
#256</A>), Stan Moore (SNL)
<LI>Change RNG in SPARTA from Park to Knuth algorithm (aka ran3 in
Numerical Recipes book) (<A HREF = "https://github.com/sparta/sparta/pull/266">PR
#266</A>), Michael Gallis
(SNL), Arnaud Borner (NASA), Stan Moore (SNL)
<LI>Fix issue with temperature varying rotational relaxation not
maintaining equilibrium at steady state (<A HREF = "https://github.com/sparta/sparta/pull/268">PR
#268</A>), Zakari Eckert (SNL)
<LI>Add nsplit to dump_grid command (<A HREF = "https://github.com/sparta/sparta/pull/272">PR
#272</A>), Tim Teichmann (KIT)
<LI>Add a surf_react adsorb model which allows for species to adsorb on
the surface and surface elements (or box faces) to store state about
what is adsorbed, which affects future reactions (<A HREF = "https://github.com/sparta/sparta/pull/128">PR
#128</A> and <A HREF = "https://github.com/sparta/sparta/pull/291">PR
#291</A>), Krishnan Gopalan
(NASA Ames) and Steve Plimpton (SNL)
<LI>Add grid-style variable option to fix ablate (<A HREF = "https://github.com/sparta/sparta/pull/292">PR
#292</A>), Steve Plimpton
</UL>
<P>BACKWARD COMPATIBILITY: The global surfpush command was removed.
Because the random number generator changed, simulations with this
versions will not exactly reproduce old simulations.
</P>
<P>This is the <A HREF = "patches/files.20Oct21">list of changed files</A> versus the
26Feb21 version.
</P>
<HR>
<P><B>26 Feb 2021</B>
</P>
<P>Details on what changed in this release are
<A HREF = "https://github.com/sparta/sparta/releases/tag/26Feb2021">here</A>
</P>
<P>Details for all releases are
<A HREF = "https://github.com/sparta/sparta/releases">here</A>
</P>
<P>Only new features or notable changes are highlighted here:
</P>
<UL><LI>Added new radius/only cell weighting mode for axisymmetric
simulations. See the <A HREF = "global.html">global weight</A> command. <A HREF = "https://github.com/sparta/sparta/pull/211">PR
#211</A> and <A HREF = "https://github.com/sparta/sparta/pull/236">PR
#236</A>
<LI>Extended the <A HREF = "global.html">global mem/limit</A> command to also work for
acquiring ghost cells. <A HREF = "https://github.com/sparta/sparta/pull/220">PR
#220</A>
<LI>Updated the Kokkos library bundled with SPARTA. <A HREF = "https://github.com/sparta/sparta/pull/230">PR
#230</A>
<LI>Updated the grid2paraview.py tool to read new grid file format that
does not have parent information (Tom Otahal, SNL), <A HREF = "https://github.com/sparta/sparta/pull/212">PR
#212</A>
<LI>Various other small bugfixes since the last patch
</UL>
<P>This is the <A HREF = "patches/files.26Feb21">list of changed files</A> versus the
20Nov20 version.
</P>
<HR>
<P><B>20 Nov 2020</B>
</P>
<P>Details on what changed in this release are
<A HREF = "https://github.com/sparta/sparta/releases/tag/20Nov2020">here</A>
</P>
<P>Details for all releases are
<A HREF = "https://github.com/sparta/sparta/releases">here</A>
</P>
<P>Only new features or notable changes are highlighted here:
</P>
<UL><LI>Removed parent cells from the data structures used to store the
logical structure of the hierarchical grid used in SPARTA. Each
processor now stores only the child cells it owns (plus ghost child
cells). For large grids with many levels of adaptation this reduces
the memory cost significantly, since previously each processor stored
a copy of all the parent cells. <A HREF = "https://github.com/sparta/sparta/pull/192">PR
#192</A>
<LI>Distributed explicit surfaces can now be used with grid adaptation,
via the <A HREF = "doc/adapt_grid.html">adapt_grid</A> and <A HREF = "doc/fix_adapt.html">fix
adapt</A> commands. <A HREF = "https://github.com/sparta/sparta/pull/192">PR
#192</A>
<LI>The <A HREF = "doc/global.html">global cellmax</A> command was removed, since it is
no longer needed. The algorithm that used it for mapping surface
elements to grid cells was reformulated since it previously relied on
parent cells. <A HREF = "https://github.com/sparta/sparta/pull/192">PR
#192</A>
<LI>Added interspecies collision parameters (Ed Piekos, SNL), <A HREF = "https://github.com/sparta/sparta/pull/28">PR
#28</A>
<LI>Added CTest and CDash support (Evan Harvery, SNL), <A HREF = "https://github.com/sparta/sparta/pull/177">PR
#177</A>
</UL>
<P>BACKWARD COMPATIBILITY: The format of stored info in restart files
changed with the removal of parent cells. Thus this version of the
code cannot read older restart files, and vice versa.
</P>
<P>This is the <A HREF = "patches/files.20Nov20">list of changed files</A> versus the
6Jul20 version.
</P>
<HR>
<P><B>6 Jul 2020</B>
</P>
<P>Details on what changed in this release are
<A HREF = "https://github.com/sparta/sparta/releases/tag/6Jul2020">here</A>
</P>
<P>Details for all releases are
<A HREF = "https://github.com/sparta/sparta/releases">here</A>
</P>
<P>Only new features or notable changes are highlighted here:
</P>
<UL><LI>Enabled use of the ambipolar model with recombination reactions.
Includes a refactoring of group-based collisions, with or without the
ambiopolar model. See <A HREF = "https://github.com/sparta/sparta/pull/159">PR
#159</A>
<LI>Option to build SPARTA via CMake. See <A HREF = "https://github.com/sparta/sparta/pull/155">PR
#155</A>
<LI>Fixed some issues with reading/writing of restart files in low-memory
mode. See <A HREF = "https://github.com/sparta/sparta/pull/161">PR #161</A>
<LI>Fixed a bug with the compute tvib/grid command. See <A HREF = "https://github.com/sparta/sparta/pull/165">PR
#165</A>
</UL>
<P>This is the <A HREF = "patches/files.6Jul20">list of changed files</A> versus the
7May20 version.
</P>
<HR>
<P><B>7 May 2020</B>
</P>
<P>These are the updates in this release:
</P>
<UL><LI>Allow use of restart files larger than 2 GB.
<LI>Kokkos versions of the <A HREF = "doc/compute_property_grid.html">compute
property/grid</A> and <A HREF = "doc/compute_distsurf_grid.html">compute
distsurf/grid</A> comands.
<LI>Updated ParaView visualization scripts.
<LI>Various small bug fixes, mostly with recently added features.
</UL>
<P>NOTE: This release breaks restart file backwards compatibility, so an
old restart file created by a previous version of the code cannot be
used by the current code version.
</P>
<P>This is the <A HREF = "patches/files.7May20">list of changed files</A> versus the
24Jan20 version.
</P>
<HR>
<P><B>24 Jan 2020</B>
</P>
<P>Fixed a bug with grid adaptation introduced by recent code changes.
Also fixed a few other small bugs.
</P>
<P>This is the <A HREF = "patches/files.24Jan20">list of changed files</A> versus the
9Jan20 version.
</P>
<HR>
<P><B>9 Jan 2020</B>
</P>
<P>Fixed a small code issue in yesterday's release that broke
compilation with the -DSPARTA_BIGBIG flag, for running huge
simulations.
</P>
<P>This is the <A HREF = "patches/files.9Jan20">list of changed files</A> versus the
8Jan20 version.
</P>
<HR>
<P><B>8 Jan 2020</B>
</P>
<P>This patch release contains 3 new features:
</P>
<UL><LI>3 new computes which tally counts of reactions at surfaces
<LI>Options for transparent surfaces, useful for talling statistics
<LI>3 new surface collision models - work by Krishnan Gopalan (NASA)
</UL>
<P>More details:
</P>
<P>a) The new computes which tally surface reactions are <A HREF = "doc/compute_react_surf.html">compute
react/surf</A>, <A HREF = "doc/compute_react_isurf_grid.html">compute
react/isurf/grid</A>, and <A HREF = "doc/compute_react_boundary.html">compute
react/boundary</A>. <A HREF = "doc/compute_react_isurf_grid.html">Compute
react/isurf/grid</A> can be used with
the <A HREF = "doc/fix_ablate.html">fix ablate</A> comand to drive surface ablation,
either by itself or in conjunction with the <A HREF = "doc/fix_ave_grid.html">fix
ave/grid</A> command.
</P>
<P>In addition, when gas reactions are defined by the
<A HREF = "doc/react.html">react</A> command, or surface reactions are defined by
the <A HREF = "doc/surf_react.html">surf_react</A> command, the counts of each
reaction that occurred during a run are now printed to the screen and
logfile at the end of the run. This is discussed
<A HREF = "doc/Section_start.html#start_7">here</A>. The surface reaction
quantities are likewise stored by the <A HREF = "doc/surf_react.html">surf_react</A>
command, so that they can be accessed by <A HREF = "doc/variable.html">variables</A>
or <A HREF = "stats_style.html">stats</A> output.
</P>
<P>b) See the <A HREF = "doc/Section_howto.html#howto_15">Section Howto 6.15</A> doc page
for a description of how to define and use transparent surfaces.
</P>
<P>c) These are the new surface collision models:
</P>
<UL><LI>cll = Cercignani, Lampis, and Lord collision model
<LI>td = thermal desorption collision model from Krishnan Gopalan
<LI>impulsive = collision model for high translational and low internal energies, e.g. a beam of particles, also from Krishnan Gopalan
</UL>
<P>Details are described on the <A HREF = "doc/surf_collide.html">surf collide</A> doc
page.
</P>
<P>This is the <A HREF = "patches/files.8Jan20">list of changed files</A> versus the
15Oct19 version.
</P>
<HR>
<P><B>15 Oct 2019</B>
</P>
<P>Added the following commands to enable ablation modeling of implicit
surfaces:
</P>
<UL><LI><A HREF = "doc/fix_ablate.html">fix ablate</A>
<LI><A HREF = "doc/compute_isurf_grid.html">compute isurf/grid</A>
<LI><A HREF = "doc/write_isurf.html">write_isurf</A>
</UL>
<P>These files may also be useful. The former contains example input
scripts and log files. The latter gives an overview of ablation
modeling with SPARTA and the relevant commands to use.
</P>
<UL><LI>examples/ablation
<LI><A HREF = "doc/Section_howto.html#howto_14">doc/Section_howto.html#howto_14</A>
</UL>
<P>Also enabled use of a variable temperature in the <A HREF = "doc/surf_collide.html">surf_collide
diffuse</A> command, to model time-dependent
surface temperatures.
</P>
<P>This is the <A HREF = "patches/files.15Oct19">list of changed files</A> versus the
9Sep19 version.
</P>
<HR>
<P><B>9 Sep 2019</B>
</P>
<P>Extended the <A HREF = "doc/read_surf.html">read_surf</A>,
<A HREF = "doc/write_surf.html">write_surf</A>, and <A HREF = "doc/read_isurf.html">read_isurf</A>
commands to work with explicit, distributed, and implicit surfaces.
For simulations with large counts of explicit surfaces, multiple files
can be used so that the reading and writing can be done in parallel
from many processors. The explicit surface data file now has 2
formats, with and without a Points section. If the section is not
included, individual point coords are listed with the line and surface
elements. Lines and Triangles now have a unique ID. The lines and
triangles do not need to be listed in order in the file(s), which will
typically be the case in a file written when surface elements are
distributed.
</P>
<P>See the <A HREF = "doc/write_surf.html">write_surf</A> and
<A HREF = "doc/read_surf.html">read_surf</A> commands for details. Also added
support for the clip operation in the <A HREF = "doc/read_surf.html">read_surf</A>
command for distributed surfaces.
</P>
<P>Fixed a bug with the <A HREF = "doc/dump_image.html">dump image ssao</A> command
which was reading the dfactor parameter incorrectly.
</P>
<P>This is the <A HREF = "patches/files.9Sep19">list of changed files</A> versus the
16Apr19 version.
</P>
<HR>
<P><B>16 Apr 2019</B>
</P>
<P>Arnaud Borner (NASA Ames) added a marching cubes algorithm to enable
3d implicit surfaces (triangles) to be used in a simualation model.
</P>
<P>See these doc pages and example scripts for more info
on using 3d implicit surfaces in a simulation:
</P>
<UL><LI><A HREF = "doc/Section_howto.html#howto_13">Section howto 6.13</A>
<LI><A HREF = "doc/read_isurf.html">read_isurf</A> command
<LI><A HREF = "doc/Section_tools.html#implicit">tools/implicit_grid.py</A>
<LI>examples/implicit/in.implicit.3d.*
</UL>
<P>This is the <A HREF = "patches/files.16Apr19">list of changed files</A> versus the
15Apr19 version.
</P>
<HR>
<P><B>15 Apr 2019</B>
</P>
<P>Some bug fixes in the collision model (non hard-sphere case) and for
recombination reactions and the TCE reaction model. These were either
corner cases or small effects. Thanks to Israel Sebastiao (Purdue U),
Arnaud Borner (NASA Ames Research Center), and @j-d-fuhr (GitHub).
</P>
<P>Added rendezvous method for summing surface tallies for output.
Should be much faster for large surface element counts or large
processor counts.
</P>
<P>Various Kokkos optimizations.
</P>
<P>Low-memory version of reading/writing restart files via the <A HREF = "doc/global.html">global
mem/limit</A> command.
</P>
<P>Added some more statistics (mean, min, max, variance) to timing output
at the end of runs.
</P>
<P>This is the <A HREF = "patches/files.15Apr19">list of changed files</A> versus the
15Feb19 version.
</P>
<HR>
<P><B>15 Feb 2019</B>
</P>
<P>Added support for distributed surface elements and for implicit 2d
surfaces defined by grid cell corner point values. This means there
are 3 flavors of surfaces now supported: non-distributed explicit (as
before, the default), distributed explicit (new), and implict (new,
which are also distributed). The explicit distributed surfaces are
useful to save memory when huge numbers of surface elements are
defined. Implicit surfaces are useful for modeling porous materials
where the structure of the material may be determined by experimental
images.
</P>
<P>These are the doc pages, new or altered commands, tools, and examples
that were added to support these new features:
</P>
<UL><LI><A HREF = "doc/Section_howto.html#howto_13">Section howto 6.13</A>
<LI><A HREF = "doc/global.html">global surfs</A> command
<LI><A HREF = "doc/read_isurf.html">read_isurf</A> command
<LI><A HREF = "doc/Section_tools.html#jagged">tools/jagged2d.py</A>
<LI><A HREF = "doc/Section_tools.html#jagged">tools/jagged3d.py</A>
<LI><A HREF = "doc/Section_tools.html#implicit">tools/implicit_grid.py</A>
<LI>examples/jagged
<LI>examples/implicit
<LI>examples/circle/in.circle.distributed
<LI>examples/sphere/in.sphere.distributed
</UL>
<P>Note that not all commands related to surface processing are supported
by the new explcit or implicit surface options. However tests are
made and error messages should be printed when a not-yet-supported
commmand is used. See the discussion in <A HREF = "doc/Section_howto.html#howto_13">Section howto
6.13</A> for more details.
</P>
<P>This is the <A HREF = "patches/files.15Feb19">list of changed files</A> versus the
4Jan19 version.
</P>
<HR>
<P><B>4 Jan 2019</B>
</P>
<P>Added a new algorithm for mapping surface elements to grid cells. The
original algorithm can still be selected via the <A HREF = "doc/global.html">global
surfgrid</A> command. The <A HREF = "doc/global.html">global
cellmax</A> and <A HREF = "doc/global.html">global splitmax</A>
settings were also added.
</P>
<P>The new algorithm is the default for systems with large surface
element counts. It should be faster and more scalable than the
previous algorithm when the count of surface elements or processors is
large.
</P>
<P>An overflow bug when using extremely large grids was fixed.
</P>
<P>A new version of the KOKKOS is included in this patch release.
</P>
<P>This is the <A HREF = "patches/files.4Jan19">list of changed files</A> versus the
13Nov18 version.
</P>
<HR>
<P><B>13 Nov 2018</B>
</P>
<P>Made some internal changes to the surface element data structures.
Should not change the behavior of the code for users, but
it touches a lot of files.
</P>
<P>This is the <A HREF = "patches/files.13Nov18">list of changed files</A> versus the
29Oct18 version.
</P>
<HR>
<P><B>29 Oct 2018</B>
</P>
<P>Stan Moore and Alan Stagg (Sandia): Added a <A HREF = "doc/global.html">global
mem/limit</A> option to limit the memory allocated and
used when load-balancing or reordering particles. For very large
simulations which are memory bound this can enable the simulation to
run when one of these operations would otherwise run out of available
memory and generate an error. See <A HREF = "https://github.com/sparta/sparta/pull/12">PR
#12</A>.
</P>
<P>This is the <A HREF = "patches/files.29Oct18">list of changed files</A> versus the
24Oct18 version.
</P>
<HR>
<P><B>24 Oct 2018</B>
</P>
<P>Fixed a bug in the <A HREF = "doc/compute_tvib_grid.html">compute tvib/grid</A>
command when calculating vibrational temperatures of groups with
multiple species. See <A HREF = "https://github.com/sparta/sparta/pull/15">PR
#15</A>.
</P>
<P>This is the <A HREF = "patches/files.24Oct18">list of changed files</A> versus the
5Sep18 version.
</P>
<HR>
<P><B>5 Sep 2018</B>
</P>
<P>Stan Moore, Alan Stagg, and Tim Fuller (Sandia): Additions to KOKKOS
package to support TCE reactions, histogramming fixes, and several
computes. See <A HREF = "https://github.com/sparta/sparta/pull/11">PR #11</A>.
</P>
<P>Zhi-Hui Wang (University of Chinese Academy of Sciences (UCAS)) and
Israel Borges Sebastiao (Purdue University): Enhanced collision models
to use of omega averaged over the 2 species involved in a collision.
See <A HREF = "https://github.com/sparta/sparta/pull/10">PR #10</A>.
</P>
<P>Small bug fix for ambipolar reactions.
</P>
<P>This is the <A HREF = "patches/files.5Sep18">list of changed files</A> versus the
22Jun18 version.
</P>
<HR>
<P><B>22 Jun 2018</B>
</P>
<P>Added discrete vibrational energy modes to the collision and reaction
models. An optional species files with vibrational mode info on
polyatomic molecular species with 4,6,8 vibrational degrees of freedom
can be input. An overview of how to use this feature is give in
<A HREF = "doc/Section_howto.html#howto_12">Section 6.12</A> of the manual.
</P>
<P>See these commands for more details:
</P>
<UL><LI><A HREF = "doc/collide_modify.html">collide_modify vibrate no/smooth/discrete</A>
<LI><A HREF = "doc/species.html">species file ID1 ID2 ... vibfile vfile</A>
<LI><A HREF = "doc/fix_vibmode.html">fix vibmode</A>
</UL>
<P>There is an examples/vibrate directory with an example input
script that uses these options.
</P>
<P>This is the <A HREF = "patches/files.22Jun18">list of changed files</A> versus the
4Apr17 version.
</P>
<HR>
<P><B>4 Apr 2018</B>
</P>
<P>Stan Moore (Sandia) added an option to use per-processor CPU time as a
balancing metric to the <A HREF = "doc/balance_grid.html">balance_grid</A> and
<A HREF = "doc/fix_balance.html">fix_balance</A> commands.
</P>
<P>He also enabled the <A HREF = "doc/compute_boundary.html">compute boundary</A> and
<A HREF = "doc/surf_collide.html">surf_collide</A> commands to work with Kokkos.
</P>
<P>This version also includes a new version of the Kokkos library
included with SPARTA.
</P>
<P>This is the <A HREF = "patches/files.4Apr18">list of changed files</A> versus the
23Dec17 version.
</P>
<HR>
<P><B>23 Dec 2017</B>
</P>
<P>One more time ... must have drunk too much Christmas eggnog.
</P>
<P>This is the <A HREF = "patches/files.23Dec17">list of changed files</A> versus the
22Dec17 version.
</P>
<HR>
<P><B>22 Dec 2017</B>
</P>
<P>We forgot to include the Kokkos library itself in the SPARTA
disribution in the the 21 Dec 2017 version! This version has it.
See lib/README and lib/kokkos once you unpack the tarball.
</P>
<P>This is the <A HREF = "patches/files.22Dec17">list of changed files</A> versus the
21Dec17 version.
</P>
<HR>
<P><B>21 Dec 2017</B>
</P>
<P>Stan Moore, Dan Ibanez, and Tim Fuller (Sandia) have done heroic work
to enable SPARTA to work with the open-source <A HREF = "https://github.com/kokkos/kokkos">Kokkos
library</A>. This is implemented as a
new KOKKOS package in the code. For an application code like SPARTA,
Kokkos is designed to enable one set of source-code modifications to
run reasonably efficient on a variety of hardware, e.g. multi-core
CPU, GPU, and KNL nodes. See these sections of the manual for more
details:
</P>
<UL><LI><A HREF = "doc/Section_packages.html">Section packages</A>
<LI><A HREF = "doc/Section_accelerate.html">Section accelerate</A>
<LI><A HREF = "doc/accelerate_kokkos.html">KOKKOS package</A>
<LI><A HREF = "doc/suffix.html">suffix</A> command
<LI><A HREF = "doc/package.html">package</A> command
</UL>
<P>Note that only some styles and options within the code are
Kokkos-enabled at this point. This includes the basic move and
collide operations, including for geometries with hierarchical grids
and embedded surfaces. This <A HREF = "doc/Section_commands.html#cmd_5">Section
3.5</A> has (k) flags listed for fixes
and computes that have been adapated for Kokkos.
</P>
<P>We also plan to soon post some benchmark numbers on the SPARTA web
page to indicate what kind of performance is possible on different
node architectures (CPU, GPU, KNL) via Kokkos.
</P>
<P>The timing output produced at the end of a run was enhanced to include
info about fixes that operate during the timestepping. Depending on
the input script, some of these can invoke expensive operations
including compute commmands. This category of operation is now listed
as a "Modify" timing in the breakdown of the timestep.
</P>
<P>This is the <A HREF = "patches/files.21Dec17">list of changed files</A> versus the
27Jul17 version.
</P>
<HR>
<P><B>27 Jul 2017</B>
</P>
<P>Eric Emdee (PPPL) called attention to an incorrect use of uniform
versus Gaussian random numbers in the particle emission models from
the simulation box face or surfaces. This makes a small (~3%)
difference in the distribution of emitted particle velocities. The
following commands are affected:
</P>
<UL><LI><A HREF = "doc/fix_emit_face.html">fix emit/face</A>
<LI><A HREF = "doc/fix_emit_face_file.html">fix emit/face/file</A>
<LI><A HREF = "doc/fix_emit_surf.html">fix emit/surf</A>
<LI><A HREF = "doc/surf_collide.html">surf_collide diffuse</A>
</UL>
<P>This is the <A HREF = "patches/files.27Jul17">list of changed files</A> versus the
4 May 2017 version.
</P>
<HR>
<P><B>4 May 2017</B>
</P>
<P>Fixed a bug with the new <A HREF = "doc/surf_collide.html">surf_collide piston</A>
command which was not tallying properties correctly on the simulation
box boundary when particles were deleted. Also added a couple new
keywords to the <A HREF = "doc/compute_boundary.html">compute boundary</A> command
and made it's tallying similar to the <A HREF = "doc/compute_surf.html">compute
surf</A> command, by using weighted particle counts
for many of the keywords.
</P>
<P>Added grid groups via the <A HREF = "doc/group.html">group grid</A> command, similar
to surface element groups. This allows grid cells to be assigned to
one or more groups. The groups are now used as required or optional
arguments to several compute and fix commands as well as other
commands in this list, to optionally limit which grid cells
computations are performed for:
</P>
<UL><LI><A HREF = "doc/compute_grid.html">compute grid</A>
<LI><A HREF = "doc/compute_distsurf_grid.html">compute distsurf/grid</A>
<LI><A HREF = "doc/compute_eflux_grid.html">compute eflux/grid</A>
<LI><A HREF = "doc/compute_pflux_grid.html">compute pflux/grid</A>
<LI><A HREF = "doc/compute_property_grid.html">compute property/grid</A>
<LI><A HREF = "doc/compute_sonine_grid.html">compute sonine/grid</A>
<LI><A HREF = "doc/compute_thermal_grid.html">compute thermal/grid</A>
<LI><A HREF = "doc/compute_tvib_grid.html">compute tvib/grid</A>
<LI><A HREF = "doc/dump.html">dump grid </A>
<LI><A HREF = "doc/fix_ave_grid.html">fix ave/grid</A>
<LI><A HREF = "doc/fix_ave_histo.html">fix ave/histo</A>
<LI><A HREF = "doc/fix_ave_histo.html">fix ave/histo/weight</A>
<LI><A HREF = "doc/fix_adapt_grid.html">fix adapt/grid</A>
<LI><A HREF = "doc/adapt_grid.html">adapt_grid</A>
</UL>
<P>A new grid <I>group-ID</I> argument is required for the computes in the
list, is now implemented by the <A HREF = "doc/dump.html">dump grid</A> command (was
already an argument), and is required by the <A HREF = "doc/fix_ave_grid.html">fix
ave/grid</A>, <A HREF = "doc/fix_adapt_grid.html">fix
adapt/grid</A>, and
<A HREF = "doc/adapt_grid.html">adapt_grid</A> commands. A <I>group-ID</I> setting is a
new optional keyword for the <A HREF = "doc/fix_ave_histo.html">fix ave/histo</A>
and <A HREF = "doc/fix_ave_histo.html">fix ave/histo/weight</A> commands for grid
cell selection in the histogramming, as are new optional keywords
<I>region</I> and <I>mixture</I> for particle selection in the histogramming.
</P>
<P>BACKWARD COMPATIBILITY: This means the syntax for all of the commands
in the above list have changed (except dump grid and the fix ave/histo
commands) because they now require an additional grid group-ID
argument. The format of restart files also changes with this release,
because the grid group and surface element group information is now
stored differently.
</P>
<P>The grid cell group assignments persist when doing grid adaptation,
via the <A HREF = "doc/adapt_grid.html">adapt_grid</A> or <A HREF = "doc/fix_adapt_grid.html">fix
adapt/grid</A> commands, which means new refined
or coarsened grid cells inherit the same group assignment from their
predecessor cells.
</P>
<P>Fixed a bug when using <A HREF = "doc/adapt_grid.html">adaptive gridding</A>
with cell weighting via the <A HREF = "doc/global.html">global weight</A> command,
where the weights were not reset correctly for adapated grid cells.
</P>
<P>Added a <I>temperature</I> option to the
<A HREF = "doc/create_particles.html">create_particles</A> command to allow creation
of particles with a thermal temperature gradient.
</P>
<P>This is the <A HREF = "patches/files.4May17">list of changed files</A> versus the
4 Apr 2017 version.
</P>
<HR>
<P><B>4 Apr 2017</B>
</P>
<P>Added a new <A HREF = "doc/surf_collide.html">surf_collide piston</A> which can be
used on a simulation box boundary or a set of surface elements that
act like a boundary, as a subsonic pressure boundary condition.
</P>
<P>Added a new <A HREF = "doc/compute_fft_grid.html">compute fft/grid</A> command to
calculated 2d or 3d FFTs of per-grid quantities, so long as the
simulation grid is regular (not hierarchical). This can be used for
computing energy spectra in turbulent flows.
</P>
<P>Added <I>nwt</I> and <I>mflux</I> keywords to the <A HREF = "doc/compute_surf.html">compute