pgplot命令大全.docx

pgplot命令大全.docx

《pgplot命令大全.docx》由会员分享，可在线阅读，更多相关《pgplot命令大全.docx（83页珍藏版）》请在冰豆网上搜索。

pgplot命令大全

PGPLOTSubroutineDescriptions

Introduction

ThisappendixincludesalistofallthePGPLOTsubroutines,andthengivesdetailedinstructionsfortheuseofeachroutineinFortranprograms.Thesubroutinedescriptionsareinalphabeticalorder.

Arguments

Thesubroutinedescriptionsindicatethedatatypeofeachargument.Whenargumentsaredescribedas``input'',theymaybereplacedwithconstantsorexpressionsintheCALLstatement,butmakesurethattheconstantorexpressionhasthecorrectdatatype.

INTEGERarguments:

theseshouldbedeclaredINTEGERorINTEGER*4inthecallingprogram,notINTEGER*2.

REALarguments:

theseshouldbedeclaredREALorREAL*4inthecallingprogram,notREAL*8orDOUBLEPRECISION.

LOGICALarguments:

theseshouldbedeclaredLOGICALorLOGICAL*4inthecallingprogram.

CHARACTERarguments:

anyvalidFortranCHARACTERvariablemaybeused（declaredCHARACTER*nforsomeintegern）.

IndexofRoutines

Version5.1

∙PGARRO--drawanarrow

∙PGASK--controlnewpageprompting

∙PGBAND--readcursorposition,withanchor

∙PGBBUF--beginbatchofoutput（buffer）

∙PGBEG--beginPGPLOT,openoutputdevice

∙PGBIN--histogramofbinneddata

∙PGBOX--drawlabeledframearoundviewport

∙PGCIRC--drawafilledoroutlinecircle

∙PGCLOS--closetheselectedgraphicsdevice

∙PGCONB--contourmapofa2Ddataarray,withblanking

∙PGCONL--labelcontourmapofa2Ddataarray

∙PGCONS--contourmapofa2Ddataarray（fastalgorithm）

∙PGCONT--contourmapofa2Ddataarray（contour-following）

∙PGCONX--contourmapofa2Ddataarray（nonrectangular）

∙PGCTAB--installthecolortabletobeusedbyPGIMAG

∙PGCURS--readcursorposition

∙PGDRAW--drawalinefromthecurrentpenpositiontoapoint

∙PGEBUF--endbatchofoutput（buffer）

∙PGEND--terminatePGPLOT

∙PGENV--setwindowandviewportanddrawlabeledframe

∙PGERAS--eraseallgraphicsfromcurrentpage

∙PGERRB--horizontalorverticalerrorbar

∙PGERRX--horizontalerrorbar

∙PGERRY--verticalerrorbar

∙PGETXT--erasetextfromgraphicsdisplay

∙PGFUNT--functiondefinedbyX=F（T）,Y=G（T）

∙PGFUNX--functiondefinedbyY=F（X）

∙PGFUNY--functiondefinedbyX=F（Y）

∙PGGRAY--gray-scalemapofa2Ddataarray

∙PGHI2D--cross-sectionsthrougha2Ddataarray

∙PGHIST--histogramofunbinneddata

∙PGIDEN--writeusername,date,andtimeatbottomofplot

∙PGIMAG--colorimagefroma2Ddataarray

∙PGLAB--writelabelsforx-axis,y-axis,andtopofplot

∙PGLCUR--drawalineusingthecursor

∙PGLDEV--listavailabledevicetypes

∙PGLEN--findlengthofastringinavarietyofunits

∙PGLINE--drawapolyline（curvedefinedbyline-segments）

∙PGMOVE--movepen（changecurrentpenposition）

∙PGMTXT--writetextatpositionrelativetoviewport

∙PGNCUR--markasetofpointsusingthecursor

∙PGNUMB--convertanumberintoaplottablecharacterstring

∙PGOLIN--markasetofpointsusingthecursor

∙PGOPEN--openagraphicsdevice

∙PGPAGE--advancetonewpage

∙PGPANL--switchtoadifferentpanelontheviewsurface

∙PGPAP--changethesizeoftheviewsurface

∙PGPIXL--drawpixels

∙PGPNTS--drawoneormoregraphmarkers,notallthesame

∙PGPOLY--fillapolygonalareawithshading

∙PGPT--drawoneormoregraphmarkers

∙PGPTXT--writetextatarbitrarypositionandangle

∙PGQAH--inquirearrow-headstyle

∙PGQCF--inquirecharacterfont

∙PGQCH--inquirecharacterheight

∙PGQCI--inquirecolorindex

∙PGQCIR--inquirecolorindexrange

∙PGQCOL--inquirecolorcapability

∙PGQCR--inquirecolorrepresentation

∙PGQCS--inquirecharacterheightinavarietyofunits

∙PGQFS--inquirefill-areastyle

∙PGQHS--inquirehatchingstyle

∙PGQID--inquirecurrentdeviceidentifier

∙PGQINF--inquirePGPLOTgeneralinformation

∙PGQITF--inquireimagetransferfunction

∙PGQLS--inquirelinestyle

∙PGQLW--inquirelinewidth

∙PGQPOS--inquirecurrentpenposition

∙PGQTBG--inquiretextbackgroundcolorindex

∙PGQTXT--findboundingboxoftextstring

∙PGQVP--inquireviewportsizeandposition

∙PGQVSZ--findthewindowdefinedbythefullviewsurface

∙PGQWIN--inquirewindowboundarycoordinates

∙PGRECT--drawarectangle,usingfill-areaattributes

∙PGRND--findthesmallest`round'numbergreaterthanx

∙PGRNGE--chooseaxislimits

∙PGSAH--setarrow-headstyle

∙PGSAVE--savePGPLOTattributes

∙PGUNSA--restorePGPLOTattributes

∙PGSCF--setcharacterfont

∙PGSCH--setcharacterheight

∙PGSCI--setcolorindex

∙PGSCIR--setcolorindexrange

∙PGSCR--setcolorrepresentation

∙PGSCRN--setcolorrepresentationbyname

∙PGSFS--setfill-areastyle

∙PGSHLS--setcolorrepresentationusingHLSsystem

∙PGSHS--sethatchingstyle

∙PGSITF--setimagetransferfunction

∙PGSLCT--selectanopengraphicsdevice

∙PGSLS--setlinestyle

∙PGSLW--setlinewidth

∙PGSTBG--settextbackgroundcolorindex

∙PGSUBP--subdivideviewsurfaceintopanels

∙PGSVP--setviewport（normalizeddevicecoordinates）

∙PGSWIN--setwindow

∙PGTBOX--drawframeandwrite（DD）HHMMSS.Slabelling

∙PGTEXT--writetext（horizontal,left-justified）

∙PGUPDT--updatedisplay

∙PGVECT--vectormapofa2Ddataarray,withblanking

∙PGVSIZ--setviewport（inches）

∙PGVSTD--setstandard（default）viewport

∙PGWEDG--annotateanimageplotwithawedge

∙PGWNAD--setwindowandadjustviewporttosameaspectratio

∙PGADVANCE--non-standardaliasforPGPAGE

∙PGBEGIN--non-standardaliasforPGBEG

∙PGCURSE--non-standardaliasforPGCURS

∙PGLABEL--non-standardaliasforPGLAB

∙PGMTEXT--non-standardaliasforPGMTXT

∙PGNCURSE--non-standardaliasforPGNCUR

∙PGPAPER--non-standardaliasforPGPAP

∙PGPOINT--non-standardaliasforPGPT

∙PGPTEXT--non-standardaliasforPGPTXT

∙PGVPORT--non-standardaliasforPGSVP

∙PGVSIZE--non-standardaliasforPGVSIZ

∙PGVSTAND--non-standardaliasforPGVSTD

∙PGWINDOW--non-standardaliasforPGSWIN

PGARRO--drawanarrow

SUBROUTINEPGARRO（X1,Y1,X2,Y2）

REALX1,Y1,X2,Y2

Drawanarrowfromthepointwithworld-coordinates（X1,Y1）to

（X2,Y2）.Thesizeofthearrowheadat（X2,Y2）isdeterminedby

thecurrentcharactersizesetbyroutinePGSCH.Thedefaultsize

is1/40thofthesmallerofthewidthorheightoftheviewsurface.

Theappearanceofthearrowhead（shapeandsolidoropen）is

controlledbyroutinePGSAH.

Arguments:

X1,Y1（input）:

worldcoordinatesofthetailofthearrow.

X2,Y2（input）:

worldcoordinatesoftheheadofthearrow.

PGASK--controlnewpageprompting

SUBROUTINEPGASK（FLAG）

LOGICALFLAG

Changethe``promptstate''ofPGPLOT.Ifthepromptstateis

ON,PGPAGEwilltype``TypeRETURNfornextpage:

''andwillwait

fortheusertotypeacarriage-returnbeforestartinganewpage.

Theinitialpromptstate（afteracalltoPGBEG）isONfor

interactivedevices.PromptstateisalwaysOFFfornon-interactive

devices.

Arguments:

FLAG（input）:

if.TRUE.,andifthedeviceisaninteractive

device,thepromptstatewillbesettoON.If

.FALSE.,thepromptstatewillbesettoOFF.

PGBAND--readcursorposition,withanchor

INTEGERFUNCTIONPGBAND（MODE,POSN,XREF,YREF,X,Y,CH）

INTEGERMODE,POSN

REALXREF,YREF,X,Y

CHARACTER*（*）CH

Readthecursorpositionandacharactertypedbytheuser.

Thepositionisreturnedinworldcoordinates.PGBANDpositions

thecursoratthepositionspecified（ifPOSN=1）,allowstheuserto

movethecursorusingthemouseorarrowkeysorwhateverisavailable

onthedevice.Whenhehaspositionedthecursor,theusertypesa

singlecharacteronthekeyboard;PGBANDthenreturnsthis

characterandthenewcursorposition（inworldcoordinates）.

Someinteractivedevicesofferaselectionofcursortypes,

implementedasthinlinesthatmovewiththecursor,butwithout

erasingunderlyinggraphics.Ofthesetypes,someextendbetween

astationaryanchor-pointatXREF,YREF,andthepositionofthe

cursor,whileotherssimplyfollowthecursorwithoutchangingshape

orsize.ThecursortypeisspecifiedwithoneofthefollowingMODE

values.Cursortypesthatarenotsupportedbyagivendevice,are

treatedasMODE=0.

--IfMODE=0,theanchorpointisignoredandtheroutinebehaves

likePGCURS.

--IfMODE=1,astraightlineisdrawnjoiningtheanchorpoint

andthecursorposition.

--IfMODE=2,ahollowrectangleisextendedasthecursorismoved,

withonevertexattheanchorpointandtheoppositevertexatthe

currentcursorposition;theedgesoftherectanglearehorizontal

andvertical.

--IfMODE=3,twohorizontallinesareextendedacrossthewidthof

thedisplay,onedrawnthroughtheanchorpointandtheother

throughthemovingcursorposition.Thiscouldbeusedtoselect

aY-axisrangewhenoneendoftherangeisknown.

--IfMODE=4,twoverticallinesareextendedovertheheightof

thedisplay,onedrawnthroughtheanchorpointandtheother

throughthemovingcursorposition.Thiscouldbeusedtoselectan

X-axisrangewhenoneendoftherangeisknown.

--IfMODE=5,ahorizontallineisextendedthroughthecursor

positionoverthewidthofthedisplay.Thiscouldbeusedtoselect

anX-axisvaluesuchasthestartofanX-axisrange.Theanchorpoint

isignored.

--IfMODE=6,averticallineisextendedthroughthecursor

positionovertheheightofthedisplay.Thiscouldbeusedtoselect

aY-axisvaluesuchasthestartofaY-axisrange.Theanchorpoint

isignored.

--IfMODE=7,a