D I S L I N 9 jancely/NM/Texty/Grafika/...آ  2006-11-18آ  Preface to Version 9.1 This manual describes

  • View
    5

  • Download
    0

Embed Size (px)

Text of D I S L I N 9 jancely/NM/Texty/Grafika/...آ  2006-11-18آ  Preface to Version 9.1 This manual...

  • D I S L I N 9.1

    A Data Plotting

    Library

    by

    Helmut Michels

  • c© Helmut Michels, Max-Planck-Institut fuer Sonnensystemforschung, Katlenburg-Lindau 1986 - 2006 All rights reserved.

  • Contents

    1 Introduction 1

    2 Basic Concepts and Conventions 3 2.1 Page Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.2 File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.3 Level Structure of DISLIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.4 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.5 Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.6 Programming in C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.7 Programming in Fortran 90 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.8 Linking Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 2.9 Utility Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 2.10 WWW Homepage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2.11 Reporting Bugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2.12 License Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

    3 Introductory Routines 11 3.1 Initialization and Termination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 3.2 Plotting of Text and Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 3.3 Plotting Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3.4 Plotting a Page Border, Background and Header . . . . . . . . . . . . . . . . . . . . . . 13 3.5 Sending a Metafile to a Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 3.6 Including Meta- and Bitmap files into a Graphics . . . . . . . . . . . . . . . . . . . . . 14

    4 Plotting Axis Systems and Titles 15 4.1 Plotting Axis Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 4.2 Termination of Axis Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 4.3 Plotting Titles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 4.4 Plotting Grid Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 4.5 Plotting Additional Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 4.6 Secondary Axes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

    5 Plotting Curves 21 5.1 Plotting Curves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 5.2 Plotting Legends . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 5.3 Plotting Shaded Areas between Curves . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 5.4 Plotting Error Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 5.5 Plotting Vector Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

    6 Parameter Setting Routines 27 6.1 Basic Routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

    6.1.1 Resetting Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 6.1.2 Changing the Plot Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 6.1.3 Modifying the Origin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 6.1.4 File Format Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

    i

  • 6.1.5 Page Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 6.1.6 Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 6.1.7 Viewport Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

    6.2 Axis Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 6.2.1 Modifying the Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 6.2.2 Modifying the Position and Size . . . . . . . . . . . . . . . . . . . . . . . . . . 39 6.2.3 Axis Scaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 6.2.4 Modifying Ticks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 6.2.5 Modifying Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 6.2.6 Modifying Axis Titles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 6.2.7 Suppressing Axis Parts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 6.2.8 Modifying Clipping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 6.2.9 Framing Axis Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 6.2.10 Setting Colours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 6.2.11 Axis System Titles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

    6.3 Colours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 6.3.1 Changing the Foreground Colour . . . . . . . . . . . . . . . . . . . . . . . . . 52 6.3.2 Modifying Colour Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 6.3.3 Utitily Routines for Colours . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

    6.4 Text and Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 6.5 Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 6.6 Indices and Exponents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 6.7 Instruction Alphabet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 6.8 TeX Instructions for Mathematical Formulas . . . . . . . . . . . . . . . . . . . . . . . . 76

    6.8.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 6.8.2 Enabling TeX Mode and TeX Options . . . . . . . . . . . . . . . . . . . . . . . 76 6.8.3 Exponents and Indices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 6.8.4 Fractions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 6.8.5 Roots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 6.8.6 Sums and Integrals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 6.8.7 Greek Letters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 6.8.8 Mathematical Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 6.8.9 Alternate Alphabets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 6.8.10 Function Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 6.8.11 Accents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 6.8.12 Lines above and below Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . 79 6.8.13 Horizontal Spacing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 6.8.14 Selecting Character Size in TeX Mode . . . . . . . . . . . . . . . . . . . . . . . 80 6.8.15 Colours in TeX Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 6.8.16 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

    6.9 Curve Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 6.10 Line Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 6.11 Shading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 6.12 Attribute Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 6.13 Base Transformations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 6.14 Shielded Regions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

    7 Parameter Requesting Routines 95

    8 Elementary Plot Routines 103 8.1 Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 8.2 Vectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 8.3 Filled Triangles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 8.4 Wind Speed Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 8.5 Geometric Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

    ii

  • 9 Utility Routines 109 9.1 Transforming Coordinates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 9.2 String Arithmetic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 9.3 Number Arithmetic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 9.4 Date Routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 9.5 Bit Manipulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 9.6 Byte Swapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 9.7 Binary I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 9.8 Window Terminals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

    9.8.1 Clearing the Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 9.8.2 Clearing the Output Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . .