**************************************************************************

*
SCORG - Screw COmpressor Rotor Geometry grid generator Info
*
*
*
*
Version '5.00'
01/09/2014
*
**************************************************************************
SCORG is stand alone suite developed for grid generation of Screw
Compressor rotor flow domains and their integration with CAD or otherwise
generated numerical grids of adjacent domains for preparation of CFD cases
for general Finite Volume numerical solvers. SCORG(c) is written in
FORTRAN90 programming language for DOS or WINDOWS operating systems. On
demand it may be compiled and distributed for UNIX or LINUX operating
systems. For use with Windows OS, SCORG had user friendly and intuitive
GUI which provides easy and reliable grid generation. Details about
SCORG(c) are available online:
www.pdmanalysis.co.uk
The copyright of SCORG is vested in Professor Ahmed Kovacevic of City
University, London, UK. No part of it may
be
reproduced, stored in a
retrieval system or transmitted by any means electronic, mechanical or
otherwise, nor may it be supplied either free of charge or by sale to a
third
party without authors prior permission. SCORG is exclusively
commercialised through company PDM Analysis Ltd, Incorporated in England
and Vales under Company No. 8913163.
Contact address:
**************************************************************************
Professor Ahmed Kovacevic
PDM Analysis Ltd
8 Eccleston Close
Barnet EN4 9EZ, UK
Phone : +44 20 7477 8780
Fax
: +44 20 7477 8566
e-mail: A.Kovacevic@pdmanalysis.co.uk
**************************************************************************
All information contained in the disc and in accompanying instructions is
supplied in good faith and, to the best of the authors knowledge, all
data and claims for accuracy of calculations based on it are correct.
However, absolute assertion on the reliability and accuracy of the
information provided, which is based entirely on published findings cannot
be made. City University, PDM Analysis Ltd and the author therefore
disclaim responsibility for loss or damage to property or failure of
machinery to meet performance estimates which is attributable to errors or
inaccuracies in any information supplied.
1) INSTALATION
Program SCORG for Windows7 and higher versions is supplied on one CD rom
and is downloadable online through secure link. The installation file is
named SCORG Setup.exe. In order to fully utilise its graphical interface
SCORG requires MS .Net framework 4.5.1 or higher. (Provided with
installation
and
also
available
at
http://www.microsoft.com/engb/download/details.aspx?id=40779.
For installation of SCORG please run: Setup.exe and follow instructions
provided. The full installation guide is available in the separate
document in the installation disc.
If a license for the software has already been purchased but the software
license does not allow the software to work as expected or a message that
the program is running in DEMO mode, please contact PDM Analysis Ltd on
SCORG@pdmanalysis.co.uk and send the request.lic file which can be found
in the License directory of the SCORG folder..

2) DIRECTORY STRUCTURE
The main folder SCORG contains following sub-folders:
Data <DIR> - Contains required Plug Inn elements
Grid <DIR> - Main folder for installation and system files for the Grid
generation module
Geom <Dir> - Geometry and thermodynamic modules are contained here
License
- This folder normally contains just two files:
request.lic The file which contains cripted
information about the machine on which SCORG is
running.
Sorg.lic License file
Scorpath
- Contains demo version of profile generation software which
generates Demonstrator profile
SGUI
- System folder for SCORG
Directory SCORG\GRID consists of following directories:
DAT <DIR> - content of this directory will be completely generated by
SCOG program. Here are stored calculated files with vertex,
cells and region definitions, pre-processor script file and
user subroutines for Comet solver.
DXF <DIR> - This directory is the place where the CAD-CFD interface files
are stored. These files are in the general DXF format while
generated using script command DXF from the program main
directory.
EXE <DIR> - Contains SCOG.EXE program, NODE.EXE and PORT.EXE programs.
INP <DIR> - Contains input data for various compressors.
PLT <DIR> - Is the place where GRF and PLT files are stored. These files
are used by GRAPHER and VIEW to provide a graphical
presentation of created numerical mesh.
POS <DIR> - Data files RES???.DAT generated by POST.F subroutine of the
numerical solver (Comet) have to be copied here for further
post-processing. Program POST.EXE calculates all relevant
integral parameters for an analysed compressor (or expander)
together with p-alpha diagram.
SCO <DIR> - User functions for CFD solver are stored in this place.
TMP <DIR> - Temporary files are stored in this directory.
They can be
used to provide faster recalculation when required. Some
graphical presentations are made using these files. Content
of this directory is cleaned up using script command CLEA
from the programs main directory.
2) SCRIPT COMMANDS
SCOG has fully automated GUI. However some parts of the software could
be activate by script files in the Grid folder. Available scripts
are listed in the alphabetical order and described below.
CALC

CLEA

- Activates program Grid (in the folder EXE). Before it runs,

all data from the directory DAT and its subdirectory USERPROG
are deleted. Contents of the directory TEMP is also
cleaned before the newly generated temporary data are stored
there. After the run, except data files, all required fortran
subroutines are generated. They'll be described later in the
section 3) INPUT DATA STRUCTURE.
- Cleans contents of <DAT> and <TMP> directories.

3) INPUT DATA STRUCTURE

Input data files for SCORG are DAT.INP, RACK.INP, OIL.INP and REAL.INP.
They should be positioned in the <INP> directory. Changes in DAT.INP file
should be made in a text editor. Default text editor is SEE.EXE stored in

directory <BIN>. One can change it if copy preferred text editor (for
example as EDIT.EXE) into directory <BIN> and rename it in SEE.EXE.
The easiest way to select another INP file is by typing NEWI in the
programs main directory.
Parameters given in DAT.INP file are listed below and briefly explained.
Also, some typical values are given.
56
**************************************************************************
02 *
S C O G g g - Screw COmpressor Geometry grid generator - INPUT *
03
**************************************************************************
04 a
z1 z2
clea
rgap
el
fiou
ndist
npod
nang
90.
5. 6.
0.1
0.1
1.66
322
20
5
20
06 .control parameters
.......................................................
07 krot
krack
kdist
imesh
iipor
iopor
iprep
jskip
ncicle
1
1
1
1
1
1
1
1
5
09 .distribution parameters
..................................................
10 fad11
fad12
iadd1
fad21
fad22
iadd2
irsm
frsm
iline
0.3
0.0
63
0.3
0.0
52
1
1.
1
12 .meshing parameters - transfinite
interpolation............................
13 ak12
ak34
sco
ntr
iorth
al1
al2
ngrsm
fgrsm
0.0
0.0
0.0
2
1
1.0
0.5
1
0.5
15 .inlet port
parameters.....................................................
16 irax
radd
alph
ni1
ni2
nik
alinp
endcli aiorth
2
10.
45.
90
8
45
40.
0.2
1.
18 .outlet port
parameters....................................................
19 iora
fi1c
rodd
no1
no2
nok
alout
endclo aoorth
1
230
0.9
20
20
5
30.
0.1
0.5
21 .script file for Cometpp
..................................................
22 itype
enrot
pinl
pout
tinl
tout
wfluid
1
5000
100000. 700000. 293.
330.
0
24 .oil injection parameters
.................................................
25 ioil
poil
toil
fioil
zoil
oilr
doil
noil
1
400000. 320.
100.
150.
0.8
2.
2
27
**************************************************************************
* READ xxx.spf - Input file for SCORG(c)
V.5.00
*
**************************************************************************
00 [Rotor Profile Parameters] - Line 1
01 ILOBE [
] - Profile type 0-User; 3-Demonstrator
02 Axis
[ m ] - Axis distance
03 Z1
[
] - Male
rotor - Number of lobes
04 Z2
[
] - Female rotor - Number of lobes
05 R
[ m ] - Male
Rotor - Addendum
06 R0
[ m ] - Female Rotor - Addendum
07 GAPI
[ m ] - Interlobe nminal Clearance
08 DAFIL [
] - Nominal spacing between points on the profile
09 EPR
[ Pa] - Young Modulus of Elasticity for Rotors
10 C_therm_R [m/Km] - Coefficient of linear expansion for rotors
00
01
02
03
04
05
06

[Rotor
E
PSI
R1
R2
R3
R4

Profile
[ m ] [rad] [ m ] [ m ] [ m ] [ m ] -

Parameters] - Line 2
Excentricity for the rotor tooth ("C" profile)
Tooth Tip Angle
Male
Rotor - Leading edge Root Radius
Male
Rotor - Leading edge Tip Radius
Female Rotor - Trailing edge Root Radius
Female Rotor - Trailing edge Tip Radius

07
08
09
10

Alpha1
Alpha2
EN
Tamb

[rad]
[rad]
[
]
[ K ]

00
01
02
01
02
03
04
05
06
07
08
09
10

[User Rotor Profile]

UserMale=#
- Loaction and Name for the External Male Rotor Profile
UserFrmale=# - Loaction and Name for the External Female Rotor Profile
aal1
[rad] - Roate male profile for give angle
XS1
[
] - Scaling factor for the male rotor X coordinate
YS1
[
] - Scaling factor for the male rotor Y coordinate
lf1
[
] - Flip Male rotor profile
aal2
[rad] - Roate male profile for give angle
XS2
[
] - Scaling factor for the female rotor X coordinate
YS2
[
] - Scaling factor for the female rotor Y coordinate
lf2
[
] - Flip Female rotor profile

00
01
02
03
04
05
06
07
08
09
10
11

[Screw Machine Geometry] - Line 1

EL
[
] - Relative length (L/D)
WRAP
[rad] - wrap angle (FIOU)
pst
[ m ] - Pitch at the low pressure side of the rotors
pen
[ m ] - Pitch at the high pressure side of the rotors
ipitcv [
] - Rotor Pitch: 0-Uniform; 1-Variable; 2-Stepped; 3-User
isectcv[
] - Rotor Profile 0-Constant; 1-Variable
grdx
[ ] X coordinate of Male rotor centre
grdy
[ ] Y coordinate of Male rotor centre
grdz
[ ] Z coordinate of Male rotor centre
mhelix [ ] Hand of Helix on Male rotor lobe: 0- Right; 1- Left
gpos [ ] Gate rotor position: 0-Right side; 1-Left Side

00
01
02
03
04
05
06
07
08
09
10

[Screw
itype
NGLobe
ELR0
GAPR
GAPA
FI1S
FI1C
VI

00
01
02
03
04
05
06
07
08
09
10

[Screw Machine Geometry] - Line 3 - Position of bearings, rotor shafts

O1S
[ m ] - Offset
of the male
suction
radial bearing
D1S
[ m ] - Diameter of the male
suction
radial bearing
O1D
[ m ] - Offset
of the male
discharge radial bearing
D1D
[ m ] - Diameter of the male
discharge radial bearing
O2S
[ m ] - Offset
of the female suction
radial bearing
D2S
[ m ] - Diameter of the female suction
radial bearing
O2D
[ m ] - Offset
of the female discharge radial bearing
D2D
[ m ] - Diameter of the female dischagre radial bearing
EPC
[ Pa] - Young modulus of Elasticity for Casing
C_therm_C [m/Km] - Coefficient of linear expansion for casing

00
01
02
03
04
05
06
07
08
09

[Screw
x-Msuc
y-Msuc
x-Mdis
y-Mdis
x-Fsuc
y-Fsuc
x-Fdis
y-Fdis
z-M

Machine
[
] [
] [ m ] [ m ] [ m ] [rad] [rad] [
] -

Machine
[ m ] [ m ] [ m ] [ m ] [ m ] [ m ] [ m ] [ m ] [ m ] -

Pressure angle - Leading Edge

Pressure angle - Trailing Edge
Exponent for the leading edge parabola
Ambient temperature at time of assembly

Geometry] - Line 2
Type of the machine
0-Compressor
1-Expander
Number of female rotors
Rotor Length-If<>0 then override value calculated by EL
Radial clearance (nominal)
Axial clearance (nominal)
Angle of compression start
Angle of compression end
Volume Index (Vsuc/Vdisc]

Geometry] - Line 4 - Rotor Displacements

Displacement male rotor X-direction Suction radial brg
Displacement male rotor Y-direction Suction radial brg
Displacement male rotor X-direction Discharge radial brg
Displacement male rotor Y-direction Discharge radial brg
Displacement female rotor X-direction Suction radial brg
Displacement female rotor Y-direction Suction radial brg
Displacement female rotor X-direction Disch. radial brg
Displacement female rotor Y-direction Disch. radial brg
Displacement male rotor Z-direction Axial bearing

10 z-F

[ m ] - Displacement female rotor Z-direction Axial bearing

00
01
02
03
04
05
06
07
08
09
10

Machine Geometry] - Line 5 - Bearing and Seal losses

[
] - Bearing type: 0 - Rolling Element; 1 - Hydrodynamic
[
] - Number of shaft seals
[W/1000rpm] - Power losses in seals per 1000 rpm
[
] - Diameter Factor for power losses in hydrodynamic brg
[
] - Tip speed factor for power losses in hydrodynamic brg

[Screw
IBType
NSeals
Pseal
FDia
FSpeed

00 [Geometry control parameters]

01 iclea [
] - Calculate new clearance distrintion O-no; 1-yes
02 iforc [
] - Calculate forces O-no; 1-yes
03 imap
[
] - Output initial and boundary conditions for CFD/FEM:
no; 1-yes
04 iSeal [
] - Output three dimensional sealing line and clearance
distribution O-no; 1-yes
05 iGapI_R [
] - Correct interlobe gap for local rotor themal
deformation : O-no; 1-yes
06 iGapI_C [
] - Correct interlobe gap for local casing themal
deformation : O-no; 1-yes
07 iGapI_R [
] - Correct radial
gap for local rotor themal
deformation : O-no; 1-yes
08 iGapR_R [
] - Correct radial
gap for local casing themal
deformation : O-no; 1-yes
09
10
00
01
02
03
04
05
06
07
08
09
10

[Working Conditions]
WTP
[m/s] - Rotor tip speed
ENROT0 [rpm] - Rotor speed (If ENROT<>0 overrides value defined
P0
[ Pa] - Suction
pressure
PR
[ Pa] - Discharge pressure
T0
[ K ] - Suction
temperature
TR
[ K ] - Discharge temperature
TVAP
[ K ] - Evaporator saturation temperature (Only for Real
TKON
[ K ] - Condenser saturation temperature (Only for Real
TS
[ K ] - Average
temperature of the casing
EX
[
] - Vapour quality at inlet 0.<EX<1. 0 - Liquid; 1 -

00
01
02
03
04
05
06
07
08
09
10

[Working Fluid]
NID
[
] - Ideal or real fluid 0 - Ideal; 1 - Real
KAPPA [
] - Adiabate exponent (Ratio of specific heats)
RGAS
[J/kgK] Gas constant
Z
[
] - Real gas factor
NC
[
] - Number of fluids in the mixture fro NIST
FLUID.FLD(1) XKG(1) - NIST: Fluid(1) - mass ratio(1)
FLUID.FLD(2) XKG(2) - NIST: Fluid(2) - mass ratio(2)
FLUID.FLD(3) XKG(3) - NIST: Fluid(3) - mass ratio(3)
FLUID.FLD(4) XKG(4) - NIST: Fluid(4) - mass ratio(4)
FLUID.FLD(5) XKG(5) - NIST: Fluid(5) - mass ratio(5)

00
01
02
03
04
05
06
07
08
09
10

[Oil Injection]
OILR
[
] - Oil to Gas Mass ratio
POIL
[ Pa] - Pressure in oil reservoir
TOIL
[ K ] - Oil injection temperature
FIOIL [rad] - Oil injection angle
ZOIL
[ m ] - Axial position of the oil port
DOIL
[ m ] - Diameter of the oil port
DSOIL [ m ] - Mean sauter diameter of oil droplet
COIL
[J/kgK] Specific heat of injected oil
ROIL
[kg/m3] Density of injected oil
VISCOIL[m2/s]- Viscosity of injected oil

O-

by WTP)

fluids)
fluids)
Vapour

00
01
02
03
04
05
06
07
08
09
10

[Thermodynamic
IPRNT [
] LW
[
] LPS
[
] LPD
[
] LC
[
] DWTP
[m/s] DPS
[ Pa] DPD
[ Pa] DTVAP [ K ] DTCON [ K ] -

[GRID control]
01 ndist [
]
02 npod
[
]
03 nang
[
]
04 ic
[
]
05 mv
[
]
06 isectNo[
]
07
08
09
10

Control Parameters]
Printout control: 0 - Full; 1 - Standard; 2 - Short
Number of tip speeds to be calculated
Number of suction pressures to be calculated
Number of discharge pressures to be calculated
Number of integration cycles
Tip speed increment
Suction pressure increment
Discharge pressure increment
Evaporation temparature increment
Condensation temperature increment
rotors - number of divisions along the lobe
rotors - number of divisions in radial direction
rotors - number of divisions in z-direct. for each lobe
Profile generation 0-Off 1-Analytical; 2-Numerical
Repair rotor interface:
1-Yes; 0-No
0-All sections; n-selected section

[CONTROL switches]
01 krot
[
] - Rotor distribution
1-on
0-off
02 krack [
] - Rack distribution
1-on
0-off
03 kdist [
] - boundary distribution
1-on
0-off
04 imesh [
] - fluid mesh calculation 1-transfinite
2-simple
05 irotm [
] - rotor mesh calculation 1-transfinite
2-simple
06 iipor [
] - inlet port calculation 1-generation
2-import
(For program geom.exe this applys only for the axial port)
07 iopor [
] - outlet port calculation 1-generation
2-import
(For program geom.exe this applys only for the axial port)
08 iprep [
] - generation of preprocessor input file
0-off
2-Pumplinx 3-StarCCM+
09 jstart [
] - Starting mesh for export for a CFD solver
10 jend
[
] - Ending
mesh for export for a CFD solver

0-off
0-off
0-off
0-off
1-CFX

[DISTRIBUTION parameters]
01 fad11 [ <1] - adaptation factor for the 1st criterion (fad11+fad12<1)
- Male
02 fad12 [ <1] - adaptation factor for the 2nd criterion (fad11+fad12<1)
- Male
03 iadd1 [
] - adaptation criterions - Male rotor:
1-Angle; 2-Radius
of curvature 3-Polar dist; 4-Flatnes; 5-Cosin; 6-Sinus distribution
04 fad21 [ <1] - adaptation factor for the 1st criterion (fad11+fad12<1)
- Female
05 fad22 [ <1] - adaptation factor for the 2nd criterion (fad11+fad12<1)
- Female
06 iadd2 [
] - adaptation criterions - Female rotor:
1-Angle; 2Radius of curvature 3-Polar dist; 4-Flatnes; 5-Cosin; 6-Sinus distribution
07 cdi1
[
] - distance of the baseline for adaptation of Male rotor
08 cdi2
[
] - distance of the baseline for adaptation of Female rotor
09 frsm
[=<1] - rack smoothing factor
0-off
10 iline [
] - make a rotor mating line 1-on
0-off
[MESHING parameters]
01 ak1-ak4[
] - K-factors in Hermite bidirectional transfinite
interpolation
02 sco
[
] - smoothing coefficient (delta) 1.-cubic; 100.-linear
03 ntr >imesh=1 - order of interpolation 1-one
2-two
3-three
ntr >imesh=3 - transformation constant 1-linear 2-quadratic 3-cubic
04 iorth [
] - mesh orthogonalization 1-on
0-off
05 al1
[
] - coeff. 1 for mesh orth. - damping to the grid interior

06 al2
boundary
07 ngrsm
09 fgrsm
10

] - coeff. 2 for mesh orth. - damping to the endpoints on

[
] - grid line smoothing - number of repetitions
[ <1] - smoothing coefficient for the grid lines smoothing

[Low pressure port]

01 irax
[
] - inlet port
1-axial 2-boath 3-radial 0-none;
02 radd
[ m ] - depth of the radial inlet port
03 ni1
[
] - inlet port - number of divisions along the circle
04 ni2
[
] - inlet port - number of divisions in radial direction
05 raad
[ m ] - depth of the axial inlet port
06 alph
[rad] - radial inlet port line angle
07 alinp [ m ] - length of the inlet port
08 endcli [ m ] - inlet endface clearance
09 aiorth [
] - orthogonalisation factor for inlet port and clearance
10
[High pressure port]
01 iora
[
] - outlet port 1-axial 2-boath 3-radial 0-none;
02 rodd
[
] - outlet radial port inner circle diameter (% of outer
dia.)
03 no1
[
] - outlet port - number of divisions along the circle
04 no2
[
] - outlet port - number of divisions in radial direction
05 nok
[
] - outlet port - number of divisions in z direction
06 alout [ m ] - length of the outlet port
07 endclo [ m ] - outlet endface clearance
08 aoorth [
] - orthogonalisation factor for outlet port and clearance
09
10
00 [Additional injection port parameters]
01 iaip
[
] - additional inlet port: 0-no; 1-yes
02 Paip
[ Pa] - Pressure in the additional injection port
03 Taip
[ K ] - Temperature in the additional injection port
04 Exaip [
] - Quality of working fluid in the additional injection
port: 0 - liquid; 1 - vapour
05 FIaip [rad] - Angle of the additional injection port
06 Zaip
[ m ] - Axial position of the additional injection port
07 Daip
[ m ] - Diameter of the additional injection port
08 iwater [
] - Water injection: 0 - no; 1- yes
09
10
[BLOCK parameters]
01 XPC
[ m ] - Coordinate system origin - X
02 YPC
[ m ] - Coordinate system origin - Y
03 ZPC
[ m ] - Coordinate system origin - Z
04 VX
[
] - Diretion vector for X axis
05 VY
[
] - Diretion vector for Y axis
06 VZ
[
] - Diretion vector for Z axis
07 R
[ m ] - Block radius
08 L
[ m ] - Block Length
09 nx
[
] - number of divisions in radial direction
10 ny
[
] - number of divisions in angular direction
11 nz
[
] - number of divisions along Z axis
4) DESCRIPTION of FILES
Short description of the files produced by SCORG is given here. Produced
files are stored in the directory <DAT> and its subdirectory <USERPROG>.
Complete content of these two directories should be transferred in the
working environment of a numerical solver.
COMET.DAT -

is Comet input script file. It reads the entire mesh in

Cometpp
(pre-processor),
it
also
defines
boundaries,

connections between blocks, control parameters and, at the

end, it defines post-processor features.
Directory <DAT> also contains three types of .DAT files, namely vertex,
cell and region files.
- CELL FILES Cells are defined by 8 nodes, 6 faces and 12 edges. The right hand rule is
applied when cells are generated. All files containing cell definitions
have the same format:
format (i6,8i8,i3)
and the structure of lines in these files is:
cell_number V1 V2 V3 V4 V5 V6 V7 V8 Cell_type
Files that contain cell definitions are:
CELL.DAT
ROTC.DAT
INPC.DAT
OUPC.DAT

cells for both

cell files for
cell files for
cell files for

rotors
solind part of the rotor
low pressure port
high pressure port

- VERTEX FILES All vertex files (except VERTALL.DAT) generated by SCORG have the same
format:
format (i6,3f12.7)
while the line structure is:
vertex_Index X1 X2 X3
where X1, X2 and X3 are coordinates of vertex in the active coordinate
system. In case of compressor numerical mesh active coordinate system is
always global Cartesian coordinate system.
Files which contain vertex definitions are:
VERT.DAT -

vertices which define rotors -this file is changed for each

time step by the subroutine UMOVGR.F
ROTV.DAT vertices which define solid rotors
OUPV.DAT vertices which define high pressure port
INPV.DAT vertices which define low pressure port
VERTALL.DAT - contains sufficient number of z-cross sections of the rotors
to define all necessary rotor positions for prescribed number
of time steps.
It is a 2D file whose format is:
format (i6,2f12.7)
- REGION FILES Files that define regions have format:
format (i6,4i8,i4)
and the structure is:
Region_index V1 V2 V3 V4 Region_Type
Regions are bounding surfaces on the block through which other blocks are
connected or the boundary condition is given. Files that contain region
definition are:
REGI.DAT - regions defined on rotors

ROTR.DAT region file for the solid rotors

INPR.DAT - regions for the inlet port
OUPR.DAT - regions for the outlet port
**************************************************************************
*
SCORG - Screw COmpressor Rotor Geometry grid generator Info
*
*
*
*
Version '5.00'
01/09/2014
*
**************************************************************************