~ubuntu-branches/ubuntu/vivid/ploticus/vivid : revision 8

12

H4 { font-size: small; font-family: arial,helvetica,sans-serif; }

13

-->

14

</STYLE>

15

<title>ploticus: pl(1)</title>

15

<title>ploticus: ploticus(1)</title>

16

17

<br>

18

<br>

20

21

<td>

22

23

23

<td><br><h2>ploticus(1)</h2></td>

24

25

<small>

26

32

<br>

33

.>>

34

35

.TH pl(1) PL "11-MAR-2009 PL ploticus.sourceforge.net"

35

.TH ploticus 1 "11-MAR-2009 PLOTICUS ploticus.sourceforge.net"

36

37

.SH Name

38

pl

38

ploticus \- data display package

39

40

.SH Synopsis

41

\fCpl -prefab \fIprefabname\fC \fIparm=value\fC .. [\fI-options\fR]

41

\fCploticus \-prefab \fIprefabname\fC \fIparm=value\fC .. [\fI-options\fR]

42

.br

43

\0.. OR ..

44

.br

45

\fCpl \fIscriptfile\fC [\fI-options\fC]

45

\fCploticus \fIscriptfile\fC [\fI-options\fC]

46

47

.ig >>

48

83

84

.>>

85

.SH Description

86

\fBpl\fR is the primary component of the

86

\fBploticus\fR is the primary component of the

87

.ig >>

88

89

.>>

92

</a>

93

.>>

94

.LP

95

\fBpl\fR is a program that produces plots and charts from data, and

95

\fBploticus\fR is a program that produces plots and charts from data, and

96

produces results that can be viewed on web pages, paper, slides,

97

or interactively on the screen. Standard types of plots may be

98

done using

112

</a>

113

.>>

114

may be supplied for greater flexibility and customization.

115

\fBpl\fR may be executed from the command line or

115

\fBploticus\fR may be executed from the command line or

116

.ig >>

117

118

.>>

436

.ig >>

437

438

.>>

439

\0overlay or combine results from separate pl runs.

439

\0overlay or combine results from separate ploticus runs.

440

.ig >>

441

</a>

442

.>>

443

The drawdump file can be rendered later in any desired format, using this command:

444

\fCpl -prefab draw dumpfile=\fIfilename\fR

444

\fCploticus \-prefab draw dumpfile=\fIfilename\fR

445

.ig >>

446

447

.>>

584

</a>

585

.>>

586

0,0 is the lower left corner.

587

If -pagesize is not specified, the default size will be 8" x 8".

588

Size is set before any drawing takes place and is unaffected by the -scale option.

587

If \-pagesize is not specified, the default size will be 8" x 8".

588

Size is set before any drawing takes place and is unaffected by the \-scale option.

589

.IP

590

When rendering PNG/GIF/JPEG images, this option determines amount of internal memory allocation for accommodating the image.

591

The result can never be bigger than this size, and any drawing outsize the bounds will not be visible.

592

\fBTo create PNG/GIF/JPEG images larger than 8" x 8", this option MUST be specified to set a bigger size.\fR

593

Cropping options (below) can be used along with -pagesize as long as they result in a smaller rectangle

593

Cropping options (below) can be used along with \-pagesize as long as they result in a smaller rectangle

594

than the pagesize; they take effect after all drawing has been completed.

595

.IP

596

\fB-pagesize\fR has no effect with EPS or paginated PostScript results (the PostScript

597

BoundingBox will be determined by the extent of the graphic).

598

.IP

599

Example: \fC-pagesize 7,3\fR

599

Example: \fC\-pagesize 7,3\fR

600

601

.ig >>

602

663

Cropping takes place after design is rendered and does not

664

affect coordinate locations.

665

.br

666

Example: \fC-croprel 0,-0.1,0,0.1\fR

666

Example: \fC-croprel 0,\-0.1,0,0.1\fR

667

668

.ig >>

669

678

.IP \0

679

If specified, result PNG/GIF/JPG image will be created at exactly this width and height in pixels.

680

Does not interact with scaling or cropping... user is responsible for ensuring that content fits appropriately into the specified size.

681

User is also responsible for setting -pagesize appropriately for larger images.

681

User is also responsible for setting \-pagesize appropriately for larger images.

682

New in 2.40

683

684

.ig >>

789

.IP \0

790

Use centimeters as your absolute units, instead of inches.

791

On the command line this must appear to the left of any arguments dealing with

792

absolute unit values, such as -pagesize.

792

absolute unit values, such as \-pagesize.

793

Centimeter absolute units can also be set via

794

.ig >>

795

1057

included in the \fIcommand\fR. For example, if a GIF file is being

1058

generated you might use this to invoke the xv utility: \fC-viewer xv\fR.

1059

If PostScript is being generated you could use something like this to

1060

invoke the ghostview utility: \fC-viewer "gv -magstep -1"\fR.

1060

invoke the ghostview utility: \fC-viewer "gv \-magstep \-1"\fR.

1061

The given command must be available on your system and locatable in

1062

your command search path.

1063

This option may not be used with \fC-o stdout\fR.

1289

</a>

1290

.>>

1291

.IP \0

1292

\fCpl -prefab scat -png datafile=results.dat x=2 y=3\fR

1292

\fCploticus \-prefab scat \-png datafile=results.dat x=2 y=3\fR

1293

1294

.LP

1295

The following examples assume

1296

that you have a script file called \fClineplot1.p\fR.

1297

.IP \0

1298

\fCpl -x lineplot1.p\fR = view on X11 screen

1299

.IP

1300

\fCpl -png lineplot1.p\fR = create PNG image lineplot1.png

1301

.IP

1302

\fCpl -gif lineplot1.p -o stdout\fR = create GIF image on standard output

1303

.IP

1304

\fCpl -gif lineplot1.p -viewer xv\fR = produce GIF and view using xv

1298

\fCploticus \-x lineplot1.p\fR = view on X11 screen

1299

.IP

1300

\fCploticus \-png lineplot1.p\fR = create PNG image lineplot1.png

1301

.IP

1302

\fCploticus \-gif lineplot1.p \-o stdout\fR = create GIF image on standard output

1303

.IP

1304

\fCploticus \-gif lineplot1.p \-viewer xv\fR = produce GIF and view using xv

1305

(assuming xv image viewer is available on your system).

1306

.IP

1307

\fCpl -eps lineplot1.p\fR = produce EPS file lineplot1.eps

1307

\fCploticus \-eps lineplot1.p\fR = produce EPS file lineplot1.eps

1308

.IP

1309

\fCpl -eps lineplot1.p -viewer gv\fR = produce EPS and view using gv

1309

\fCploticus \-eps lineplot1.p \-viewer gv\fR = produce EPS and view using gv

1310

(that's ghostview, assuming it is available on your system).

1311

.IP

1312

\fCpl -eps lineplot1.p -o lineplot.eps\fR = produce EPS into file lineplot.eps

1312

\fCploticus \-eps lineplot1.p \-o lineplot.eps\fR = produce EPS into file lineplot.eps

1313

.IP

1314

\fCpl -ps lineplot1.p | lp\fR = produce paginated postscript and send to

1314

\fCploticus \-ps lineplot1.p | lp\fR = produce paginated postscript and send to

1315

unix lp print spooler.

1316

.IP

1317

\fCpl -ps lineplot1.p -veiwer gv\fR = produce paginated postscript

1317

\fCploticus \-ps lineplot1.p \-veiwer gv\fR = produce paginated postscript

1318

and view using ghostview.

1319

1320

.ig >>

1362

\fBLC_CTYPE\fR, \fBLC_COLLATE\fR, \fBLANG\fR

1363

.IP \0

1364

Locale support. Thanks to Oleg Bartunov oleg@sai.msu.su

1365

for contributing this. \fBpl\fR must be

1366

built with -DLOCALE for this to work.

1365

for contributing this. \fBploticus\fR must be

1366

built with \-DLOCALE for this to work.

1367

1368

1369

.ig >>