Coustyx (R) Version 1.1
Copyright (c) 2007 Advanced Numerical Solutions (Ansol) LLC.
All rights reserved.


README.txt

The following topics are covered here:
A. Details of the files provided in the zip folder
B. How to run the Demo Model?


A. Zip folder
----------------

This zip file contains the following files:
1. readme.txt
2. ReciprocityProblemDemoModelCase1.cyx
3. ReciprocityProblemDemoModelCase2.cyx
4. dataset_description.pdf 

Unzip these files from the zip folder to run the Demo Models.

*** ReciprocityProblemDemoModelCase1.cyx ***

ReciprocityProblemDemoModelCase1.cyx file is the Coustyx model file for case 1. 
In case 1, the observer side of the plate barrier is coated with a 
sound-absorbing material. For more details read dataset_description.pdf. The 
*.cyx file contains all the information about the mesh, the type of model, and 
acoustics analysis details. This file is opened from Prefyx (the GUI for 
Coustyx).

*** ReciprocityProblemDemoModelCase2.cyx ***

ReciprocityProblemDemoModelCase2.cyx file is the Coustyx model file for case 2. 
In case 2, the source side of the plate barrier is coated with a sound-absorbing
material. For more details read dataset_description.pdf. The *.cyx file contains 
all the information about the mesh, the type of model, and acoustics analysis 
details. This file is opened from Prefyx (the GUI for Coustyx).

*** dataset_description.pdf ***

This document contains details about the Demo models and the validation results.



B. How to run the Demo Model?
-----------------------------

To start running the Demo Model, you need to first download and install Coustyx. 
Visit http://www.ansol.com/ to get a trial version of the software.

A quick set of instructions is provided below to open the Demo Model, view the 
mesh, run the analysis, and visualize the results. 

More information can be obtained at any time from the Help menu or by pressing 
F1 in Prefyx.


*** Open the Demo Model ***

To open a DemoModel:
  1. Open Prefyx (the GUI for Coustyx) from the start menu after the 
     installation is complete.
  2. Open the model file 'DemoModel.cyx' from the File menu in Prefyx to 
     view the model and run acoustic analysis at specified frequencies.
  3. Expand 'Model' to explore more details about the model.


*** View the mesh ***

We follow different sets of instructions based on the type of the model. The 
type of the Demo Model can be found from the top most member 'Type' in the Model 
tree. It can be any one of the following two: 

  - MultiDomain Model
  - Indirect Model.

To view the Boundary Element (BE) mesh of the Demo Model in the GUI: 

  ** MultiDomain Model **

  If the Type of the Demo Model is MultiDomain, then the Model tree member 
  'Direct BE Meshes' consists of the list of BE meshes. To view a mesh in the 
  GUI, right click on the mesh and select Open. Various GUI operations can be
  performed on the mesh opened like this.

  ** Indirect Model **

  If the Type of the Demo Model is Indirect, then the mesh can be viewed by 
  right clicking on the Model tree member 'Indirect BE Mesh' and selecting Open. 
  Various GUI operations can be performed on the mesh opened like this.


*** Run Analysis ***

'Analysis Sequences' is a Model tree member, which is used to set the acoustics 
analysis parameters and is run to obtain steady state sound fields. 

  - To start running the analysis, right click on any analysis sequence and 
    select 'Run'.
  - To edit or verify the analysis parameters, right click on any analysis 
    sequence and select 'Edit'. This opens 'analysis edit dialog box'.
    

Analysis sequences provided in the Demo Models are 

  1. Run Demo: This analysis sequence is a standard sequence, which generates 
     results files that include 'iglass.igl' data files. Iglass data files 
     are used to visualize the results. After the analysis sequence is run, 
     double-click on the generated 'iglass.igl' to see the results.
     The generated iglass.igl file can be found in the same folder as the 
     DemoModel.cyx. You can use the analysis edit dialog box to edit the
     parameters.

     Field point solution data files 'sensors_case1.txt' and 
     'sensors_case2.txt' are also generated. These files contain the field 
     point pressure values which are compared to verify the principle of 
     reciprocity using Coustyx.


*** Results ***

Running this Demo Model will generate the following results files.

  ** Iglass.igl **

  1. This output file is generated when analysis sequence 'Run Demo' is run. 
  2. To open, double-click on the file. 
  3. Browse through the tabs on the top left of the iglass window and select 
     'Attribs'. 
  4. Select any of the acoustic variables listed in the drop-down menu in 
     Attribute to visualize results.

  ** sensors_case1.txt **

  This ASCII text file contains field point solution at observation point 
  (0.5,0.5,1) for case 1. Coustyx model is solved using Fast Multipole Method 
  (FMM). This file is created by running the analysis sequence 'Run Demo' 
  in the ReciprocityProblemDemoModelCase1.cyx. The first column in the file
  represents analysis frequency; second and third columns represent real and
  imaginary parts of pressure; fourth and fifth columns represent real and
  imaginary parts of velocity component in x direction; the remaining columns 
  represent velocity components in y and z directions.

  ** sensors_case2.txt **

  This ASCII text file contains field point solution at observation point 
  (0.5,0.5,1) for case 2. Coustyx model is solved using Fast Multipole Method 
  (FMM). This file is created by running the analysis sequence 'Run Demo' 
  in the ReciprocityProblemDemoModelCase2.cyx. The first column in the file
  represents analysis frequency; second and third columns represent real and
  imaginary parts of pressure; fourth and fifth columns represent real and
  imaginary parts of velocity component in x direction; the remaining columns 
  represent velocity components in y and z directions.



Note: The 'trial license' provided along with the Demo Model is valid for this 
model only. Any changes to the model will invalidate the license. However, the
user is free to modify parameters in analysis sequences to test the software.
