Index of /~rkriz/Projects/Cijkl_glyphs/npib_Cijkl_glyphs

      Name                    Last modified       Size  Description


[DIR] Parent Directory        21-Jul-2009 12:44      -  
[DIR] Archive_Results/        02-Mar-2004 07:01      -  
[DIR] Archive_data/           11-Jan-2004 15:59      -  
[DIR] Estab_ct/               26-Dec-2003 12:02      -  
[DIR] Results/                05-Apr-2004 10:22      -  
[DIR] TP/                     25-Dec-2003 16:43      -  
[TXT] cijkl.data              11-Feb-2004 17:00     1k  
[TXT] ct.ascii                24-Dec-2003 17:42     6k  
[TXT] do_all.pro              13-Jan-2004 17:21     1k  
[TXT] do_tp_anim.pro          26-Dec-2003 16:37     1k  
[TXT] do_tp_jpg.pro           13-Jan-2004 17:21     1k  
[TXT] do_tp_surf121_jpg.pro   13-Jan-2004 12:45     1k  
[TXT] do_tp_surf121_mm_ws_..> 26-Dec-2003 16:42     1k  
[TXT] do_tp_vrml1.pro         13-Jan-2004 12:49     1k  
[TXT] do_tp_vrml2.pro         13-Jan-2004 12:49     1k  
[TXT] purge_all.pro           26-Dec-2003 16:43     1k  
[TXT] purge_results.pro       13-Jan-2004 17:22     1k  
[TXT] purge_tp.pro            04-Jan-2004 13:18     1k  
[DIR] scheme/                 14-Dec-2003 19:56      -  
[TXT] sit.pro                 26-Feb-2004 10:45     2k  

----------- ~rkriz/Projects/Cijkl_glyphs/npib_Cijkl_glyphs/README ----------

OBJECTIVE: organize automated procedure to create Cijkl glyphs to be used
           either for distance learning or collaborative research using NPIB
  
This is the "$BASE" directory for calculating and visualizing wave surface 
representations of fourth order stiffness tensors, Cijkl.  From this "$BASE" 
directory PV-Wave script procedure files: generate (do_*.pro) wave surfaces
in the topology (TP) directory, purge (purge_*.pro) files from various TP
directories, and store results in the Results directory.
   
Procedure:
   
Part I:   Create cijkl.data file for appropriate crystal class symmetry
Part II:  ESTABlish appropriate ASCII Color Table in the Estab_ct directory
Part III: Generate wave surfaces in various topology (TP) directories
Part IV:  View results in the Results directory
Part V:   Archive results in the Archive_Results directory
Part VI:  Purge results and repeat procedure for a different cyrstal 
    
 --- Part I ---
 % cd Archive_data
 % cp cijkl.data."crystal_type" ../cijkl.data
 % cd ..
 --- Part II ---
 % cd Estab_ct 
 % cp "color_table_filename".ascii ../ct.ascii
 % cd ..
 --- Part III ---
 % 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/Cijkl_glyphs/npib_Cijkl_glyphs/Results/imagetypes.jpg ***
 : 8 "we recommend you try 8, this should take about 2 hours to complete"

**** Choose if you want to include animated wave surface rotations  ****
**** Wave surface rotations can reveal more wave surface topology   ****
**** If animations ARE NOT included this will take about 5 minutes  ****
****   If animations ARE included this will take about 2.5 hours    ****
**** (0/1) 0 -> do not include animations,  1 -> animation included ****
 --- Part IV ---
 % cd Results "and now view results, cijkl_results.html, using a Web browser"
 % cd ..
 --- Part V ---
 % tar cvf Results.tar Results
 % mv Results.tar Archvie_Results/Results.tar."cystal_type"
 --- Part VI ---
 % 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 Cijkl wave surface results. These results 
are summarized, analyzed, and interpreted using a standard Web browser at 
Results/cijkl_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 wave surface image types that would prove
to be the most useful in analyzing and interpreting Cijkl 3D wave surface 
topologies.  The final goal here is to implement this procedure into an 
interactive Web based NPIB module for the students to use in ESM5344, 
"Wave Propagation in Solids", for the Spring04 semester.  Throughout this
desription the "user" refers to either the student or a researcher where 
either can investigate different crystal class symmetries.  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 cijkl.data file for appropriate crystal class symmetry
  
 Various cijkl.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 cijkl.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 wave 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/color/npib_Cijkl_glyphs/Results/imagetypes.jpg  
   
 Generation of various wave surfaces is accomplished in two steps:
  
 Step I: do_tp_jpg.pro generates JPG images in two different directories: 
      
    - DIRECTORY TP/surf121: Wave surface topology data files are created.
      These topology data files are used to create Gouraud shaded wave 
      surfaces (no color) and Mercator maps of wave surface properties 
      which are saved as JPG images. 
   
    - DIRECTORY TP/surf121/MM/m_ws: Wave surface polygonal plots are 
      created in a variety of formats: simple isometric schematic of wave 
      surfaces intersecting three orthogonal planes, polygonal wave 
      surfaces overlayed with Mercator color maps.  Color bar legends are 
      also created that represent the ASCII color table. The isometric 
      wave surface schematic and color bar legend are combined with 
      various polygonal wave surfaces and saved as JPG images.  
       
 Step II: do_tp_anim.pro generates animated GIF images of rotating wave 
          surfaces in the TP/surf121/MM/m_anim directory
   
Part IV: View results in the Results directory
  
 Various wave surface topologies previously generated are moved into the 
 Results directory and organized into a single Web viewable HTML file
 cijkl_results.html for analysis and interpretation.  
  
Part V: Archive results in the Archive_Results directory
  
 Wave surfaces images in Results directory are tarred (*.tar) and archived
 in the Archive_Results directory.
   
------------------------------- END OF README --------------------------------