Coustyx (R) Version 2.01
Copyright (c) 2012 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 folder contains the following files:
1. readme.txt
2. Coustyx Model File, *.cyx
3. dataset_description.pdf 

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

*** Coustyx Model File, *.cyx ***

The *.cyx file is the Coustyx model file. It contains all the information about 
the mesh, the type of model, and acoustics analysis details. This file is opened 
from Coustyx GUI.

*** dataset_description.pdf ***

This document contains details about the Demo model 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.us/Products/Coustyx 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 '*.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.

*** 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'.
  - For custom analysis sequences, expand the analysis sequence tab by
    clicking on the + in the menu tree to the left and then Right Click on
    the Script and Open to view the analysis script.  The analysis edit 
    dialog box can't be used to directly modify these. 
    They can be modified only through the Script. 

Three different analysis sequences are provided in the Demo Model. 

  1. ComputeTL - FMM: This custom analysis sequence runs the simulation from 20 Hz
     to 2000 Hz in steps of 20 Hz and computes the TL from the BEM solution
     and compares with the analytical solution. It creates the output file
     "TL_Comparison.dat" having three columns.  The first column is the
     frequency, the second is TL using analytical solution and the third is TL
     from BEM solution. This analysis sequence has custom script to compute
     the amplitudes of the incident and the reflected waves and the exact
     solution.

  2. Run Validation - FMM: This custom analysis sequence computes the
     pressure fields on the BE meshes in the source and receiver domains
     and compares the surface pressures with the analytical solution at 500 Hz.
     It also compares the field sound pressures at axial locations in the source
     and receiver domains.

  3. Run Validation - NonFMM: This is a dummy analysis sequence just kept
     as a place holder, as the meshes used in this example are large and
     not suitable for computing and storing the whole BEM influence matrix.

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.
