------------ ~rkriz/Projects/Sij_glyphs/npib_Sij_glyphs/README ----------------- OBJECTIVE: organize automated procedure and create Sij glyphs that can be used either for distance learning or collaborative research using NPIB This is the "$BASE" directory for calculating and visualizing ellipsoid surface representations of second order stress tensors, Sij. From this "$BASE" directory PV-Wave script procedure files: generate (do_*.pro) ellipsoid surfaces ("glyphs") in the ToPology (TP) directory and glyph rotations in the ORientation (OR) directoy ,purge (purge_*.pro) files from TP and OR directories, and archive in the (Results) directory. Procedure: Part I: Create sij.data file for appropriate set of second order tensors Part II: ESTABlish appropriate ASCII Color Table in the Estab_ct directory Part III: Generate ellipsoid surfaces in various ToPology (TP) directories Part IV: Generate ellipsoid surfaces in various ORientation (OR) directories Part V: View results in the (Results) directory Part VI: Archive results in the (../Archive_Results) directory Part VII: Purge results and repeat procedure for a different Sij tensors --- Part I --- % cd Archive_data % cp sij.data."name_type" ../sij.data % cd .. --- Part II --- % cd Estab_ct % cp "color_table_filename".ascii ../ct.ascii % cd .. --- Parts III and IV --- % wave WAVE> do_all **** Enter image type number 1 - 12: where 4,6,7,8 are the most popular **** **** Image types summarized and displayed at http://www.jwave.sv.vt.edu: **** **** ~rkriz/Projects/Sij_glyphs/npib_Sij_glyphs/Results/imagetypes.jpg/ **** : 8 "we recommend you try 8, without animations this should take about 15 min" **** Choose if you want to include animated glyph surface rotations **** **** Wave surface rotations can reveal more glyph surface topology **** **** If animations ARE NOT included this will take about 15 min **** **** If animations ARE included this will take about 3 hrs 15 min **** **** (0/1) 0 -> do not include animations, 1 -> animation included **** : 1 (this will take about 3 hrs and 15 minutes) --- Part V --- % cd Results "and now view results, Sij_results.html, using a Web browser" % cd .. --- Part VI --- % tar cvf Results.tar Results % mv Results.tar ../Archvie_Results/Results.tar."set_name"" --- Part VII --- % wave WAVE> purge_all % ------------------------------------------------------------------------------ MOTIVATION: The various script files and directories shown above are organized to be used as a NPIB module. A new color table "scheme" was developed so that the user can create a color table that is appropriate and can be used CONSISTENTLY in the generation of Sij ellipsoid surface results. These results are summarized, analyzed, and interpreted using a standard Web browser at Results/Sij_results.html. This scheme was developed and documented in the scheme and Estab_ct directories. Particular attention was devoted to evaluating a variety of different glyph surface image types that would prove to be the most useful in analyzing and interpreting Sij 3D ellipsoid surface topologies. The final goal here is to implement this procedure into an interactive Web based NPIB module for the students in various ESM classes, Throughout this description the "user" refers to either the student or a researcher where either can investigate a collection of second order stress tensor topologies. The intent here is consistent with the idea behind developing a useful set of tools for combined research and curriculum developement, http://www.jwave.sv.vt.edu/crcd. Hence the ultimate goal is to organize and create content that can be used either for distance learning or collaborative research. Procedure Description: Part I: Create sij.data file for set of second order stress tensors Various sij.data files have been created and archived in the Archive_data directory. To start the calculations the user must choose an appropriate data file from this directory, renamed this data file to sij.data, and move it into the "$BASE" directory. The user can also create an new data file by following the same format. To facilitate the use of this procedure by others not familiar with working with with scripts in a UNIX shell this data file will be converted to a NPIB Java-Web based form file which will allow the user to just enter the necessary data and submit results for calculation, see more about NPIB at http://www.jwave.vt.edu/npib/npib.html Part II: ESTABlish appropriate ASCII Color Table, Estab_ct directory An ASCII color table is created in the Estab_ct directory, renamed to ct.ascii, and moved into the "$BASE" directory. The procedure for creating an appropriate ASCII color table is documented in detail in the Estab_ct directory. Part III: Generate glyph-surfaces in various topology (TP) directories Images are generated from the "$BASE" directory using the PV-Wave procedure file do_all.pro. The PV-Wave procedure file sit.pro prompts the user for an image type number. The number 8 is recommended. The user can choose from twelve different image types which are visually summarized and compared in the JPG image which can be accessed at ~rkriz/Projects/Sij_glyphs/npib_Sij_glyphs/Results/Archive/imagetypes.jpg Generation of various 3D glyph-surfaces is accomplished in three steps: Step I: do_tp_jpg.pro generates JPG images in two different directories: - DIRECTORY TP/surf121: 3D surface topology data files are created. These topology data files are used to create Mercator maps that represent equilibrium and are mapped onto to 3D ellipsoid surfaces the represent the principal stress starte. Step II: do_tp_"type"_anim.pro generates animated GIF images of rotating glyph surfaces in the TP/surf121/MM/m_"type"_anim directories, There are four Sij glyph "types": PNS, HWY, Reynolds, Quadric Step III: do_tp_"type"_vrml1.pro and do_tp_"type"_vrml2.pro creates 3D scenegraphs that can be viewed either with VRML1.0 Web browser plugins or VRML2.0 Web browser plugins. The VRML1.0 scenegraph is also saved as an Inventor1.0 file format which can be loaded into a fully immersive virtual environment of a CAVE using the diversifly application http://diverse.sourceforge.net Part IV: Generate glyph surfaces in various ORientation (OR) directories VRML1, VRML2, and Inventor files are generated from the "$BASE" directory using the PV-Wave procedure file do_all.pro that calls three other files do_or_boxaxes.pro, do_or_glyphs_vrml1.pro, and do_or_glyphs_vrml2.pro. Part V: View results in the Results directory Various ellipsoid surface topologies previously generated are moved into the Results directory and organized into a single Web viewable HTML file sij_results.html for analysis and interpretation. Part VI: Archive results in the Archive_Results directory Wave surfaces images in Results directory are tarred (*.tar) and archived in the Archive_Results directory. Part VII: Purge all results ------------------------------- END OF README --------------------------------