/************************************************************************/ /** **/ /** UNIX Installation of DISLIN **/ /** **/ /** Contents: 1.) Introduction **/ /** 2.) Installation of Libraries and Utility Programs **/ /** 3.) Using DISLIN from Java **/ /** 4.) Using DISLIN from Perl **/ /** 5.) Using DISLIN from Python **/ /** 6.) Getting DISLIN Support **/ /** **/ /** Date : 15.03.2022 **/ /** Version: 11.5 / UNIX **/ /** Author : Helmut Michels **/ /** Dislin Software **/ /** Am Hachweg 10 **/ /** 37083 Göttingen, Germany **/ /** Email : michels@dislin.de **/ /************************************************************************/ 1.) Introduction DISLIN is a high level and easy to use graphics library for displaying data as curves, bar graphs, pie charts, 3D-colour plots, surfaces, contours and maps. The software is available for several C, Fortran 77 and Fortran 90 compilers. The UNIX versions of the graphics software DISLIN are distributed as compressed tar files with the file names 'dislin-n.m.xxx.tar.gz' where 'n.m' contains the DISLIN version number while the part 'xxx' identi- fies the operating system or compiler. The following UNIX versions of DISLIN are available: -------------------------------------------------------------------------- | File Computer/Oper.-System Compiler | -------------------------------------------------------------------------- | | | dislin-11.5.fbsd.tar.gz IBM-PC / FreeBSD 11.x, gcc, g++, g77, | | 12.x, 13.x gfortran, | | Perl, Python, | | Java, Ruby, Tcl| | | | dislin-11.5.fbsd.64.tar.gz IBM-PC / FreeBSD 11.x, gcc, g++, g77, | | 12.x, 13.x, 64-bit gfortran, | | Perl, Python, | | Java, Ruby, Tcl| | | | dislin-11.5.sol.x86.32.tar.gz Solaris 10, x86, 32-bit cc, CC, f77, | | f90, Perl, | | Python, Java | | | | dislin-11.5.sol.x86.64.tar.gz Solaris 10, x86, 64-bit cc, CC, f77, | | f90 | | | | dislin-11.3.sun.32.tar.gz SUN / SunOS 5.9, 32-bit cc, CC, f77, | | f90, Perl, | | Python, Java | | | | dislin-11.3.sun.64.tar.gz SUN / SunOS 5.9, 64-bit cc, CC, f77, | | f90 | -------------------------------------------------------------------------- 2.) Installation of Libraries and Utility Programs a) Uncompress the tar.gz file with the command gzip -d dislin-11.5.xxx.tar.gz b) Restore files from the tar file with the command tar xvf dislin-11.5.xxx.tar c) Change to the installation directory of DISLIN cd dislin-11.5 d) Choose a directory in the file structure where DISLIN should be installed and define the environment variable DISLIN with it: For example: DISLIN=/usr/local/dislin (for sh, ksh) export DISLIN or: setenv DISLIN /usr/local/dislin (for csh) e) Run the install program with the command INSTALL This program copies files to $DISLIN and sets protections. f) To make DISLIN available for general use, write the following com- mands to your .profile export DISLIN=dislin_directory PATH=${PATH}:${DISLIN}/bin LD_LIBRARY_PATH=$DISLIN:$LD_LIBRARY_PATH export LD_LIBRARY_PATH For a C-shell, you should include the commands setenv DISLIN dislin_directory setenv PATH ${PATH}:${DISLIN}/bin setenv LD_LIBRARY_PATH $DISLIN:$LD_LIBRARY_PATH into your .login file. g) Now you can compile, link and run the example programs in the direc- tory $DISLIN/examples ($DISLIN/examples/F for F) with the commands: clink -a exa_c (C) cpplink -a exa_cpp (C++) dlink -a exa_f77 (Fortran 77) f90link -a exa_f90 (Fortran 90) h) You can delete the installation directory 'dislin-11.4'. 3.) Using DISLIN from Java An interface for the programming language Java is also included in the most DISLIN distributions for UNIX. It allows to use DISLIN routines from Java applications. The interface and examples can be found in the directory $DISLIN/java To use DISLIN from Java, you have to define the environment variable CLASSPATH: for example: export CLASSPATH=$DISLIN/java:. The examples in $DISLIN/java can be compiled and executed with the commands javac example.java java example 4.) Using DISLIN from Perl A DISLIN module for the programming language Perl is included in the most DISLIN distributions for UNIX. The module and some examples can be found in the directory $DISLIN/perl. To use DISLIN from Perl, you have to define the environment variable PERL5LIB: export PERL5LIB=$DISLIN/perl Note: Source code of the Perl extension is included in the directory $DISLIN/perl for re-creating the module. 5.) Using DISLIN from Python An extension module for the programming language Python is also in- cluded in several DISLIN distributions for UNIX. The module and examples can be found in the directory $DISLIN/python. To use DISLIN from Python, you have to define the environment variable PYTHONPATH: export PYTHONPATH=$DISLIN/python Note: Source code of the Python extension is included in the directory $DISLIN/python for re-creating the module. 6.) Getting DISLIN Support The DISLIN distributions can be used freely without any restrictions. Access to the source code is available via a support contract from the site www.dislin.de.