{
    "command": "sggraphps",
    "description": "Create a PostScript figure from selected scalar or sampled fields, arranged in\npanels by the program's graph and grouping options. Supply valid fields and\nchoose axis, scale, and page settings appropriate to their units.\nAxis formats starting with time: interpret coordinates as Unix epoch seconds\nin UTC and use calendar-aligned automatic ticks. Store epoch fields as double\nor long to preserve second-level precision.",
    "examples": [
        {
            "command": "sggraphps x=epoch y=value bottom.label=\"UTC\" \\\n  bottom.fmt=\"time:%m-%d %H:%M:%S\" bottom.tic=auto5 \\\n  out.width=9 out.edge.left=90 out.edge.right=90 <series.sg >series.ps",
            "expected": "The input must contain numeric epoch and value fields or matching vectors.\nFor scalar observations, add value.style=o to display individual points.\nStore epoch seconds as double or long. Calendar ticks are aligned in UTC;\nauto5 is a density hint rather than an exact count. No origin is required.",
            "title": "Plot epoch-second coordinates with UTC date and time ticks"
        },
        {
            "command": "sggraphps x=value y=epoch left.label=\"UTC date\" \\\n  left.fmt=\"time:%d-%b\" left.tic=auto5 <series.sg >dates.ps",
            "expected": "The epoch field supplies Unix seconds. Choose a date-only pattern for ranges\nspanning days or longer; a shorter range may repeat the same date label.",
            "title": "Show calendar dates on the vertical axis"
        }
    ],
    "input_description": "input dataset; each group produces a page in the PostScript output",
    "notes": [],
    "output_description": "output PostScript figure",
    "package": "sigclear-plot",
    "parameters": [
        {
            "choices": [],
            "default": "stdin",
            "default_known": false,
            "description": "input dataset; each group produces a page in the PostScript output",
            "name": "in",
            "required": false,
            "type": "ifile",
            "units": null
        },
        {
            "choices": [],
            "default": "NULL",
            "default_known": false,
            "description": "optional scalar field giving the valid sample count for each vector",
            "name": "in.ns",
            "required": false,
            "type": "field",
            "units": null
        },
        {
            "choices": [],
            "default": 1,
            "default_known": true,
            "description": "input subsampling interval:\n0: automatically reduce each graph to approximately 3000 points\n1: use every input point\nn: use one point for every n input points",
            "name": "in.subsamp",
            "required": false,
            "type": "int",
            "units": null
        },
        {
            "choices": [
                "subgroup",
                "column",
                "vector"
            ],
            "default": "subgroup",
            "default_known": true,
            "description": "panel layout:\nsubgroup: one panel per subgroup, arranged in rows; all selected fields and columns share the panel\ncolumn: one panel per column, with subgroups in rows and columns across each row\nvector: one row per selected field and one column per subgroup",
            "name": "layout",
            "required": false,
            "type": "enum",
            "units": null
        },
        {
            "choices": [],
            "default": "@{index}",
            "default_known": true,
            "description": "legend-label template for vector layout",
            "name": "vector.leglabel",
            "required": false,
            "type": "str",
            "units": null
        },
        {
            "choices": [],
            "default": "XMIN",
            "default_known": false,
            "description": "minimum x-axis value",
            "name": "xmin",
            "required": false,
            "type": "double",
            "units": null
        },
        {
            "choices": [],
            "default": "XMAX",
            "default_known": false,
            "description": "maximum x-axis value",
            "name": "xmax",
            "required": false,
            "type": "double",
            "units": null
        },
        {
            "choices": [],
            "default": "YMIN",
            "default_known": false,
            "description": "minimum y-axis value",
            "name": "ymin",
            "required": false,
            "type": "double",
            "units": null
        },
        {
            "choices": [],
            "default": "YMAX",
            "default_known": false,
            "description": "maximum y-axis value",
            "name": "ymax",
            "required": false,
            "type": "double",
            "units": null
        },
        {
            "choices": [],
            "default": "stdout",
            "default_known": false,
            "description": "output PostScript figure",
            "name": "out",
            "required": false,
            "type": "figure",
            "units": null
        },
        {
            "choices": [],
            "default": false,
            "default_known": true,
            "description": "write Encapsulated PostScript",
            "name": "eps",
            "required": false,
            "type": "bool",
            "units": null
        },
        {
            "choices": [],
            "default": "TIME",
            "default_known": false,
            "description": "optional field or vector supplying x values; defaults to sample coordinates",
            "name": "x",
            "required": false,
            "type": "field",
            "units": null
        },
        {
            "choices": [],
            "default": "VECTOR(\"data\")",
            "default_known": false,
            "description": "fields or vectors to draw on the y axis; defaults to data",
            "name": "y",
            "required": null,
            "type": "fields",
            "units": null
        },
        {
            "choices": [],
            "default": "000000",
            "default_known": true,
            "description": "line color as an index or hexadecimal RGB string, such as FF0000",
            "name": "#data.color",
            "required": false,
            "type": "str",
            "units": null
        },
        {
            "choices": [],
            "default": "",
            "default_known": true,
            "description": "line and marker style:\nempty string: solid line without markers\none marker character, such as o: markers without a connecting line\ntwo or four digits, such as 52: dash lengths alternating between drawn and blank segments\nappend a marker to those digits, such as 52o: dashed line with markers\nMarkers: . (dot), * (star), + (plus), x (cross), o (circle), < > ^ v V (triangles), s S (squares), d D (diamonds).",
            "name": "#data.style",
            "required": false,
            "type": "str",
            "units": null
        },
        {
            "choices": [],
            "default": 1,
            "default_known": true,
            "description": "line width in points",
            "name": "#data.linewidth",
            "required": false,
            "type": "float",
            "units": null
        },
        {
            "choices": [],
            "default": "vectname",
            "default_known": false,
            "description": "legend label",
            "name": "#data.label",
            "required": false,
            "type": "str",
            "units": null
        },
        {
            "choices": [],
            "default": "par.ymin",
            "default_known": false,
            "description": "lower y-axis limit for this field in vector layout",
            "name": "#data.min",
            "required": false,
            "type": "double",
            "units": null
        },
        {
            "choices": [],
            "default": "par.ymax",
            "default_known": false,
            "description": "upper y-axis limit for this field in vector layout",
            "name": "#data.max",
            "required": false,
            "type": "double",
            "units": null
        },
        {
            "choices": [
                "none",
                "topleft",
                "topright",
                "bottomleft",
                "bottomright"
            ],
            "default": "none",
            "default_known": true,
            "description": "legend position",
            "name": "legend",
            "required": false,
            "type": "enum",
            "units": null
        },
        {
            "choices": [],
            "default": true,
            "default_known": true,
            "description": "draw a box around the legend",
            "name": "legend.box",
            "required": false,
            "type": "bool",
            "units": null
        },
        {
            "choices": [],
            "default": 20,
            "default_known": true,
            "description": "length of legend (points)",
            "name": "legend.len",
            "required": false,
            "type": "float",
            "units": null
        },
        {
            "choices": [],
            "default": 3,
            "default_known": true,
            "description": "legend X offset (points)",
            "name": "legend.offx",
            "required": false,
            "type": "float",
            "units": null
        },
        {
            "choices": [],
            "default": 3,
            "default_known": true,
            "description": "legend Y offset (points)",
            "name": "legend.offy",
            "required": false,
            "type": "float",
            "units": null
        },
        {
            "choices": [],
            "default": 3,
            "default_known": true,
            "description": "spacing between legend entries in points",
            "name": "legend.space",
            "required": false,
            "type": "float",
            "units": null
        },
        {
            "choices": [
                "Helvetica",
                "Courier",
                "Serif",
                "Roman"
            ],
            "default": "Helvetica",
            "default_known": true,
            "description": "legend font",
            "name": "legend.font",
            "required": false,
            "type": "enum",
            "units": null
        },
        {
            "choices": [
                "normal",
                "bold",
                "italic",
                "bditalic"
            ],
            "default": "normal",
            "default_known": true,
            "description": "font style",
            "name": "legend.style",
            "required": false,
            "type": "enum",
            "units": null
        },
        {
            "choices": [],
            "default": 8,
            "default_known": true,
            "description": "font size in points",
            "name": "legend.size",
            "required": false,
            "type": "float",
            "units": null
        },
        {
            "choices": [],
            "default": false,
            "default_known": true,
            "description": "exchange the x- and y-axis positions",
            "name": "reverse",
            "required": false,
            "type": "bool",
            "units": null
        },
        {
            "choices": [],
            "default": false,
            "default_known": true,
            "description": "reverse the x axis",
            "name": "xreverse",
            "required": false,
            "type": "bool",
            "units": null
        },
        {
            "choices": [],
            "default": false,
            "default_known": true,
            "description": "reverse the y axis",
            "name": "yreverse",
            "required": false,
            "type": "bool",
            "units": null
        },
        {
            "choices": [],
            "default": null,
            "default_known": false,
            "description": "left axis",
            "name": "left",
            "required": null,
            "type": "axis",
            "units": null
        },
        {
            "choices": [],
            "default": null,
            "default_known": false,
            "description": "right axis",
            "name": "right",
            "required": null,
            "type": "axis",
            "units": null
        },
        {
            "choices": [],
            "default": null,
            "default_known": false,
            "description": "top axis for first plot",
            "name": "top",
            "required": null,
            "type": "axis",
            "units": null
        },
        {
            "choices": [],
            "default": null,
            "default_known": false,
            "description": "bottom axis for last plot",
            "name": "bottom",
            "required": null,
            "type": "axis",
            "units": null
        }
    ],
    "related": [],
    "schema_version": 1,
    "summary": "Draw selected dataset fields or vectors as multi-panel PostScript graphs",
    "synopsis": "sggraphps <stdin in.ns=NULL in.subsamp=1 layout=subgroup vector.leglabel=\"@{index}\" xmin=XMIN xmax=XMAX ymin=YMIN ymax=YMAX out=stdout eps=false x=TIME y=VECTOR(\"data\") #data.color=\"000000\" #data.style=\"\" #data.linewidth=1 #data.label=vectname #data.min=par.ymin #data.max=par.ymax legend=none legend.box=true legend.len=20 legend.offx=3 legend.offy=3 legend.space=3 legend.font=Helvetica legend.style=normal legend.size=8 reverse=false xreverse=false yreverse=false left= right= top= bottom=",
    "version": "1.0.3"
}