NEWS

Thu, Nov 17, 2022 : Released Refine 3.0.0

- ref_axisymmeric has been incorperated into ref --axi
- installed binaries are now ref, refmpi, and refmpifull
- use a subset of cores when mesh is to small for nproc
- ref_grid_partitioner_full(ref_grid) = REF_TRUE to use all cores
- ref distance computes wall distance
- ref visualize translates solution formats
- ref collar inflates surface to create swept mesh for sonic boom

Mon, Sep 29, 2020 : Released Refine 1.9.3

- node insertion uses a native implementation of inverse evaluation
- ref adapt --spalding creates an initial viscous mesh via Spalding's Law
- ref distance computes wall distance to support flow solver turbulence model
- ref interp extended to mixed element meshes
- ref examine reports mesh/solb header data (size)
- oversized solb read results inx warning, not error
- git describe versioning uses + to separate sha metadata for module load
- 64bit integer METIS and ParMETIS supported
- ref adapt --implied-complexity [complexity] imply metric from input mesh

Mon, Jun  4, 2020 : Released Refine 1.9.2

- ref interp learned --face
- ref loop learned --usm3d for USM3D mixed-element version
- ref fun3d removed (use FUN3D sampling)
- ref loop learned --partioner and --mesh-extension options
- parallel Dimension 2 metric .sol and .solb reader
- added 2D .grid sequental format export 
- adopts OpenCSM defaults for global EGADS tess params
- native recursive bisection partitioning
- extraction of a mesh subset in a box
- multiscale metric for deforming grids
- initial MeshLink bootstrap and adaptation
- native alternating RCB partition
- uses edge UV directly without face inverse evaluation check
- exports cell centered solb
- 2D adaptation in parallel for no geometry

Mon, Feb 10, 2020 : Released Refine 1.9.1

- modules deploy with rpath to ESP/117
- swap and collapse normal deviation limits more conservative
- ref loop 2D adaptation with 2D l2projection gradient reconstruction
- 2D adaptation in parallel for an EGADS FACEBODY
- interpolate a single faceid of receptor from a donor for tunnel restart
- pliant smooth force linearly increased near zero to prevent short edges
- metric conformity statistics are reported for each face
- refmpifull boostrap surface adaptation is parallel, single part tess/vol fill
- ref bootstrap --auto-tparams EGADS .tParams for improved tess
- configure --with-mpi creates refmpi and refmpifull
- ideal tet and tri smoothing uses log average of vertex metrics
- cavity operator extended to simultaneous volume and surface changes
- gaps between surfaces at edges are used to limit curvature metric size
- curvature metric is applied to background metric once at initialization
- remove ref_driver -l limit metric change, sanitizing metric option
- continuous metric interpolation in parallel with background migration
- pliant vertex smoothing near metric conformity
- overhaul cavity operator to allow simultaneous tet and tri changes

Thu, Jul 18, 2019 : Released Refine 1.9.0

- background grid load balanced with adapted grid
- metric interpolation cached and reused when possible
- parallel artifacts reduced with subdivision allowed on geometry
- geometry constraint metric evaluated on background grid and interpolated
- geometry constraint metric anisotropic for CAD feature size
- geometry constraint metric gained edge curvature terms
- complexity estimates for surface-only adaptation
- ugrid64 format
- 64bit global node (and cell indexes)
- ref_inflate gained mapbc, family, and bc interface and parallel
- module deploys match FUN3D v13.5
- ref_cloud replaces ref_dict_aux for ref_recon
- degenerate face uv bounded by degenerate edge uv range
- interpolation to a subset of the domain
- add buffer option to fixed-point metric
- improve plotting of geometry curvature

Thu, Mar 22, 2019 : Released Refine 1.8.22

- continuously interpolated metric from background grid for sequential
- interpolation weights are clipped to prevent field and metric extrapolation
- ref_gather_scalar_tec exports one triangle faceid per zone
- surface adaptation cavity operator extended to edge splits
- curvature constraints near model tolerance are ignored
- curvature based metric includes isotropic geometry edge curvature
- curvature based metric defaults to 2 segments per radian (28 degrees)
- parmetis can be called on subset of processors (also avoids zero part input)
- use metis on smaller grids
- swap in 3D via cavity operator
- tetgen shell uses poly format to allow voids
- tetgen called with q2.0/10 to create coarser initial grids without slivers
- termination recommendation based on one percent edge-metric ratio limit change
- edge-metric ratio post floor more aggressive once ceiling drops below 3
- ref_adapt_parameter is private method
- ref_adapt_pass returns termination recommendation
- curvature based metric includes geometry topology feature size
- version 3 .meshb/.solb export for grids larger than 2 GBytes (10M vertex)
- ref_driver RCM global node order per processor on export
- ref_grid_pack uses RCM ordering
- ref_node_metric removed, use getters/setters, results in code speedup
- ref_metric_unit_node removed, metric initialized to unity during ref_node_add
- ref_metric_test --fixed-point asks for the timestep_increment

Tue, Nov 17, 2018 : Released Refine 1.8.21

- ref_driver repartitions before first pass to improve partition "shape"
- gather tecplot refactored for multiple scalars and T-infinity viz plugin
- added tri-surface normal deviation constraint
- added tri-surface normal deviation to smooth/swap tri quality
- ref_geom_test tessellation can be adapted before volume generation (w/ --surf)
- added non-parallel surface adaptation without volume (w/ swap)
- added non-parallel .su2 export
- extracted ref_recon from ref_metric
- ref_interp_test --field interpolates solution
- ref_metric_test --fixed-point metric from series of solb
- configuration does not need fortran compiler, gfortran or ifort assumed
- ref_metric_test --kexact parallel and can grow stencil for conditioning

Tue, Sep 11, 2018 : Released Refine 1.8.20

- added limits (current min/max) on ratio during operations
- sequential 2D continuously interpolates metric 

Thu, Aug 30, 2018 : Released Refine 1.8.19

- added histogram movies
- uv_area sign based on topology
- triangle windings are flipped for normal into domain
- cavity operator for edge split on boundary
- new implementation of tet smoothing via max-min optimization
- multiscale metric with L2-projection and kexact Hessian reconstruction
- edge subdiv to reduce parallel partition artifacts
- ParMETIS uses edge weights
- ref_geom .egads model can be tessellated with AFLR
- parallel localization of background grid
- global variables eliminated
- shared libraries linked with rpath
- source code google formatted via clang-format
- EGADSlite support
- meshb format caches EAGDSlite data and ref_geom CAD association
- parameter jumps in EGADS models stored explicitly
- eliminated const char * C++ warnings
- curvature based metric
- now under Apache, version 2
- ref_stitch removed
- ref_projectable removed, no longer supported
- ref_plot3d and ref_quality removed
- jacobian form of the mean ratio
- ref_geom parallel

Mon, Jun 26, 2017 : Released Refine 1.8.18

- ref_matrix repaired jacobian cost transform
- ref_smooth edge and face optimization with ref_geom
- added acceptance tests based on github.com/UGAWG
- ref_metric 3D metric interpolated (extrapolated on boundary, not parallel)
- ref_geom geometry association cached in a .gas file
- ref_geom .egads model can be tessellated with tetgen
- ref_geom can use EGADS for geometry evaluation
- refine/one fortran interface can now store hex elements without modification
- added tetgen .smesh output format
- 3D .meshb export now uses 0 to mark vertex and tetra ids. (triangles
  continue to use face/patch id)

Tue, Aug 23, 2016 : Released Refine 1.8.17

- added ref_usm3d2fun3d_mapbc ref_fun3d2usm3d_mapbc mapbc translation scripts
- ref_translate learned --rotate

Wed, Apr 27, 2016 : Released Refine 1.8.16

- refine/two fortran binding uses a single partition
- mid plane of twod grids in now a varaible (for pointwise)
- ref_export learned to extract twod grid to meshb format
- ref_export learned tecplot .plt
- ref_translate learned --scale
- ref_inflatable learned --rotate, --scale, and --origin
- ref_fefloa2d driver and ref_bamg_emulator added
- histogram fixed and made pretty for paper
- ref_arg created to parse arguments
- ref_metric_interpolate twod adapt uses background grid to interp metric 
- ref_surf2ugrid for debuging aflr3 problems
- ref_shard_prism_into_tet paralleized
- ref_import_bin_ugrid uses blocks to read contiguously (broke and fixed tags)
- ref_part uses blocks to read contiguously (face tags hop)
- ref_part uses longs for file offsets to read big grids
- ref_gather_cell contiguous faceids for cgns conversion 
- ref_adj better realloc heuristics for increased performance

Tue, Feb  3, 2015 : Released Refine 1.8.15

- implemented isotropic gradation control of anisotropic metric
- added Barral/McKenzie metric intersection
- quieted parMETIS debug statements that crashed MPI stdout buffers
- extended ref_inflatable use an origin at mean of Z min/max
- extended ref_inflatable to have an optional angle of attack argument

Mon, Apr 14, 2014 : Released Refine 1.8.14

- added missing BEGIN_C_DECLORATION C/C++ compatibility macros that
    should come in pairs

Mon, Mar 24, 2014 : Released Refine 1.8.13

- fix header error on SGI ICE due to wrong include location of parmetis.h
- eliminated compiler warnings 

Mon, Mar 10, 2014 : Released Refine 1.8.12

- allow use of older ParMETIS 3.* bindings

Wed, Feb 19, 2014 : Released Refine 1.8.11

- added ParMETIS bindings for testing with FUN3D
- ref_translate learned --shift
- overhaul of metric intersection to use more robust matrix sqrt

Mon, Jan 13, 2014 : Released Refine 1.8.10

- started software process and classification report
- started linearization of mean ratio quality
- meshb export, soln import of metric, fun3d .metric to soln converter
- ref_inflatable can extrude normally and radially  
- turned off ref_metric_sanitize metric SMR in fortran interface
- increased robustness of matrix inverse with pivot in metric SMR

Wed, Mar 13, 2013 : Released Refine 1.8.9

- Zoltan GRAPH LB_METHOD required callbacks added.
- improved load balancing for part boundary adapt
- fixed edge-based primitive logic
- add grid inflation (ref_inflatable) for sonic boom grids
- renamed convert to ref_translate; ref_projectable; ref_axisymmetric
- mem leak in gridparallelswap addressed
- x3d html output
- little endian .lb8.ugrid import
- removed dpw cruft
- removed ruby-wrapped unit tests to fix fun3d makedistcheck
- removed old refine executables

Wed Sep 12, 2012 : Released Refine 1.8.8

- limit boundary coarsening that effects curved surface normal in refine/two
- two/ref_axi more general about node pair ordering
- can impy metric of pyramid and hex
- stitch grids with pairs of faces interior to the domain

Wed May 2, 2012 : Released Refine 1.8.7

- fortran interface to refine/two modified for FUN3D

Wed Apr 18, 2012 : Released Refine 1.8.6 (1.8.5 broken)

- two/axisymmetric can convert some 2D grids into axi-symmetric grids
    (with many caveats)
- use autoconf standard FC_FUNC and FC_FUNC_ macros to name mangle
    fortran interfaces
- use config.h to define FC_FUNC_ (for xlf and xlc)

Thu Feb 16, 2012 : Released Refine 1.8.4

- towards eliminating the creatation of "collapsed cells", tets with 
  more then one boundary face: do not collapse if either node is frozen 
  (80768c4). added a cost constraint for tets with more then one 
  boundary face (2566eb8,b24f9fd)
- two/ref_axi_test can convert some 2D grids into axi-symmetric grids
  (with many caveats)

Thu Nov 17, 2011 : Released Refine 1.8.3

- package cleanup and include bootstrap

Mon Nov 7, 2011 : Released Refine 1.8.2

- to allow bootstrap outside of git repo

Wed Oct 26, 2011 : Released Refine 1.8.1 

- removed unused code.
- MesherX has been moved to a subdirectory and is no longer distributed
- started refine/two
- removed doc from distribution to eliminate texi2doc dependency
- unit tests work with ruby 1.9.2 (added '.' to load path)

Mon Jul 18, 2011 : Released Refine 1.8.0 (requires >= FUN3D-52844 (11.x.x)).

- fortran bindings extended for load balancing (gridgetmap_, 
   gridgetfreezestate_, and gridgetnaux_)

Thu Jul 7, 2011 : Released Refine 1.7.1 (requires >= FUN3D-52844 (11.x.x)).

- gridParallelPreProject only removes two and three face cells

Mon Apr 4, 2011 : Released Refine 1.7.0 (requires >= FUN3D-52844 (11.x.x)).

- This minor rev bump is an API change to elimiate global cell indexes and
    to restructure cell and face API for future mixed-element capability.
- compiled under Mac OS X
- pruned many unused methods

Fri Jan 21, 2011 : Released Refine 1.6.3 (requires >= FUN3D-45226 (11.0.0)).

- prevent NaN in volume node smoothing when faces are aligned. (was fixed
   for surface nodes Feb 7, 2005)

Thu Dec 23, 2010 : Released Refine 1.6.2 (requires >= FUN3D-45226 (11.0.0)).

- improved map (metric) and aux data interpolation durring edge collapse.

Fri Dec 10, 2010: Released Refine 1.6.1 (requires >= FUN3D-45226 (11.0.0)).

- fix bug in setting new node imesh for overset grid systems.
   (reported by Rajiv Shenoy of GA Tech)

Wed Oct 6, 2010: Released Refine 1.6.0 (requires >= FUN3D-45226 (11.0.0)).

- This minor rev bump is an API change to include imesh get/set to
    enable the use of overset grid systems.
- FAUXGeom cylinder pole direction can be flipped with sign of radius.

Tue Aug 24, 2010: Released Refine 1.5.2 (requires >= FUN3D-45226 (11.0.0)).

- fixed configure

Tue Aug 24, 2010: Released Refine 1.5.1 (requires >= FUN3D-45226 (11.0.0)).

- Changed the parallel node insertion and removal algorithm
    to be more consistant when sweeping through grid.
   (thanks to Rajiv Shenoy and James Cook of GA Tech for suggestion)
- Added refine-convert to convert grid file types.
- Mesh3D (Karman) and Fieldview import
- Elimiated intel version 10 compiler warnings.
- Fixed bug that would 'kink' geometry edges with FAUXGeom.
- GRI import/export dimensionality and element order added to support
    new file format

Fri Mar 26, 2010: Released Refine 1.5.0 (requires >= FUN3D-45226 (11.0.0)).

This minor rev bump is an API change to include unravel.
Added import and export of NGP grids for a DSMC code.

added NGP file import and export for file-based DSMC adaptation

Thu Jan 28, 2010: Released Refine 1.4.3 (requires >= FUN3D-25331 (10.4.0)).

FAUXGeom improved to allow cylindrical surfaces. (still need derivatives)

to repair arbitrary FAUXGeom planes by fixing NaN in 
gridmath.c(gridVectorOrthogonalize) and completing 
FAUXGeom.c(CADGeom_PointOnFace).

Fri Jan 16, 2009: Released Refine 1.4.2 (requires >= FUN3D-25331 (10.4.0)).

FAUXGeom improved to allow arbitrary planes or no faces.

A sensitivity to round-off error from Intel compiler optimizations in
the FUN3D metric construction has been reduced in recent versions of
FUN3D. If problems are reported in anisotropic_adapt_parameter update
FUN3D.

Thu Jan 3, 2008: Released Refine 1.4.1 (requires >= FUN3D-25331 (10.4.0)).

Improved INSTALL. lowered GRID_VOLUME_TOL and GRID_AREA_TOL to 1.0e-40 for
very small domains.

Thu Sep 27, 2007: Released Refine 1.4.0

API change to update ghost frozen state, requires >= FUN3D-25331 (10.4.0).
Fixed calls to correctly obtain GridEx SDK edge parameters.

Wed Apr 11, 2007: Released Refine 1.3.1

GTech release. Includes quick bug fix for the intersection of
projection, gridmove and frozen boundary layer.

Fri Apr 6, 2007: Released Refine 1.3.0

GTech release. Account for fun3d-23948 c2n index flip. Incudes
FAUXGeom (reads input file for planar geometry instead of needed to
edit C files). Fixes edge parameter parallel consistency.

Wed Feb 20, 2007: Released Refine 1.2.14

Added ProjectX .gri format export.

Wed Jul 5, 2006: Released Refine 1.2.13

For Tin-Chee. Fixed up INSTALL directions.

Tue Jun 27, 2006: Released Refine 1.2.12

For Pawel MSL RCS work on Columbia.  To include parallel bug fixes
(prevent hanging nodes) while removing cells that can cause projection
failures.

Tue Mar 28, 2006: Released Refine 1.2.11

FUN3D interface change: provides new gridparallelpreproject_
to extract the distributed pre projection topology checks to
a single function call to be called just before projection

Rewound the aggressive adaptation to the old method that would only
change one edge incident to a node per adaptation sweep. The aggressive
method (use_a_plan) caused trouble for the sle case.

Thu Feb 16, 2006: Released Refine 1.2.10

Can now cache the current grid and map for linear interpolation of
original map function. Continued with a Phased approach to
adaptation, where the second phase is modify CAD faces only. A direct
approach is tried with gridfacer. Made the production parallel
adaptation use a plan to attack ever edge longer than one in metric
(longest edge first) Created a tableau implementation of simplex
method for linear programming to untangle mesh via Freitag untangling.
Added methods to eradicate wedge and sliver cells. 
Able to run le case 0.01 easily, 0.002 harder, 0.001 (250:1) with
difficulty.

Tue Nov 22, 2005: Released Refine 1.2.9

Tried inserting boundary surface directly into grid to split domain
into interior and exterior portions. (The exterior is discarded.) This
line of resreach was discontuied after complexities with curved
boundaries overwhelmed attempts.

For curvilinear grids, started a main driver to make quadradic,
meshes. Work extend to high-order still ongoing.

Added a sorted priority to address worst elements first durring
adpation (nicknamed a plan).

Started a Phased approch to adaptation, where the first phase is
modify CAD edges only. A direct approach is tried with gridedger.

Thu Jul 28, 2005: Released Refine 1.2.8

The grid insert methods gridSplitEdgeRatio and gridCollapseEdge
interpolate and evaluate edge t, face uv, and xyz in a consistent
manner. Modified gridcad simplex volume searches to use min jacobian
determinates when gridCOST_CNST_VALID cost constraint active.
gridCostValid gridmetric method consistantly checks cost constraints.
Added logic to unit_main to make an invalid curved element mesh valid.
Modifies the gridSwap, gridSmooth, gridAdaptLongShort to priorities
operation to do ops on worst thing first.  With an update in the SDK
(tagged version 1.1.5) modifed gridfiller gridSavePart to set
consistant uvs to aviod projection issues.  Added tecplot cell and
equator outputs to debug grid.  Worked on Valid curved quad element
meshing.

Tagging to test new direction for linear elements.

FUN3D API change: gridsetcostconstraint_ and gridconstrainsurfacenode_
added for valid meshing with flow solver (not parallelized yet)

Thu Jun  2, 2005: Released Refine 1.2.7

Snapshot after Toronto AIAA paper, before `valid' adaptation research.
Improved the logic involved with smoothing on surface to allow its
use in parallel.
Included a check of geometry face parameter orientation of surface
to fix a bug that scrambled surface nodes durring adaptation.
Added a Face UV area constraint bit to cost constraints.
Uses CADGeom_ResolveOnFace and CADGeom_ResolveOnEdge calls to safely update
CAD parameters on the boundaries of faces and edges.
Created a plan.c object to store list of entities to adapt.
The plan list is created in parallel (during FUN3D runs) to
reduce the time of seqential ghost updates.
Allow border opertations in colors to speed up large 100+ processor runs.
CAPRI verson 2 compatability added as #define's
Reduced execution time of removing unused global nodes
and cells by replacing order n^2 operation.
Started work on validating invalid method.
Changed edge split to use a ratio of two node locations not an explicit
new node location.

Tue Jan 31, 2005: Released Refine 1.2.6

Split and collapse only project when the validity cost constraint is
activated. Face swapping was added to parallel partition interiors.
The OM6 example case runs.

Tue Jan 31, 2005: Released Refine 1.2.5

The -DSURFACE_VALIDITY path has been merged into the mainline code.
Node smoothing hierarchy: edge nodes move to improve geometry edge
lengths, surface nodes more to increase face mean ratio, and volume
nodes move to improve volume.  Cost constraints (volume,validity) can
be turned on and off with bitwise switches.  Adapted nodes are
projected and new faces are added to correctly evaluate surface
validity.  Fixed a parallel geom edge memory bug in
gridSortNodeGridEx.  The OM6 example case runs two iterations, but
generates surface grid cliffs due to projection durring adaptation.

Tue Jan 25, 2005: Released Refine 1.2.4

To save stable snapshot before merging the -DSURFACE_VALIDITY path
into the mainline code.
Continued unit mesh research into edge based adaptation and
curved boundary Jacobian validity checks.

Mon Oct 18, 2004: Released Refine 1.2.3

Added a texinfo refine manual, refine/doc/refine.texi.
Added extra check on collapse edge to prevent invalid connectivities.
Added CAPRI2 compatibility to current CAPRI (CADGeom) routines (run
./configure with --enable_CAPRI2 to activate).  Imposed limits on the
minimum element quality allowed after a edge split or collapse.  Added
functionality to untangle surfaces triangles in UV space.  Correctly
handle adaptation on geometry that has been transformed in the
SDK. Various FORTRAN API changes that require a compatible version
of FUN3D. 

Started on research into edge-based operator adaptation. Cost function
for grid improvement is selectable with gridSetCostFunction.

Wed Aug 17, 2004: Released Refine 1.2.2

Fixed FAKEGeom.

Wed Aug 17, 2004: Released Refine 1.2.1

Removed all references to SDK UG_API and Goolache from the refine lib;
you will only need to link to GEOLAB SDK CADGeom and MeatLib.  Added
static versions of SGI n32 CADGeom+CAPRINative and MeatLib in
geomSGIn32; see INSTALL for usage. Silenced reporting of CAD parameter
mismatches on restart. Note that there is a bug in the recreation of
CAPRI restarts that still needs to be fixed, but projecting points
works for all geometries tested so far.  Limited the range of R
(aspect ratio) to reduce the number of cases that the linear elasticity
system goes unstable with Gauss-Seidel. Use springs if the linear
elasticity system goes unstable. I have noticed an extra node or cell
reported by the load balancing routine in FUN3D on rare occasions for
large grids on may processors. I have not been able to isolate
problem.

Wed Aug  9, 2004: Released Refine 1.2.0

Replaced obsolete SDK/Goolache/MeshMgr with SDK/UG_API methods.  The
combination of removing cells from the mesh with two boundary triangles
(gridRemoveTwoFaceCell), Simplex optimization of volume
(gridRelaxNegativeCells), and existing edge swapping has been able to
fix the few negative elements that result from linear elasticity grid
movement to perform surface projection.

Wed Jul 16, 2004: Released Refine 1.1.0

Added linear elasticity grid movement
SDK tagged DynLoader_MeshMgr_Used

Wed Jul 13, 2004: Released Refine 1.0.0

First public release. Use with FUN3D version 3.3.0

Wed Jun 29, 2004: Released Refine 0.7.5

Tag before going to new GeoSDK UG_API implementation.
Continued work on parallel rebuild of GeoSDK restart info.

Wed Jun  2, 2004: Released Refine 0.7.4

gridmove and CAPRI(CADGeom) read work in parallel. Parallel node
smoothing works for CAD and fake geometry. Fixed off-by-one numbering
bug in FORTRAN interface gridfreezenode.

Mon May  3, 2004: Released Refine 0.7.3

Tagging before gridmpi:gridParallelEdgeCollapse extension.

Thu Apr 20, 2004: Released Refine 0.7.2

Tagging before queue refactor and gridmpi:gridApplayQueue speedup.

Thu Apr 15, 2004: Released Refine 0.7.1

Last version to use old pre-GeoBool tag on the SDK. Fixed more bugs in
multiple normals for BWB case.

Thu Apr 11, 2004: Released Refine 0.7.0

refine now has parallel FORTRAN bindings for FUN3D(HEFSS) see
HEFSS.rps/LibF90/refine_interface.f90 and refine/src/gridfortran.c.
Added collision detection, variable normals, and multiple normals to
advancing fronts. Harold Atkins added code to generate an Synthetic
Jet Grid. Multiple normals (blends) are more general.

Thu Jan 30, 2003: Released Refine 0.6

MesherX makes viscous grids on a box, plate, and om6

Thu Jan 15, 2003: Released Refine 0.5

New MesherX library structure

Thu Jan  9, 2003: Released Refine 0.4

Now have advancing layers with inflation and can insert non-manifold
edges on faces