compaq visual fortran overview

www.compaq.com

IntroducingIntroducing

Compaq Visual FortranCompaq Visual Fortran

CompaqCompaq®® Visual Fortran Visual Fortran

Offers a combination of:Offers a combination of: The robustness and reliability of Compaq’s Fortran The robustness and reliability of Compaq’s Fortran

95 compiler95 compiler The easy-to-use MicrosoftThe easy-to-use Microsoft®®

visual development visual development environmentenvironment


32-bit Development System for 32-bit Development System for xx86 (Intel86 (Intel®® , AMD, AMD®®, , …) PCs running:…) PCs running: WindowsWindows® ® 20002000 Windows NTWindows NT®® 4 4 Windows 98Windows 98 Windows 95Windows 95

* Previous standards (Fortran 90, FORTRAN 77, FORTRAN IV) are also supported


The Compaq Fortran CompilerThe Compaq Fortran Compiler Full support of the Fortran 95 Standard*Full support of the Fortran 95 Standard* Compaq Fortran (formerly DIGITALCompaq Fortran (formerly DIGITAL®® Fortran) Fortran) and and

Microsoft Fortran language extensions for easy Microsoft Fortran language extensions for easy code portability among platformscode portability among platforms


Offers Portability from other PlatformsOffers Portability from other Platforms Microsoft-recommended upgrade for PowerStation Microsoft-recommended upgrade for PowerStation

4.0 users4.0 users Provides a consistent Fortran language dialect Provides a consistent Fortran language dialect

from desktop to mainframe-class systemsfrom desktop to mainframe-class systems Compatible with Fortran code written for other Compatible with Fortran code written for other

Compaq Fortran platforms: Compaq Fortran platforms: – Compaq Tru64Compaq Tru64TMTM UNIX UNIX® ® Alpha Alpha

– LinuxLinux®® Alpha Alpha– OpenVMSOpenVMSTM TM AlphaAlpha


Microsoft visual development environmentMicrosoft visual development environment Windows-based application developmentWindows-based application development Visual editor with color coded syntax highlightingVisual editor with color coded syntax highlighting Visual debuggerVisual debugger Context-sensitive online documentationContext-sensitive online documentation Same development environment used by Microsoft Same development environment used by Microsoft

Visual C++Visual C++® ® V6V6


Visual development toolsVisual development tools DebuggerDebugger

Source Code BrowserSource Code Browser

Windows resource editorWindows resource editor

Fortran Module Wizard for working with COM ObjectsFortran Module Wizard for working with COM Objects

Fortran COM Server Wizard for creating COM servers Fortran COM Server Wizard for creating COM servers

(Professional and Enterprise Editions)(Professional and Enterprise Editions)

Graphical viewer for visualizing multi-dimensional Graphical viewer for visualizing multi-dimensional

arrays (Professional and Enterprise Editions)arrays (Professional and Enterprise Editions)

About this demo...About this demo...

This presentation was created using Microsoft This presentation was created using Microsoft PowerPointPowerPoint®® 97 97 To perform the next event To perform the next event

(such as show a line of text or go to the next slide)(such as show a line of text or go to the next slide)– Press the Page-Down keyPress the Page-Down key

– Or press the right arrow keyOr press the right arrow key

The demo is paused while this menu is displayed


Slowing down the demoSlowing down the demo To pause the demoTo pause the demo

– Click the right mouse buttonClick the right mouse button

– This menu will appearThis menu will appear

Choosing ‘Advance’ performs the next slide action

‘Reverse’ displays the last slide you viewed

Choosing ‘End Show’ will end the demo


Project-based DevelopmentProject-based Development

Visual Fortran organizes application source files Visual Fortran organizes application source files by grouping code, libraries, and windows by grouping code, libraries, and windows resources together in one entity: the resources together in one entity: the projectproject Facilitates Windows and Mixed-Language Facilitates Windows and Mixed-Language

programmingprogramming

A Fortran Console application is atraditional text-oriented interface

that can use most Win32® APIs

To create a new project, click New from the File menu.

The following screen appears, displaying available project types.

Visual Fortran Can Build Visual Fortran Can Build Several Kinds of ProjectsSeveral Kinds of Projects


Fortran Windows Applications are GUI applications with full access

to the Win32 APIs

The QuickWin environment provides an easy way to give existing Fortran applications a Windows “look and feel”


You can also develop Fortran static and dynamic link libraries

Visual Fortran Can BuildVisual Fortran Can BuildSeveral Kinds of ProjectsSeveral Kinds of Projects

If you have the Microsoft Visual C++ or the Visual Fortran Professional or Enterprise Editions installed, additional project types will be listed (not shown on this screen).

Fortran COM ServerFortran COM Server

With the Professional or Enterprise Editions, you can develop Fortran-based COM Servers


Visual Fortran is available for Visual Fortran is available for xx86 PC systems running 86 PC systems running Windows NT, Windows 2000, Windows 98, and Windows Windows NT, Windows 2000, Windows 98, and Windows 95 operating systems. Visual Fortran uses the same 95 operating systems. Visual Fortran uses the same development environment on all operating systems:development environment on all operating systems:

– Compiler– Debugger– Source Code Browser– Fortran Module Wizard– Fortran COM Server Wizard– Array Visualizer– Online Documentation

Version 6.5 New FeaturesVersion 6.5 New Features

New Features for Version 6.5: Architecture-specific support for Pentium III, AMD K6, AMD

K6-2/K6-III, and AMD Athlon processors Fortran COM Server project type and Fortran COM Server

Wizard (in Professional and Enterprise Editions) simplify creating Fortran-based COM servers. You can create in-process servers that use custom or dual interfaces

New COM routines COMStringFromGUID and COMIsEqualGUID

New and changed intrinsics:– INT_PTR_KIND returns the KIND for an integer that is large enough

to hold an address– POPCNT, POPPAR, LEADZ, and TRAILZ – Optional KIND argument to LEN, SHAPE, SIZE, LBOUND, and

UBOUND

Version 6.5 New FeaturesVersion 6.5 New Features

New exception handling routines CLEARSTATUSFPQQ and New exception handling routines CLEARSTATUSFPQQ and GETEXCEPTIONPTRSQQ (GETEXCEPTIONPTRSQQ (xx86 systems)86 systems)

New environment variable FORT_CONVERT_New environment variable FORT_CONVERT_extext for for unformatted non-native filesunformatted non-native files

Support added to read nondelimited character strings as Support added to read nondelimited character strings as input for character NAMELIST items input for character NAMELIST items

DLLEXPORT and DLLIMPORT of variables now allow DLLEXPORT and DLLIMPORT of variables now allow export/import of module variables and arrays. export/import of module variables and arrays.

Concurrent-use licensing is now available Concurrent-use licensing is now available Many new sample programsMany new sample programs Faster processing of modules at compile timeFaster processing of modules at compile time

New Features in Version 6New Features in Version 6

In addition to v6.5 new features, earlier Visual In addition to v6.5 new features, earlier Visual Fortran V6 releases included hundreds of new Fortran V6 releases included hundreds of new and improved features, which include:and improved features, which include: Full Fortran 95 Standard support. Full Fortran 95 Standard support. Optional diagnostics flag features deemed Optional diagnostics flag features deemed

"obsolescent" or "deleted" (such features are still "obsolescent" or "deleted" (such features are still supported by the compiler). supported by the compiler).

New Features in Version 6New Features in Version 6 New optimization features can significantly improve New optimization features can significantly improve

application performance over V5, including application performance over V5, including architecture-specific optimizations.architecture-specific optimizations.

Full traceback reporting on severe errors with file Full traceback reporting on severe errors with file names, routine names, and line numbers.names, routine names, and line numbers.

Dialog support now includes modeless dialogs and Dialog support now includes modeless dialogs and additional controls, including ActiveX® controls, additional controls, including ActiveX® controls, progress, tab, and spin controls.progress, tab, and spin controls.

Microsoft's newest visual development environment, Microsoft's newest visual development environment, featuring seamless integration with Microsoft Visual featuring seamless integration with Microsoft Visual C++ V6, makes it easy to develop and debug mixed-C++ V6, makes it easy to develop and debug mixed-language applications.language applications.

New Features in Version 6New Features in Version 6 New Fortran application wizards help you get started New Fortran application wizards help you get started

on new projects. on new projects. You can save Fortran project settings for later use You can save Fortran project settings for later use

when creating new projects of the same project type.when creating new projects of the same project type. Compaq Extended Math Library (CXML) is now Compaq Extended Math Library (CXML) is now

provided, including over 1500 mathematical routines.provided, including over 1500 mathematical routines. Compaq Array Visualizer (in Professional and Compaq Array Visualizer (in Professional and

Enterprise Editions only) provides an interactive Enterprise Editions only) provides an interactive graphic view of your application's array data. graphic view of your application's array data.


Traceback ReportingTraceback Reporting When a Fortran program terminates due to a severe When a Fortran program terminates due to a severe

error condition, the Fortran run-time system displays error condition, the Fortran run-time system displays a report of the calling sequence leading to the error. a report of the calling sequence leading to the error. This tabular report contains one line per call stack This tabular report contains one line per call stack frame and includes at least the image name and a frame and includes at least the image name and a hexadecimal program counter (PC) in that image.hexadecimal program counter (PC) in that image.


Traceback ReportingTraceback Reporting When you request traceback information during

compilation, the report contains program counter to source file line correlation information in the displayed error message report. The file names, routine names, and line numbers simplify the task of locating the cause of severe run-time errors.

New Features in Version 6New Features in Version 6A traceback report might appear as follows:A traceback report might appear as follows:

The stack frame of real interest is the first frame in image teof.exe, which shows that the error originated in the routine named AGAIN in source module teof.for at line 21

Compaq Extended Math Library (CXML)Compaq Extended Math Library (CXML)

Compaq Extended Math Library (CXML) provides:Compaq Extended Math Library (CXML) provides: Basic Linear Algebra Subprograms (BLAS) libraryBasic Linear Algebra Subprograms (BLAS) library

– Industry-standard Basic Linear Algebra Subprograms, including Level 1 (vector-vector, BLAS1), Level 2 (matrix-vector, BLAS2), and Level 3 (matrix-matrix, BLAS3), BLAS Level 1 Extensions, and Sparse BLAS Level 1.

Signal Processing library Signal Processing library – Provides a basic set of signal processing functions, including one-, two-,

and three-dimensional Fast Fourier Transforms (FFT), group FFTs, Cosine/Sine Transforms (FCT/FST), Convolution, Correlation, and Digital Filters.

Sparse Linear System librarySparse Linear System library– Provides both direct and iterative sparse linear system solvers. The

direct solver package supports both symmetric and nonsymmetric sparse matrices stored using the skyline storage scheme. The iterative solver package contains a basic set of storage schemes, preconditioners, and iterative solvers.

Compaq Extended Math Library (CXML)Compaq Extended Math Library (CXML)

LAPACK subprogramsLAPACK subprograms– Industry-standard subprogram package offering an extensive set

of linear system and eigenproblem solvers. LAPACK uses blocked algorithms that are better suited to most modern architectures.

Utility subprogramsUtility subprograms– Provides random number generation, vector math functions, and

sorting subprograms. CXML is also available for other Compaq Fortran Alpha CXML is also available for other Compaq Fortran Alpha

platforms platforms (see (see http://www.compaq.com/mathhttp://www.compaq.com/math)) To call CXML routines from Visual Fortran, add the following To call CXML routines from Visual Fortran, add the following

INCLUDE statement:INCLUDE statement:

INCLUDE 'CXML_INCLUDE.F90’

Main MenuMain Menu

I would like to…I would like to… Learn more about the Microsoft visual Learn more about the Microsoft visual

development environmentdevelopment environment Learn more about mixed language programming Learn more about mixed language programming

and dynamic link librariesand dynamic link libraries Learn more about using COM objects with Visual Learn more about using COM objects with Visual

FortranFortran Learn about Visual Fortran Professional EditionLearn about Visual Fortran Professional Edition Learn about the Compaq Array VisualizerLearn about the Compaq Array Visualizer End the presentationEnd the presentation

Building a Project: qwpaintBuilding a Project: qwpaint

We will now use Compaq Visual Fortran to build We will now use Compaq Visual Fortran to build a Fortran QuickWin application named qwpainta Fortran QuickWin application named qwpaint

This sample application draws simple colored This sample application draws simple colored shapes with the mouseshapes with the mouse

Along the way we’ll be using the Debugger and Along the way we’ll be using the Debugger and Browser to help us fix a problem in our programBrowser to help us fix a problem in our program

Back to Main Menu

Welcome to the visual development environment!

The visual development environment allows you to compile and run your Fortran application with a click of a button

Before we begin, we will customize the visual development environment’s appearance to suit our needs

Back to Main Menu

The toolbars can be repositioned within the visual development environment

Back to Main Menu

Other useful windows can be displayed as well

Back to Main Menu

The Output window displays compile and link errors as well as debugging information

Back to Main Menu

Back to Main Menu

Choose the File | New... menu item to create a new Project

Choose Fortran QuickWin Application as the kind of project to build

Don’t forget to name your project

You can specify in which directory it is placed (or accept the default location)

Back to Main Menu

The “New” dialog box...The “New” dialog box...

In our application, we’ll use multiple windows

Select the Windows interface best suited to your application

Back to Main Menu

Back to Main Menu

The qwpaint project has been opened.

Now we will add somefiles to the project

Use this dialog box to selectthe source files for the project.

Back to Main Menu

Insert Files into a Project...Insert Files into a Project...

The files are listed under Source Files in the Project Window.

To edit a file, double-click its name.

As a default, the editor highlightsFortran keywords in blueand comments in green

Back to Main Menu

Back to Main Menu

Information about the buildwill be displayed here

Clicking the build button or choosing

Build | Build qwpaint.exe willcompile and link this project

After adding files to a project, select each new file in the FileView pane and select Compile from

the Build menu.

It looks like we have a syntax error.

Back to Main Menu

The qwpaint Project requires qwpaint.mod

Double clicking on the error message or pressing F4 brings the editor to the erroneous line

Back to Main Menu

Now that the problem has been fixed, rebuild the project

Back to Main Menu

Oh good, everything built

Let’s run the application

Back to Main Menu

This is what our application looks like

The mouse drawsshapes in this window

Over here, you canadjust the shape

and its color

Back to Main Menu

It looks like we have a bugin our program!

This area should have 16 differentcolored squares.

Like this!

Back to Main Menu

Now we need to debug our program.

The visual development environment makes this easy, though.

Back to Main Menu

But where do we begin?

From this comment, we can guessthat the bug occurs in the

subroutine DrawControlGrid()

Back to Main Menu

We could do a text searchfor DrawControlGrid()...

…but that would be slow andcould become complicatedif we had to search through

a number of files.

We’d like to locateDrawControlGrid()

in the code.

Back to Main Menu

Back to Main Menu

We can use the “Find in Files” tool to search a number

of files for a certain string

The text to search for...

…where to look for the files

Back to Main Menu

““Find in Files…”Find in Files…”

Results of the search are displayed in this window

Back to Main Menu

“Find in Files” finds all occurrences of a given string, but we’d like to know more.

Specifically, we’d like to know where DrawControlGrid() is defined.

Back to Main Menu

For this task we can useVisual Fortran’s

Source Code Browser

Back to Main Menu

Back to Main Menu

To use the source code browser,we need to adjust the project settings

Settings must be changed under the “Fortran” and “Browse Info” tabs

Back to Main Menu

The “Project Settings” dialog box...The “Project Settings” dialog box...

Back to Main Menu

The project settings dialog box also allows you to generate listing and assembly files.

The “Project Settings” dialog box...The “Project Settings” dialog box...

Back to Main Menu

Rebuild your project to generate browser information

…then in the Tools menu choose Source Browser to start browsing

This is the main Browser dialog box

You can browse informationabout any identifier in your source code. We want to know about DrawControlGrid

You can get information about variable declaration and usage, call structure, and file hierarchy.

Back to Main Menu

Since the Fortran language is not case-sensitive, be sure to uncheck the “case-sensitive” check box!

Clicking “OK” brings up this box

This window lists all of theplaces in your code in whichDrawControlGrid() occurs

Double-click on any of theseentries to go to that lineof source code

Back to Main Menu

We want to know where DrawControlGrid is defined.

Back to Main Menu

Double-click on the definition...

…and the Browser takes you right to the code

Back to Main Menu

If we look at the code forDrawControlGrid(), we seethat the grid is drawn here

The function setcolor is calledto change the color

Back to Main Menu

We’d like to know more about the setcolor QuickWin function.

We can use the HTML Help Viewer online documentation to get informationabout setcolor.

Back to Main Menu

and press the F1 key to search the online help.

Click the word we’d liketo know more about...

Back to Main Menu

This dialog box searches the online help.

Click Display to view the help page

Back to Main Menu

A new window opens to allow you to view the online documentation.

Information about functionparameters and return values.

Description of usageand functionality available in

“Remarks”

Back to Main Menu

Links to other online documentation

Many help topics come with example code

Back to Main Menu

You can browse the online helpby clicking on the various topics

Back to Main MenuBack to Main Menu

We think that the bug occurs somewhere in this code

Let’s use the Visual Fortrandebugger to see what

happens during execution

Back to Main Menu

Click this buttonto start debugging

Click the hand toset a breakpoint

at the currentcursor position

Back to Main Menu

The visual development environment has changed into debugging mode

This arrow points to thenext line to be executed

Back to Main Menu

This window allows you to view the values of local variables.

Over here, you can watch thevalue of a certain variable.

Records and arrays canbe viewed in their entirety

with just the click of a button

Back to Main Menu

You can step through theprogram by clicking this icon

Variable values are updated automatically

Back to Main Menu

After some more debugging, we findthe answer to our problem.

By examining the values of i, j, and i2, we determine that the argument to setcolor should be i*4+j not i*4+i

Back to Main Menu

Now that we have changed our source code...

Back to Main Menu

…we can stop

debugging...

..and rebuild

No errors! Let’s run our application

Back to Main Menu

Our problemhas been fixed

Back to Main Menu

Back to Main Menu

Building a Project: qwpaintBuilding a Project: qwpaint

We used Visual Fortran to build an application We used Visual Fortran to build an application that used the QuickWin graphics librariesthat used the QuickWin graphics libraries

The source files were organized using a projectThe source files were organized using a project We used the context-sensitive feature of the We used the context-sensitive feature of the

online documentation online documentation The Browser and Debugger helped us fix a The Browser and Debugger helped us fix a

couple of problems with our programcouple of problems with our program

Main MenuMain Menu





Back to Main Menu

Building a DLLBuilding a DLL

Functions in dynamic-link libraries (DLLs) are not Functions in dynamic-link libraries (DLLs) are not loaded until they are called at run-timeloaded until they are called at run-time

Using DLLs reduces the size of executables and Using DLLs reduces the size of executables and modularizes source codemodularizes source code

Back to Main Menu


We will now use Visual Fortran to construct a We will now use Visual Fortran to construct a DLLDLL

The DLL will be written using fixed-source form The DLL will be written using fixed-source form syntax, but its functions will be called in programs syntax, but its functions will be called in programs written in Fortran 95 and C++written in Fortran 95 and C++

Even though Microsoft Visual C++ 6 is purchased Even though Microsoft Visual C++ 6 is purchased separately from Visual Fortran, both products separately from Visual Fortran, both products share the same development environment!share the same development environment!

Back to Main Menu


Our application will be called spline because our Our application will be called spline because our DLL contains functions that perform a spline DLL contains functions that perform a spline analysis on dataanalysis on data

spline also introduces the concept of visual spline also introduces the concept of visual development environment workspaces. development environment workspaces. Workspaces allow several projects to be grouped Workspaces allow several projects to be grouped together.together.

Back to Main Menu


spline demonstrates mixed language spline demonstrates mixed language programming using Visual Fortran and Visual C+programming using Visual Fortran and Visual C+++ Installing Visual C++ adds options to the visual Installing Visual C++ adds options to the visual

development environment that are not applicable to development environment that are not applicable to Visual FortranVisual Fortran– Different kinds of Projects to buildDifferent kinds of Projects to build

– C++ toolsC++ tools

Back to Main Menu


The spline Workspace consists of three Projects:The spline Workspace consists of three Projects: splinedll - a DLL containing routines that perform a splinedll - a DLL containing routines that perform a

spline analysis on dataspline analysis on data splineqw - a Visual Fortran QuickWin application splineqw - a Visual Fortran QuickWin application

that calls routines in splinedll.dllthat calls routines in splinedll.dll splinevc - a Visual C++ program that uses the splinevc - a Visual C++ program that uses the

routines in splinedll.dllroutines in splinedll.dll

To create a new workspace,choose File | New...

Back to Main Menu

We’ll create a Fortran Dynamic Link Library project...

…called splinedll...

…and simultaneously create a workspace for our project

Back to Main Menu

…and click “Finish”...

Back to Main Menu

Choose “an empty DLL application” in the app-wizard dialogue...

The App Wizard creates an empty workspace for our project.

Let’s add some files to the splinedll project

Back to Main Menu

Insert the spline.for fileinto the splinedll project

Back to Main Menu

The visual development environment editor formats itself for editing fixed-form Fortran source code

spline.for contains two functions,SplineCalculate() and SplineEvaluate(),

which determine the spline curve

Back to Main Menu

Back to Main Menu

Build the DLL just like you would any other

project

Now we’re going to build splineqw, a Fortran QuickWin program

that uses splinedll.dll

--------------------Configuration: spldll - Win32 Debug--------------------spline.dll - 0 error(s), 0 warning(s)

Back to Main Menu

We’ll create a Fortran Quick Win project...

…called splineqw...

…and include it into our current workspace

Back to Main Menu

Choose the windowing options that best suit your application

And the Wizard inserts the new project into your workspace

Select the Windows interface that best suits your application

Back to Main Menu

Now that we’ve created the splineqw project...

…we’ll add some files to it

Back to Main Menu

Be sure to insert it into the correct project

Locate the file you wish to insert

Back to Main Menu

Fspline.f90 uses the QuickWin graphics library to draw a spline curve that fits some data points

Back to Main Menu

Before we can build Splineqw.exe, we have to link in file splinedll.lib

We can do that by adding the (relative) path here in the Project settings dialog

Back to Main Menu

Instead of adding the link path, you can add the splinedll.lib file to the project by using the Add to Project … Files item in the Project menu

Before we can run splineqw.exe, we must be sure that the system can find splinedll.dll

The simplest way to assure this is to physically move (or copy) splinedll.dll into the directory which contains our executable file, splineqw.exe

Back to Main Menu

Build splineqw.exe

Back to Main Menu

In splineqw the user clicks on a window and a spline curve is displayed that best fits the clicked points

Back to Main Menu

Next we’ll use Visual C++ to build a new Windows application that uses splinedll.dll

We can perform mixed-language programming using Visual Fortran and Visual C++ in the same development environment

Back to Main Menu

We’ll create a Visual C++ Win32 application

…called splinevc...

…and include it into our current workspace

Back to Main Menu

Choose to build an empty project...

…and the AppWizard finishes the job

Back to Main Menu

Splinevc uses the Microsoft Foundation Classes to create a user interface

Back to Main Menu

We must specify that we are using the Microsoft Foundation Classes under Project Settings

Back to Main Menu

Instead of adjusting the link settings, splinedll.lib can be added directly to the project!

Back to Main Menu

Before you attempt to build any project, make sure it is set as the Active Project

Back to Main Menu

Now we are ready to build splinevc.exe Splinevc runs similarly

to splineqw

Back to Main Menu

The MFC application has a different look to it...

…but it performs the same task

Back to Main Menu

Back to Main Menu


We used Visual Fortran to build a dynamic link We used Visual Fortran to build a dynamic link library that contained functions to perform a library that contained functions to perform a spline analysisspline analysis

Within the same Workspace we built two Within the same Workspace we built two applications that used the DLL: one written in applications that used the DLL: one written in Fortran and the other in C++Fortran and the other in C++

Main MenuMain Menu





Back to Main Menu

Working with COM ObjectsWorking with COM Objects

Many windows applications provide a means of Many windows applications provide a means of accessing their functionality from another accessing their functionality from another programprogram

The Component Object Model (COM) is one such The Component Object Model (COM) is one such mechanismmechanism

Back to Main Menu


COM is a language independent object model COM is a language independent object model designed for application interactiondesigned for application interaction But the Fortran language does not support objectsBut the Fortran language does not support objects

The Visual Fortran Module Wizard allows you to The Visual Fortran Module Wizard allows you to integrate COM objects into your Fortran integrate COM objects into your Fortran application developmentapplication development

Back to Main Menu


The Module Wizard creates Fortran module files The Module Wizard creates Fortran module files that provide an interface to functions used to that provide an interface to functions used to access COM objectsaccess COM objects The Fortran Module Wizard helps you create The Fortran Module Wizard helps you create

Fortran applications (clients) that use existing COM Fortran applications (clients) that use existing COM or Automation serversor Automation servers

The Professional and Enterprise editions include The Professional and Enterprise editions include the ability to create an in-process COM server the ability to create an in-process COM server (described in the section Visual Fortran (described in the section Visual Fortran Professional Edition).Professional Edition).

Back to Main Menu


We will now build a Console application that uses We will now build a Console application that uses the Module Wizard to access a COM Objectthe Module Wizard to access a COM Object

dlines uses the visual development environment dlines uses the visual development environment itself to modify a Fortran source fileitself to modify a Fortran source file Replaces “debug characters” in column 1 with Replaces “debug characters” in column 1 with

conditional compilation IF DEFINED directivesconditional compilation IF DEFINED directives

Back to Main Menu


dlines calls COM routines from Developer Studio dlines calls COM routines from Developer Studio that:that: Start the visual development environment runningStart the visual development environment running Open a file within the visual development Open a file within the visual development

environmentenvironment Perform editing functions on the open filePerform editing functions on the open file

– replace text, go to the next line, etc.replace text, go to the next line, etc. Save the fileSave the file Close the applicationClose the application

First we need to make a new Project

Back to Main Menu

New Fortran Console Application

Named dlines

Back to Main Menu

Choose to build an empty project...

…and the AppWizard finishes the job

Back to Main Menu

Now let’s use the Module Wizard to create the interface to the visual development environment’s COM functions

Choose Fortran Module Wizard from the Tools menu

Back to Main Menu

We’ll be getting informationfrom a COM interface

Our Fortran module will be named dsapp

Back to Main Menu

The Visual Fortran Module WizardThe Visual Fortran Module Wizard

Use the Visual C++

Shared Objects

You can specify whichCOM Interfaces you

want access to

Back to Main Menu

C:\PROGRAM FILES\MICROSOFT VISUAL STUDIO\COMMON\MSDEV98\BIN\DEVSHL.DLL (Visual C++ Shared Objects)C:\PROGRAM FILES\MICROSOFT VISUAL STUDIO\COMMON\MSDEV98\BIN\DEVSHL.DLL (Visual C++ Shared Objects)


Might as well have accessto all of the COM InterfacesGenerate the Fortran

module file

Back to Main Menu


You can specify the name of the source file containing

the Fortran modules

Back to Main Menu


We’ll repeat the process for another DeveloperStudio COM Object

This module willbe called ds_text

Back to Main Menu


…select all of the COM Interfaces as before...

…generate the Fortran module file and save it

as dstext.f90

Using the Visual C++

Text Editor this time...

C:\PROGRAM FILES\MICROSOFT VISUAL STUDIO\COMMON\MSDEV98\BIN\DEVEDIT.PKG (Visual C++ Text Editor)C:\PROGRAM FILES\MICROSOFT VISUAL STUDIO\COMMON\MSDEV98\BIN\DEVEDIT.PKG (Visual C++ Text Editor)

Back to Main Menu

Back to Main Menu

Add the files generated by the Module Wizard to the dlines project

dsapp.f90 was generated by the Fortran Module Wizard

Back to Main Menu

This is an INTERFACE to the function IGenericDocument_Save(), which saves

the file open in the visual text editor

Let’s add these sample files which are located in your samples\advanced\com\dlines directory

Back to Main Menu

These two files make use of theinterfaces in dsapp and dstext

Back to Main Menu

… $IGenericDocument_Save() is called to save the changes

After other COM functions are calledto modify the Fortran source file...

Back to Main Menu

Now, let’s take a look at the program in action

This Fortran fixed-format file contains lines beginning with

the letters ‘D’ and ‘E’.

We’ll use dlines to change the‘E’ debug lines to preprocessed

IF DEFINED statements

Visual Fortran allows only“Debug Lines” that start with ‘D’

Back to Main Menu

[Mbcomp.for]

Execute the program

Specify the file on which to operate*

The debug character and the IF DEFINED variable

to replace it with

Back to Main Menu

• Remember to use quotation marks when typing DOS pathnames that contain spaces

dlines.exedlines.exe

The ‘E’ debug lines have been

replaced with conditionalcompilation IF DEFINED

directives

Back to Main Menu

Mbcomp2.for *

Back to Main Menu


dlines made use of functions that are a part of a dlines made use of functions that are a part of a Component Object Model ObjectComponent Object Model Object

The Visual Fortran Module Wizard was used to The Visual Fortran Module Wizard was used to create a Fortran module file that allowed dlines to create a Fortran module file that allowed dlines to interact with Developer Studiointeract with Developer Studio

dlines used functions that are a part of the visual dlines used functions that are a part of the visual development environment to edit a Fortran development environment to edit a Fortran source filesource file

Main MenuMain Menu





Back to Main Menu

Visual Fortran Professional EditionVisual Fortran Professional Edition

In addition to the Standard Edition, a Professional In addition to the Standard Edition, a Professional Edition is available that includes:Edition is available that includes: The complete visual development environmentThe complete visual development environment IMSL numerical librariesIMSL numerical libraries Fortran COM Server Wizard and project typeFortran COM Server Wizard and project type Compaq Array VisualizerCompaq Array Visualizer

The Enterprise Edition includes the Professional The Enterprise Edition includes the Professional Edition software, plus other software that lets you Edition software, plus other software that lets you use Visual Fortran (on a PC) to develop use Visual Fortran (on a PC) to develop applications for Compaq Tru64 UNIX and other applications for Compaq Tru64 UNIX and other UNIX systems. UNIX systems.

Back to Main Menu


The Visual NumericsThe Visual Numerics®® IMSL numerical libraries provide IMSL numerical libraries provide over 900 Fortran routines for performing advanced over 900 Fortran routines for performing advanced mathematical algorithmsmathematical algorithms

Applied mathematicsApplied mathematics Statistical functionsStatistical functions Helper functions for printing, etc.Helper functions for printing, etc.

IMSL libraries are available for many other OS/architecture IMSL libraries are available for many other OS/architecture platforms (see http://www.vni.com) platforms (see http://www.vni.com)

To call IMSL routines from Visual Fortran, add the To call IMSL routines from Visual Fortran, add the following USE statement:following USE statement:

USE Numerical_librariesUSE Numerical_libraries

Back to Main Menu


IMSL General Mathematics libraryIMSL General Mathematics library Solving Linear SystemsSolving Linear Systems Matrix and vector manipulation Matrix and vector manipulation Eigenvalues and eigenvectorsEigenvalues and eigenvectors Integration and differentiationIntegration and differentiation Differential equationsDifferential equations TransformsTransforms Printing, sorting, and other utilitiesPrinting, sorting, and other utilities

Back to Main Menu


IMSL Statistics LibraryIMSL Statistics Library Basic statistics, regression, correlationBasic statistics, regression, correlation Analysis of varianceAnalysis of variance Covariant structures and factor analysisCovariant structures and factor analysis Multidimensional scalingMultidimensional scaling Density and hazard estimationDensity and hazard estimation Functions for printing console-based charts and Functions for printing console-based charts and

graphs (histogram, scatter, etc.)graphs (histogram, scatter, etc.)

Back to Main Menu

IMSL Library ExampleIMSL Library Example

We will now build a Fortran Console application We will now build a Fortran Console application that uses a couple of the IMSL statistics routinesthat uses a couple of the IMSL statistics routines

mnrain.exe plots some data in a vertical mnrain.exe plots some data in a vertical histogramhistogram The data is the average precipitation in Minnesota The data is the average precipitation in Minnesota

in the month of Marchin the month of March

Back to Main Menu

IMSL Library ExampleIMSL Library Example

This sample program comes from the IMSL This sample program comes from the IMSL online documentation online documentation

After looking at the online documentation, we will After looking at the online documentation, we will build a Visual Fortran projectbuild a Visual Fortran project

The IMSL libraries come with extensive online documentation as well as a number of example programs

Back to Main Menu

In the contents, click Appendix B, Alphabetic Summary of Routines. Locate VHSTP.

The VHSTP routine is in Volume 2, so open the file STATVOL2.

Back to Main Menu

The IMSL documentation offersinformation about the routine’s

usage and arguments

Back to Main Menu

This sample program calls VHSTP to draw a vertical

histogram of some data

Let’s build this exampleprogram using Visual Fortran

It also uses another IMSLroutine, OWFRQ, to

tabulate the data

Back to Main Menu

Back to Main Menu

Copy the program text from the online help into a Visual Fortran source file. In the Edit menu: 1. Click Select All. 2. Click Copy

Back to Main Menu

Now we need to add the source code to our project

So, we’ll create an emptyFortran source file

Back to Main Menu

We’ve made a Fortran Console Application and named it mnrain

mnrain - Compaq Visual Fortran

We want to make a new File...

We want it to be Fixed Format (.for)

Add it to the currentproject (mnrain)

…named mnrain.for

Back to Main MenuBack to Main Menu

Back to Main Menu

Now, we’ll paste the IMSL example into mnrain.for

mnrain.for is open in the editor

and has been added to the project

mnrain - Compaq Visual Fortran

Back to Main Menu

After we paste in the text from the IMSL documentation file, edit the text to fit in fixed format:

1. Add the line: USE Numerical_Libraries 2. Comment out the line containing EXTERNAL 3. Change the single quote characters to ASCII single quotation marks 4. Remove extra non-source text

Back to Main Menu

Let’s compile this file to check for errors.

Now let’s build and execute the application

Back to Main Menu

By calling two IMSL library routines,our data was tabulated and displayed

in this histogram

Back to Main Menu

mnrain.exemnrain.exe

Creating Fortran COM ServersCreating Fortran COM Servers

Visual Fortran (all editions) provides the Fortran Module Wizard Visual Fortran (all editions) provides the Fortran Module Wizard to help generate code needed to use COM and Automation to help generate code needed to use COM and Automation objects (Fortran client applications).objects (Fortran client applications).

Visual Fortran Professional and Enterprise Editions also provide Visual Fortran Professional and Enterprise Editions also provide the ability to create a Fortran COM server.the ability to create a Fortran COM server.

The Fortran COM Server Wizard helps you generate a Fortran The Fortran COM Server Wizard helps you generate a Fortran application that creates a COM server or a server that supports application that creates a COM server or a server that supports dual interfaces. The initial implementation in V6.5 supports only dual interfaces. The initial implementation in V6.5 supports only in-process servers, loaded into the client's process.in-process servers, loaded into the client's process.

COM is language independent, so clients can be created by COM is language independent, so clients can be created by Visual Basic, Visual C++, Visual Fortran, and other tools that Visual Basic, Visual C++, Visual Fortran, and other tools that support COM.support COM.

COM servers are reusable components, so multiple client COM servers are reusable components, so multiple client applications can use the server.applications can use the server.

Back to Main Menu


Creating a Fortran COM Server consists of these steps:Creating a Fortran COM Server consists of these steps: Create a Fortran COM Server project. This includes specifying a Create a Fortran COM Server project. This includes specifying a

class name, interface name, and derived-type name. Select the class name, interface name, and derived-type name. Select the Fortran COM Server project type when creating the project. Fortran COM Server project type when creating the project.

Use the Fortran COM Server Wizard to define the interface(s) Use the Fortran COM Server Wizard to define the interface(s) defined by the class, including the methods, properties, and defined by the class, including the methods, properties, and the arguments for each interface. the arguments for each interface.

When you build the project, the Fortran COM Server Wizard When you build the project, the Fortran COM Server Wizard generates code. You need to modify the source files by adding generates code. You need to modify the source files by adding code to supply the implementation of the methods.code to supply the implementation of the methods.

Test the Fortran COM server, by creating one or more clients to Test the Fortran COM server, by creating one or more clients to access the server.access the server.

Deploy the Fortran COM server. Deploy the Fortran COM server.

Back to Main Menu

After you create the Fortran COM Server project, you specify a Class name, Class derived-type name, and Interface name.

When you click OK, the Fortran COM Server Wizard appears:The Fortran COM Server Wizard helps you

define the interface's methods, properties, and their arguments.


Back to Main Menu

The left pane shows the COM server hierarchy.

The right pane shows the properties of the currently selected item (in this case the COM Server Adder)


Back to Main Menu

Choose whether a COM or dual interface is needed

Adder is the COM server and also the project nameAddingMachine is the class nameIAdd is the interface name (interface names start with I)AddingMachine_Instance is the Class derived-type name

Expand the + signs and click Iadd to display the interface properties


To add Clear and Add methods for the IAdd interface:To add Clear and Add methods for the IAdd interface: 1. Select the IAdd interface 2. Click New 3. Select Method, type in Clear, and click OK 4. Repeat steps 1-3, specifying the name Add 5. Select the Add method 6. Click New 7. Select Argument, type in Operand, and click OK 8. Specify the Fortran data type as REAL(4) 9. Let's assume you are done, so click Save


Back to Main Menu


Back to Main Menu

In the FileView pane, expand the + next to Adder files and Source Files folders.

The TODO.TXT file informs you of changes made to your project by the Wizard, and lets you know when you need to make changes.

Once you click Save, your project appears.


You need to modify the source files after lines that You need to modify the source files after lines that start with ! TODO..., build the project, and then use start with ! TODO..., build the project, and then use one of the clients to test the server.one of the clients to test the server.

To activate the COM Server Wizard later, open your To activate the COM Server Wizard later, open your Fortran COM Server project and click Fortran COM Fortran COM Server project and click Fortran COM Server Wizard in the View menu.Server Wizard in the View menu.

For more information, see:For more information, see: The Creating a COM Server chapter in the online

Programmers Guide. The Adder sample in ...Samples\Advanced\COM\Adder,

which contains Visual C++ and Visual Fortran clients as subprojects.

Back to Main Menu

Back to Main Menu


The Professional Edition includes the IMSL numerical The Professional Edition includes the IMSL numerical libraries, Fortran COM Server Wizard, and the libraries, Fortran COM Server Wizard, and the Compaq Array Visualizer. The Array Visualizer is Compaq Array Visualizer. The Array Visualizer is discussed in the next section.discussed in the next section.

The Visual Fortran Enterprise Edition includes the The Visual Fortran Enterprise Edition includes the Visual Fortran Professional Edition, plus other Visual Fortran Professional Edition, plus other software that lets you use Visual Fortran on your software that lets you use Visual Fortran on your xx86 86 PC system to develop applications for Compaq Tru64 PC system to develop applications for Compaq Tru64 UNIX, and other UNIX and Linux systems. The UNIX, and other UNIX and Linux systems. The Enterprise Edition has a separate slide show.Enterprise Edition has a separate slide show.

Main MenuMain Menu





Back to Main Menu

The Compaq Array VisualizerThe Compaq Array Visualizer

Compaq Visual Fortran Professional and Compaq Visual Fortran Professional and Enterprise Editions are equipped with the Enterprise Editions are equipped with the Compaq Array VisualizerCompaq Array Visualizer

The Array Visualizer uses ActiveX technology to The Array Visualizer uses ActiveX technology to visualize multi-dimensional arrays of data visualize multi-dimensional arrays of data generated by Visual Fortran programsgenerated by Visual Fortran programs

Back to Main Menu


The Compaq Array Visualizer can be:The Compaq Array Visualizer can be: Run as a standalone program called Array ViewerRun as a standalone program called Array Viewer Controlled by your Visual Fortran or Visual C++ Controlled by your Visual Fortran or Visual C++

applicationapplication Embedded as an ActiveX control within a Visual Embedded as an ActiveX control within a Visual

Fortran, Visual C++, or Visual BasicFortran, Visual C++, or Visual Basic®® application application Used in conjunction with the visual development Used in conjunction with the visual development

environment to view large arrays while debuggingenvironment to view large arrays while debugging

Back to Main Menu


Compaq Visual Fortran Professional and Compaq Visual Fortran Professional and Enterprise Editions give you full access to the Enterprise Editions give you full access to the power of the Array Visualizerpower of the Array Visualizer Build Applications that interact with the Array Build Applications that interact with the Array

VisualizerVisualizer Use the Array Visualizer to view large multi-Use the Array Visualizer to view large multi-

dimensional arrays while debuggingdimensional arrays while debugging

Back to Main Menu


The Array Visualizer interacts with other The Array Visualizer interacts with other programs:programs: As an embedded ActiveX control in Visual Fortran, As an embedded ActiveX control in Visual Fortran,

Visual C++, and Visual Basic applicationsVisual C++, and Visual Basic applications Operated via a simple set of function calls in C and Operated via a simple set of function calls in C and

Fortran programsFortran programs

Back to Main Menu


In the following slides we will see the Array In the following slides we will see the Array Visualizer at workVisualizer at work Rendering 3D graphs of array dataRendering 3D graphs of array data Being controlled by a Visual Fortran ProgramBeing controlled by a Visual Fortran Program

Back to Main Menu

The data in the array are

displayed in this grid

This pane contains a graphical view of the data

The Compaq Array ViewerThe Compaq Array Viewer

Clicking here brings up the color bar

Back to Main Menu

The data in the array are plotted along the z-axis

Each z-value is assigned a color

The name and the type of the array are shown here

Back to Main Menu

Back to Main Menu

The red marker is used to

indicate the current array

element

Double-clicking on the graph will update the marker and grid

accordingly

Notice the new position of the marker on the color

bar

The current array element is listed here

Back to Main Menu

You can rotate the graph using the

mouse

Just click and drag...

Back to Main Menu

The Compaq Array Viewer can open array data files

Back to Main Menu

In addition, you can “zoom in” on a

specific region of the graph...

…and customize the colors and scaling factors used in the

graph.

Back to Main Menu

The Compaq Array Visualizer allows you to create a Visual

Fortran application that uses the Array Viewer.

Back to Main Menu

A set of Array Visualizer Fortran routines lets your application control the action of the Array Viewer.

Back to Main Menu

This Array Visualizer program displays an array using the Array Viewer... …makes some changes

to the array...

…and displays the modified result.

Back to Main Menu

In Visual Fortran Professional and Enterprise Editions, the Array Viewer

can be used inside the debugger!

Back to Main Menu

Back to Main Menu

Then click the Array Viewer icon

Simple 2- Compaq Visual Fortran [break]

To view an array while debugging, highlight the

variable name

This array is supposed to store sin(x) over the range 1 to 40

Clearly, something is wrong!

Back to Main Menu

Using the Array Viewer, you can easily recognize

inconsistencies in large sets of data

Back to Main Menu

Back to Main Menu


Visual Fortran Professional and Enterprise Visual Fortran Professional and Enterprise Editions give you the full power of the Array Editions give you the full power of the Array VisualizerVisualizer Debug programs using the Array ViewerDebug programs using the Array Viewer Write Fortran or C programs to control the Array Write Fortran or C programs to control the Array

ViewerViewer Use the Avis2d ActiveX control to control the Array Use the Avis2d ActiveX control to control the Array

Viewer graphing modes and appearanceViewer graphing modes and appearance Use the Avis Grid ActiveX control to create tables Use the Avis Grid ActiveX control to create tables

of array dataof array data

Main MenuMain Menu

I would like to…I would like to… Learn more about Microsoft visual development Learn more about Microsoft visual development

environmentenvironment Learn more about mixed language programming Learn more about mixed language programming


FortranFortran Learn about Visual Fortran Professional EditionLearn about Visual Fortran Professional Edition Learn about the Compaq Array ViewerLearn about the Compaq Array Viewer End the presentationEnd the presentation

www.compaq.com

Compaq Visual FortranCompaq Visual FortranThank You for Viewing theThank You for Viewing the

Compaq Visual Fortran Version 6.5Compaq Visual Fortran Version 6.5

Product OverviewProduct Overview

Compaq, DIGITAL, and the Compaq logo are registered in the U.S. Patent and Trademark office.

OpenVMS and Tru64 UNIX are trademarks of Compaq Information Technologies, L.C.

ActiveX, Microsoft, MS, Microsoft Developer Studio, NT, PowerPoint, Visual Basic, Visual C++, Win32, Windows, and Windows NT are either registered trademarks or trademarks of Microsoft Corporation in the United States and other countries.

Intel and Pentium are registered trademarks of Intel Corporation.AMD and Athlon are trademarks of Advanced Micro Devices, Inc. IMSL and Visual Numerics are registered trademarks of Visual Numerics, Inc. UNIX and The Open Group are trademarks of The Open Group.All other trademarks and registered trademarks are the property of their

respective holders.

Visual FortranVisual Fortran

www.compaq.com


Compaq Visual Fortran OverviewCompaq Visual Fortran Overview

© 1997-2000 Compaq Computer Corporation.© 1997-2000 Compaq Computer Corporation.

For more information about Compaq Fortran For more information about Compaq Fortran please visit our web site at: please visit our web site at:

http://www.compaq.com/fortranhttp://www.compaq.com/fortran

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change without notice.

www.compaq.com

compaq visual fortran overview

Documents