add test case and documentation for testing obst outline visualization

Manuals/FDS_User_Guide/FDS_User_Guide.tex

@@ -1243,7 +1243,31 @@ \subsection{Transparent or Outlined Obstructions}
 
 Obstructions are typically drawn as solids in Smokeview. To draw an outline representation, set {\ct OUTLINE} equal to {\ct T}
 
+\subsection{Method for avoiding mesh interfaces in blockage outline view}
 
+FDS splits a blockage into separate parts, one part for each mesh. As a result when Smokeview draws blockages as outlines it draws extra lines where blockages intersect mesh interfaces. The following procedure can be used to eliminate these extra lines for a case named say casename.fds .
+
+\begin{enumerate}
+\item Create a one mesh version of casename.fds case  . Name it casename\_single.fds (or anything different than casename.fds) . Set T\_END to 0.0 and CHID to casename\_single~.
+\item After running casename\_single.fds with fds, rename the generated casename\_single.smv file casename.smo~.
+\item Run smokeview casename~.
+\item Select the Show/Hide>Geometry>Obstacles>Outline only menu item to view the blockages as outlines.
+\item press the `q' key to toggle between viewing blockages split at mesh boundaries (how fds handles them) and how blockages are defined in the input file.
+\end{enumerate}
+
+Figure \ref{fig:outlinehack} shows an example where blockages are drawn as specified in the input file and drawn split at mesh interfaces.
+
+\begin{figure}[ht]
+\begin{center}
+\begin{tabular}{cc}
+\includegraphics[width=3.5in]{SCRIPT_FIGURES/obst_multi}&
+\includegraphics[width=3.5in]{SCRIPT_FIGURES/obst_single}\\
+outlines drawn at blockage edges and mesh interfaces&outlines drawn as specified in the input file
+\end{tabular}
+\end{center}
+\caption[Blockage outlines drawn at mesh interfaces and as specified in the input file.]{Blockage outlines drawn at mesh interfaces and as specified in the input file.}
+\label{fig:outlinehack}%
+\end{figure}
 
 \subsection{Creating Holes in Obstructions}
 \label{info:HOLE}

Verification/FDS_Cases.sh

@@ -347,6 +347,8 @@ $QFDS -d Miscellaneous mesh_transformation.fds
 $QFDS -d Miscellaneous obst_sphere.fds
 $QFDS -d Miscellaneous obst_cylinder.fds
 $QFDS -d Miscellaneous obst_cone.fds
+$QFDS -d Miscellaneous obst_multi.fds
+$QFDS -d Miscellaneous obst_single.fds
 $QFDS -d Miscellaneous obst_rotbox.fds
 $QFDS -d Miscellaneous obst_sphere_mass_flux.fds
 $QFDS -d Miscellaneous obst_cylinder_mass_flux.fds

Verification/FDS_Pictures.sh

@@ -59,6 +59,7 @@ $RUNSMV -d HVAC leak_test_2.fds
 # $RUNSMV -d Immersed_Boundary_Method tri_cube_cut_cell_test_11
 # $RUNSMV -d Immersed_Boundary_Method tri_cube_cut_cell_test_12
 $RUNSMV -d Miscellaneous pyramid.fds
+$RUNSMV -d Miscellaneous obst_multi.fds
 $RUNSMV -d Miscellaneous obst_sphere.fds
 $RUNSMV -d Miscellaneous obst_cylinder.fds
 $RUNSMV -d Miscellaneous obst_cone.fds

Verification/Miscellaneous/obst_multi.fds

@@ -0,0 +1,71 @@
+&HEAD CHID='obst_multi',TITLE='Plume whirl case' /
+
+&MESH IJK=8,8,16, XB=0.0,0.8,0.0,0.8,0.0,1.6, MULT_ID='mesh'/
+&MULT ID='mesh', DX=0.8, DY=0.8, DZ=1.6, I_UPPER=1, J_UPPER=1, K_UPPER=1 /
+
+
+&DUMP NFRAMES=400 DT_PL3D=8.0, DT_SL3D=0.1 /
+
+&INIT XB=0.2,1.4,0.2,1.4,0.5,2.2  TEMPERATURE=600.0 /
+
+&TIME T_END=0. /  Total simulation time
+
+&MATL ID                    = 'FABRIC'
+      FYI                   = 'Properties completely fabricated'
+      SPECIFIC_HEAT         = 1.0
+      CONDUCTIVITY          = 0.1
+      DENSITY               = 100.0
+      N_REACTIONS           = 1
+      NU_SPEC               = 1.
+      SPEC_ID               = 'PROPANE'
+      REFERENCE_TEMPERATURE = 350.
+      HEAT_OF_REACTION      = 3000.
+      HEAT_OF_COMBUSTION    = 15000. /
+
+&MATL ID                    = 'FOAM'
+      FYI                   = 'Properties completely fabricated'
+      SPECIFIC_HEAT         = 1.0
+      CONDUCTIVITY          = 0.05
+      DENSITY               = 40.0
+      N_REACTIONS           = 1
+      NU_SPEC               = 1.
+      SPEC_ID               = 'PROPANE'
+      REFERENCE_TEMPERATURE = 350.
+      HEAT_OF_REACTION      = 1500.
+      HEAT_OF_COMBUSTION    = 30000. /
+
+&SURF ID             = 'UPHOLSTERY_LOWER'
+      FYI            = 'Properties completely fabricated'
+      RGB            = 151,96,88
+      BURN_AWAY      = .FALSE.
+      MATL_ID(1:2,1) = 'FABRIC','FOAM'
+      THICKNESS(1:2) = 0.002,0.1 
+/
+
+&SURF ID             = 'UPHOLSTERY_UPPER'
+      FYI            = 'Properties completely fabricated'
+      RGB            = 151,96,88
+      BURN_AWAY      = .FALSE.
+      TMP_FRONT      = 600.0
+/
+&REAC SOOT_YIELD=0.01,FUEL='PROPANE'/
+&SURF ID='BURNER',HRRPUA=600.0,PART_ID='tracers' /  Ignition source
+
+&VENT XB=0.5,1.1,0.5,1.1,0.1,0.1,SURF_ID='BURNER' /  fire source on kitchen stove
+
+&OBST XB=0.5,1.1,0.5,1.1,0.0,0.1 /
+&OBST XB=0.3,1.3,0.3,1.3,0.4,0.8 SURF_ID='UPHOLSTERY_LOWER'/
+&HOLE XB=0.6,1.0,0.2,0.8,0.3,0.9 /
+&OBST XB=0.3,1.3,0.3,1.3,1.2,1.6 SURF_ID='UPHOLSTERY_UPPER' /
+
+&VENT MB='XMIN', SURF_ID='OPEN' /
+&VENT MB='XMAX', SURF_ID='OPEN' /
+&VENT MB='YMIN', SURF_ID='OPEN' /
+&VENT MB='YMAX', SURF_ID='OPEN' /
+&VENT MB='ZMAX', SURF_ID='OPEN' /
+
+&PART ID='tracers',MASSLESS=.TRUE.,
+   QUANTITIES(1:3)='PARTICLE U','PARTICLE V','PARTICLE W'
+   SAMPLING_FACTOR=10 /  Description of massless tracer particles. Apply at a
+                                                             solid surface with the PART_ID='tracers'
+&TAIL /