Read Me

README for PEW V2
**************

PEW is licensed under the GNU general public license as detailed in
the COPYING file.  All this would not be possible without the hard
work and attention to detail of Richard MacPherson, Jamie McIntosh and
Michael Hilfer

INTRODUCTION
************

PEW is a collection of Octave scripts that generates a profiled
endwall design and is described in the following papers:

MacPherson, Richard & Ingram, Grant 2010, Endwall Profile Design for
the Durham Cascade using Genetic Algorithms, Seventh South African
Conference on Computational and Applied Mechanics, SACAM10. Pretoria,
South Africa, South African Association for Theoretical and Applied
Mechanics.  

and

McIntosh J, MacPherson R, Ingram G, Hogg S, 2011, PROFILED ENDWALL
DESIGN USING GENETIC ALGORITHMS WITH DIFFERENT OBJECTIVE FUNCTIONS.
ASME Paper GT2011-45836 Proceedings of ASME Turbo Expo 2011 GT2011
June 6-11, 2011, Vancouver, Canada

and

Hilfer M, Ingram G, Hogg S, 2012, ENDWALL PROFILING WITH TIP CLEARANCE
FLOWS.  ASME Paper GT2012-68488 Proceedings of ASME Turbo Expo 2012
GT2012 June 6-10, 2012, Copenhagen, Denmark

It is therefore likely to be of use if you want to design your own
endwalls or you would like to learn some details about what we did.

This release PEW V2 covers the endwalls generated in the final paper
presented in 2012.  

It is released under a free software license but to actually get it to
work you need to also have a meshing program and a fluid flow
calculation program.  The software is also design to work on GNU/Linux
systems - it may well work on Windows we just haven't tried it
yet. Although we have done a great deal of work to move to a full free
software approach but using arbitrary surfaces is a challenge with
free or open source meshing programs.

The meshing program was ICEM and the fluid calculation program was
Fluent, both of these were v12.

There is also little documentation to speak of but we are happy to
answer questions about the operation and use of the code if you e-mail
me.  We have a plan to make a Source-forge site where you can interact
with use more directly but thought it would be nice to have the code
corresponding to the paper be available for release sooner rather than
later.

INSTALLATION INSTRUCTIONS 
*************************

The PEW system has 2 main Folders:

Folder_1: Folder on your local computer (or your home server) to store
final calculations and to run the main scripts. It has to be a
GNU/Linux system preferably with a ANSYS installation.  Due to rather
large files for each calculation (Mesh, case etc) you need at least 50
gig for 100 generations, by automatically deleting mesh and case files
you could save a lot of space.

Folder_2: Folder for your high performance computing system. On this
system you need a GNU/Linux installation as well as ANSYS (Fluent and
ICEM) installations.


###Folder_1###
Content of Folder_1:

1.  costfunction.m
2.  curve.m
3.  export.m
4.  final.blk
5.  fvprocess.fvx
6.  GA.m
7.  icemreplay.rpl
8.  import.m
9.  importfile.m
10. inputfile
11. monitor.m
12. mutate.m
13. oegularise.m
14. pressure.dat
15. streamprocess.m
16. suction.dat

costfunction.=> cost calculation of each chromosome. A mass flow cost factor was added.
curve.m      => Curve generation and PEW surface generation for Pointwise/Icem.
export.m     => Export of the results to database.
final.blk    => Blocking strategy. Is needed for the meshing using icemreplay script.
fvprocess.fvx=> Stream line generation script
GA.m         => most of the parameter settings and changes have to be done here 
icemreplay   => Meshing script for Icem
import.m     => Import database files
importfile.m => instructions how to use or what to change in the script file.
inputfile    => Inputfile with instructions for Fluent. File used to control Fluent calculations.
monitor.m    => Checks the status of the calculations, need some changes to go with your system.
mutate.m     => Mating + Mutation script
oegularise.m => Results interpolation in a new grid. Changed for my needs, please check before use.
pressure.dat => Pressure surface data file.
streamprocess=> Steam line analysis.
suction.dat  => Suction surface data file.

###Folder_2###
Content of Folder_2:

1.  initial.cas
2.  initial.ip

initial.cas  => pre set Fluent case file
initial.ip   => converged results of planar calculation for interpolation into a new case and mesh


USEAGE
******

From you GNU/Linux system run GA.m using Octave.

CONTACT
*******

Grant Ingram
g.l.ingram@durham.ac.uk