STYLE: surfaceMeshTriangulate renamed to surfaceMeshExtract

- the utility had automatic triangulation removed some time ago, but
  never changed its name.

- catch old uses with a surfaceMeshTriangulate deprecated script

applications/utilities/surface/README

@@ -17,12 +17,13 @@ surfaceCoarsen
 surfaceConvert
 - Converts surfaces to/from various formats
 
+surfaceMeshExtract
+- Extracts mesh patches (or faceSets) and writes as a single surface.
+- foamToSurface duplicates this
+
 surfaceFind
 - Finds nearest vertex and face to given point.
 
-surfaceMeshTriangulate
-- Triangulate external faces of mesh and write as surface.
-
 surfacePointMerge
 - Explicit point merge of surface.
 

applications/utilities/surface/surfaceMeshExtract/Make/files

@@ -0,0 +1,3 @@
+surfaceMeshExtract.C
+
+EXE = $(FOAM_APPBIN)/surfaceMeshExtract

applications/utilities/surface/surfaceMeshExtract/Make/options

@@ -5,4 +5,3 @@ EXE_INC = \
 EXE_LIBS = \
     -lmeshTools \
     -lsurfMesh
-

applications/utilities/surface/surfaceMeshTriangulate/Make/files

@@ -1,3 +0,0 @@
-surfaceMeshTriangulate.C
-
-EXE = $(FOAM_APPBIN)/surfaceMeshTriangulate

bin/deprecated/surfaceMeshTriangulate

@@ -0,0 +1,27 @@
+#!/bin/sh
+#------------------------------------------------------------------------------
+# =========                 |
+# \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
+#  \\    /   O peration     |
+#   \\  /    A nd           | Copyright (C) 2018 OpenCFD Ltd.
+#    \\/     M anipulation  |
+#------------------------------------------------------------------------------
+# License
+#     This file is part of OpenFOAM, licensed under GNU General Public License
+#     <http://www.gnu.org/licenses/>.
+#
+# File
+#     surfaceMeshTriangulate
+#
+# Description
+#     Renamed surfaceMeshTriangulate to surfaceMeshExtract (2018-12-21)
+#
+#------------------------------------------------------------------------------
+
+echo
+echo "FOAM FATAL"
+echo "${0##*/} has been superceded by surfaceMeshExtract (DEC-2018)"
+
+exit 1
+
+#------------------------------------------------------------------------------

bin/surfaceMeshTriangulate

@@ -0,0 +1 @@
+deprecated/surfaceMeshTriangulate

etc/config.sh/completion_cache

@@ -258,9 +258,9 @@ _of_complete_cache_[surfaceInflate]="-case -featureAngle -fileHandler -nSmooth |
 _of_complete_cache_[surfaceLambdaMuSmooth]="-featureFile | -doc -doc-source -help"
 _of_complete_cache_[surfaceMeshConvert]="-case -dict -fileHandler -from -scaleIn -scaleOut -to | -clean -noFunctionObjects -tri -doc -doc-source -help"
 _of_complete_cache_[surfaceMeshExport]="-case -dict -fileHandler -from -name -scaleIn -scaleOut -to | -clean -noFunctionObjects -doc -doc-source -help"
+_of_complete_cache_[surfaceMeshExtract]="-case -decomposeParDict -faceZones -fileHandler -patches -region -time | -constant -excludeProcPatches -latestTime -noFunctionObjects -noZero -parallel -doc -doc-source -help"
 _of_complete_cache_[surfaceMeshImport]="-case -dict -fileHandler -from -name -scaleIn -scaleOut -to | -clean -noFunctionObjects -doc -doc-source -help"
 _of_complete_cache_[surfaceMeshInfo]="-case -fileHandler -scale | -areas -noFunctionObjects -xml -doc -doc-source -help"
-_of_complete_cache_[surfaceMeshTriangulate]="-case -decomposeParDict -faceZones -fileHandler -patches -region -time | -constant -excludeProcPatches -latestTime -noFunctionObjects -noZero -parallel -doc -doc-source -help"
 _of_complete_cache_[surfaceOrient]="-case -fileHandler -scale | -inside -noFunctionObjects -usePierceTest -doc -doc-source -help"
 _of_complete_cache_[surfacePatch]="-case -dict -fileHandler | -noFunctionObjects -doc -doc-source -help"
 _of_complete_cache_[surfacePointMerge]="-case -fileHandler -scale | -noFunctionObjects -doc -doc-source -help"

tutorials/incompressible/pimpleFoam/RAS/ellipsekkLOmega/Allrun.pre

@@ -14,7 +14,7 @@ runApplication topoSet
 
 runApplication createPatch -overwrite
 
-runApplication surfaceMeshTriangulate \
+runApplication surfaceMeshExtract \
     -patches hole ppGeometry.vtp -constant -time none
 
 echo "End"

tutorials/incompressible/porousSimpleFoam/straightDuctImplicit/README.txt

@@ -16,7 +16,7 @@ constant/triSurface/boundaryAndFaceZones.stl
             faceSet porosityFaces subset cellToFace porosity all
             faceZoneSet porosityFaces new setToFaceZone porosityFaces
 
-        surfaceMeshTriangulate -faceZones '(porosityFaces)' boundaryAndFaceZones.stl
+        surfaceMeshExtract -faceZones '(porosityFaces)' boundaryAndFaceZones.obj
     )
 
 surfaceFeatureExtract