XPLOT.ORG(1)

✨ XPLOT.ORG ✨

okay bestie, welcome to xplot.org, a fast tool to graph and visualize lots of data πŸ’– she's a manual page, section 1, General Commands Manual, and she's literally the moment.


🌸 SYNOPSIS 🌸

xplot.org [-v] [-x] [-y] [-tile] [-mono] [-1]
          [-d display | -display display] [-d2 display] file [files...]

πŸ¦‹ DESCRIPTION πŸ¦‹

so xplot.org is a fast visualization tool for examining multiple data sets in parallel plots 🫢 like, you get easy zoom-in and zoom-out, no cap, and it does synchronized views into multiple data sets β€” that's the -x, -y, and -tile options doing their thing ✨


πŸ’… OPTIONS πŸ’…

  • -1 β€” lets you look at multiple data sets one at a time. the way this one works is it changes the behavior of click-right and shift-click-right: instead of exiting and printing, they now cycle forward and backward through the various plots πŸ”₯
  • -d display, -display display,
  • -d2 display β€” all of these select which display(s) on which to draw the graphs πŸ–₯️
  • -mono β€” causes the graph(s) to be drawn in black and white, with no use of color. minimal. austere. iconic in its own way πŸ’€
  • -tile β€” lets you look at multiple data sets in parallel ✨ the plots will each consume 1/nth of the vertical space that would have been used with one plot. this works well if the window manager refrains from wasting pixels with decorative tabs and respects the hints that xplot.org provides πŸ™ˆ
  • -v β€” prints the version number πŸ‘‘
  • -x β€” causes several graphs to be synchronized on the X-axis. zooming in one window zooms all the others, with the same portion of the X-axis on display. the Y-axis of the other graphs will be autoscaled to fit the data 🌈
  • -y β€” causes several graphs to be synchronized on the Y-axis. zooming in one window zooms all the others, with the same portion of the Y-axis on display πŸ’œ

πŸ–±οΈ USE OF MOUSE BUTTONS πŸ–±οΈ

when you're running xplot.org, the mouse may be used to zoom in and out on data. mouse girl summer fr fr πŸŽ€

  • dragging with the left mouse button depressed while inside the axes of the graph β€” draws a rubber-band box around the area to be replotted in the existing window ⭐
  • dragging with the left mouse button depressed while outside the axes (below the X-axis or to the left of the Y-axis) β€” selects the range of the axis to plot. in effect, this is like the previous mechanism, but it only zooms on one axis πŸ’…
  • dragging with the middle mouse button inside the axes β€” pans the graph; the start-drag position ends up being at the end-drag position. dragging on the axes pans only in one dimension πŸ¦‹
  • clicking the left mouse button β€” zooms out to the previous view. you can zoom in multiple times, then back up through each view. panning locations are not saved 😭
  • clicking the right mouse button β€” exits the program. just like that. no warning. gone πŸ’€
  • shift-clicking on the mouse buttons β€” produces Postscript files with the same axis extents as the current view ✨
    • shift-left produces a full-page view πŸ“„
    • shift-middle produces a squarish plot ⬜
    • shift-right produces a plot such that three of them fit on a page of LaTeX 🧚

πŸ“Š PLOT LANGUAGE πŸ“Š

there are several example files β€” demo.0, demo.1, demo.2, etc. β€” stored with the xplot.org sources 🌸 and demo.0 lists all the commands, periodt.

xplot.org demo.0

that right there demonstrates xplot.org's capabilities πŸ‘‘ go off.


🌐 USE WITH TCPDUMP 🌐

the command

tcpdump -tt -S ... > tcpdump.out

saves a tcpdump formatted output trace to tcpdump.out. the -tt and -S flags tell tcpdump to print an unformatted timestamp and to use absolute TCP sequence numbers 🫢

this trace can then be examined by being processed with tcpdump2xplot.

tcpdump -plot tcpdump.out

πŸŽ€ SEE ALSO πŸŽ€

tcpdump2xplot(1) tcpdump(8)


πŸ“œ HISTORY πŸ“œ

the xplot.org command was written by Tim Shepard as a tool to use in his analysis of TCP performance while at MIT πŸ›οΈ some features were added by Andrew Heybey and Greg Troxel πŸ’–


πŸ’€ BUGS πŸ’€

  • some people may not like that the right mouse button exits without confirmation 😭 although others consider it a feature that enables rapidly viewing hundreds of similar plots. honestly? both valid. main character energy either way πŸ‘‘
  • should use standard X geometry specifications. noted. on the list. bestie we'll get there πŸ’…

and that's the whole page, bestie!! πŸŽ€ this was Debian's build of the xplot.org(1) manual page, dated 27 January 1999 β€” yeah she's vintage but she ate and left no crumbs πŸ’–βœ¨ go plot something gorgeous 🌈