NAG fl90, Release 3 FNW3203DLL - License Managed Windows 95/NT Lahey/Fujitsu Fortran 95 Users' Note Contents 1. Introduction 2. General Information 2.1. Accessing the Library 2.2. Example Programs 2.3. On-line User Documentation 3. Special Functions 4. Additional Services from NAG 5. Support from NAG 6. NAG Users Association 1. Introduction This document is essential reading for every user of the NAG fl90 implementation specified in the title. It provides implementation-specific detail that augments the information provided in the NAG fl90 on-line documentation (TextWare). NAG recommends that users read the following minimum reference material before calling any library procedure: (a) Essential Introduction (b) Chapter Introduction (c) Module Document (d) Implementation-specific Users' Note Items (a), (b) and (c) are included in the on-line documentation; item (d) is this document which is provided in plain text form. Item (a) is also supplied on the distribution medium, in both HTML and plain text forms. 2. General Information 2.1. Accessing the Library It will be assumed that the module information files are located in the c:\fnw3203dl\nag_mod_dir directory. The NAG fl90 library may be linked directly with a user program driver.for, say, in the following manner: lf95 -mod .;c:\fnw3203dl\nag_mod_dir driver.f90 -lib c:\fnw3203dl\naglibfl90 assuming that the library has been installed in the default directory. This will produce the executable file driver.exe. 2.2. Example Programs The example programs, data and the results obtained during the preparation of this specific implementation are supplied so you can try them yourself, or use one as a template for your own program. Note that the example material has been adapted, if necessary, from that in the on-line documentation, so that programs are suitable for execution with this implementation. The example programs are most easily accessed by using the batch file nagex.bat, which will provide you with a copy of an example program (and its data, if any), compile the program and link it with the library. Finally, the executable program will be run. The example program concerned is specified by the argument to nagex.bat. For example, create the directory c:\test, make c:\test the current directory, copy the file nagex.bat to it and then give the command: nagex nag_lib_support_ex01 This will copy the example program and its data into the directory c:\test and process them to produce the example program results in the file nag_lib_support_ex01.res 2.3. On-line User Documentation The following information is available in plain text files: Essential Introduction - essint.txt Tutorial - tutorial.txt Conversion from the NAG Fortran 77 Library - conversion.txt List of Contents - contents.txt Future Developments - future.txt Release 3 News - news.txt Users' Note - un.txt All of the above documents apart from the Users' Note are also available as HTML pages. 3. Special Functions The constants referred to in the on-line documentation have the following values in this implementation: nag_gamma error%code = 201 if X > 170.0 error%code = 202 if abs(X) < 2.23E-308 nag_log_gamma error%code = 201 if X > 2.55E+305 nag_erfc x(hi) = 26.6 x(low) = -6.25 nag_erf x(hi) = 6.25 nag_bessel_y0 error%code = 201 if X > 2.2E+15 nag_bessel_y1 error%code = 202 if X > 2.2E+15 error%code = 201 if 0.0 < X <= 2.23E-308 nag_bessel_y error%code = 201 if abs(Z) < 3.93E-305 error%code = 202 if abs(Z) or NU+N-1 > 1.07E+9 error%code = 203 if abs(Z) or NU+N-1 > 3.27E+4 nag_bessel_j0 error%code = 201 if abs(X) > 2.2E+15 nag_bessel_j1 error%code = 201 if abs(X) > 2.2E+15 nag_bessel_j error%code = 201 if imag(Z) > 700.0 error%code = 202 if abs(Z) or NU+N-1 > 1.07E+9 error%code = 203 if abs(Z) or NU+N-1 > 3.27E+4 nag_bessel_k1 error%code = 201 if 0.0 < X <= 2.23E-308 nag_bessel_k error%code = 201 if abs(Z) < 3.93E-305 error%code = 202 if abs(Z) or NU+N-1 > 1.07E+9 error%code = 203 if abs(Z) or NU+N-1 > 3.27E+4 nag_bessel_i0 error%code = 201 if abs(X) > 711.6 nag_bessel_i1 error%code = 201 if abs(X) > 711.6 nag_bessel_i error%code = 201 if real(Z) > 700.0 error%code = 202 if abs(Z) or NU+N-1 > 1.07E+9 error%code = 203 if abs(Z) or NU+N-1 > 3.27E+4 nag_ell_rd error%code = 201 if an argument < 1.579E-205 nag_ell_rj error%code = 201 if an argument < 2.820E-103 nag_airy_ai error%code = 203 if abs(Z) > 1.02E+3 error%code = 204 if abs(Z) > 1.04E+6 nag_airy_bi error%code = 203 if abs(Z) > 1.02E+3 error%code = 204 if abs(Z) > 1.04E+6 4. Additional Services from NAG (a) Documentation The Windows 95/NT version of NAG fl90 TextWare, a hypertext version of the full manual, is bundled with this implementation. Printed copies of the NAG fl90 Manual are available at prices published in the NAG documentation order form. 5. Support from NAG (a) Contact with NAG Queries concerning this document or the implementation generally should be directed initially to your local Advisory Service. If you have difficulty in making contact locally, you can write to NAG directly, at one of the supplied addresses. Users subscribing to the support service are encouraged to contact one of the NAG Response Centres (see below). (b) NAG Response Centres The NAG Response Centres are available for general enquiries from all users and also for technical queries from sites with an annually licensed product or support service. The Response Centres are open during office hours, but contact is possible by fax, email and phone (answering machine) at all times. When contacting a Response Centre please quote your NAG user reference and NAG product code. (c) Network Network, NAG's newsletter, is produced periodically and sent free of charge to sites with a supported product or service. (d) NAG Website The NAG Website is an information service providing items of interest to users and prospective users of NAG products and services. The information is regularly updated and reviewed and includes implementation availability, descriptions of products, downloadable software and technical reports. The NAG Website can be accessed at http://www.nag.co.uk/ or http://www.nag.com/ (in the USA) 6. NAG Users Association NAGUA, the NAG Users Association, is a self-financing, non-profitmaking body. It exists to promote communications between NAG and users of its products and services. It provides information to NAG on the requirements of users, who are in turn kept informed of developments in services. Membership is available to any institution or individual holding a licence for any NAG product or service. Members receive discounts on the registration fees at conferences and workshops. For an information pack and membership application form, please contact NAGUA at the supplied address. Appendix - supplied addresses NAG Ltd Wilkinson House Jordan Hill Road OXFORD OX2 8DR NAG Ltd Response Centre United Kingdom email: support@nag.co.uk Tel: +44 1865 511245 Tel: +44 1865 311744 Fax: +44 1865 310139 Fax: +44 1865 310139 NAG Inc 1400 Opus Place, Suite 200 Downers Grove IL 60515-5702 NAG Inc Response Center USA email: infodesk@nag.com Tel: +1 630 971 2337 Tel: +1 630 971 2345 Fax: +1 630 971 2706 Fax: +1 630 971 2346 Nihon NAG KK Nagashima Building 2F 2-24-3 Higashi Shibuya-ku Tokyo Japan email: help@nag-j.co.jp Tel: +81 3 5485 2901 Fax: +81 3 5485 2903 NAG Users Association PO Box 426 OXFORD OX2 8SD United Kingdom email: nagua@nag.co.uk Tel: +44 1865 311102 [NP3383/UN - License Managed]