DYRESM-CAEDYM
Installation instructions: Source code
Platform: PC (WIN32)
For the purpose of this document only the following assumptions are
made:
- Digital Visual FORTRAN 6.0 (or later) is installed on your PC
- your hard drive is c:\
If your PC has another FORTRAN compiler, the details of the instructions
below will not be relevant. However, the general work flow required to
build the executable from the source code should be the same.
To compile the support programs createDYref, createDYsim, or extractDYinfo, follow the same procedure but IGNORING step 4 (the compilation of caedym.lib). Replace "dycd" in step 5 with the appropriate program name.
======================================================
Please read the following instructions in toto before executing them.
======================================================
1. Install source code on your computer
Install the source code on your computer by using the self-extracting
archive utility. The following directory structure must be created on your
PC.
-
c:\dycd\vfproj
-
c:\dycd\include
-
c:\dycd\bin
-
c:\dycd\lib
-
c:\dycd\src\libcwrcommon
-
c:\dycd\src\dyresm
-
c:\dycd\src\caedym
2. Set up default include and library directories in Visual Fortran
6.0
Start Visual Fortran 6.0:
-
START -> PROGRAMS -> VISUAL FORTRAN 6 -> DEVELOPER STUDIO
Set up include and library directories
-
TOOLS -> OPTIONS…
Click Directories tab
Choose Include files in Show directories for:
Click in dotted box in Directories:
Type in location of include directory: c:\dycd\include
Choose Library files in Show directories for:
Click in dotted box in Directories:
Type in location of include directory: c:\dycd\lib
Click OK
3. Create CWR common library libcwrcommon.lib
The library libcwrcommon.lib is required to build dycd.exe, so it must
be compiled first and put into the library directory c:\dycd\lib\
A) Create a new project:
FILE -> NEW…
Click Projects tab
Choose Fortran Static Library
Enter in the following fields:
Project name: libcwrcommon
Location: c:\dycd\vfproj\libcwrcommon
Click OK
(Click FINISH if Visual Fortran asks if you want to create headers)
Click OK
B) Add required source code as follows:
PROJECT -> ADD TO PROJECT -> FILES…
Files of type: Fortran Source Files (*.f90 etc)
Look in: c:\dycd\src\libcwrcommon
Select all the FORTRAN files
Click OK
C) Update the dependencies:
BUILD -> UPDATE ALL DEPENDENCIES…
Choose appropriate Project configuration (‘debug’ is fine)
Click OK
Some warnings may be reported (‘could not find’-type warnings). If so then
repeat step C), which should remove the warnings. If the warnings are still
present then the include and/or library directories set up in section 3
either have been named incorrectly, or don’t contain the .lib files as
required to compile.
D) Build the object library:
BUILD -> BUILD LIBCWRCOMMON.LIB
If errors are reported then the source files added to the project may be
wrong. To retry the build first do a clean which removes all the junk created
in the last attempt to build:
Now you can re-build.
4. Create CAEDYM object library caedym.lib
The library caedym.lib is required to build dycd.exe, so it must be
compiled first and put into the library directory c:\dycd\lib\
A) Create a new project:
FILE -> NEW…
Click Projects tab
Choose Fortran Static Library
Enter in the following fields:
Project name: caedym
Location: c:\dycd\vfproj\caedym
Click OK
(Click FINISH if Visual Fortran asks if you want to create headers)
Click OK
B) Add required source code as follows:
PROJECT -> ADD TO PROJECT -> FILES…
Files of type: Fortran Source Files (*.f90 etc)
Look in: c:\dycd\src\caedym
Select all the FORTRAN files
Click OK
C) Update the dependencies:
BUILD -> UPDATE ALL DEPENDENCIES…
Choose appropriate Project configuration (‘debug’ is fine)
Click OK
Some warnings may be reported (‘could not find’-type warnings). If so then
repeat step C), which should remove the warnings. If the warnings are still
present then the include and/or library directories set up in section 3
either have been named incorrectly, or don’t contain the .lib files as
required to compile.
D) Build the object library:
BUILD -> BUILD CAEDYM.LIB
If errors are reported then the source files added to the project may be
wrong. To retry the build first do a clean which removes all the junk created
in the last attempt to build:
Now you can re-build.
5. Create DYRESM-CAEDYM executable
Repeat Section 4A except choose Fortran Console Application
instead of Fortran Static Library. Call the project "dycd". (If a Fortran Console Application
panel pops up then select Empty, then Finish followed by OK.)
Now we need to link the required libraries:
PROJECT -> SETTINGS…
Click Link tab
Type in the following file names on the end of the list in Object/library
modules:
libcwrcommon.lib caedym.lib netcdf.lib
B) Add required source code as follows:
PROJECT -> ADD TO PROJECT -> FILES…
Files of type: Fortran Source Files (*.f90 etc)
Look in: c:\dycd\src\dyresm
Select all the FORTRAN files
Click OK
PROJECT -> ADD TO PROJECT -> FILES…
Files of type: Object Files (*.obj etc)
Look in: c:\dycd\src\dyresm
Click OK
C) Update the dependencies:
BUILD -> UPDATE ALL DEPENDENCIES…
Choose appropriate Project configuration (‘debug’ is fine)
Click OK
Some warnings may be reported (‘could not find’-type warnings). If so then
repeat step C), which should remove the warnings. If the warnings are still
present then the include and/or library directories set up in section 3
either have been named incorrectly, or don’t contain the .lib files as
required to compile.
D) Build the executable:
If errors are reported then the source files added to the project may be
wrong. To retry the build first do a clean which removes all the junk created
in the last attempt to build:
Now you can re-build.
The dycd.exe which results is located in c:\dycd\vfproj\dycd\Debug
This should be copied or moved to the executable directory c:\cwrsoft\bin
(or any valid Windows path).
======================================================
date: 19 April 2001
Jason Antenucci