Generate graph paper
generate_graph_paperRead-onlyIdempotent
Use this when the user wants printable graph paper or grid paper as a PDF: square grid (1/4 inch, 5 mm, 1 mm, 4x4 or 5x5 per inch), dot grid, isometric or isometric dot, hexagon, polar, semi-log or log-log with chosen cycles, engineering paper, or a coordinate plane with numbered x and y axes. Lines are placed at true physical spacing and the grid is centred, with a calibration ruler. Up to 100 pages, Letter, Legal, Tabloid, A5, A4 or A3. Does not plot data, draw graphs of functions, or make tracing worksheets.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| axes | No | Square or dot grid only: draw numbered x and y axes through the centre (a coordinate plane), e.g. true. Default false. | |
| pages | No | Number of identical pages in the PDF, 1 to 100, e.g. 5 or "ten". Default 1. | |
| title | No | Optional heading printed at the top, e.g. "Physics lab 3". Longer titles are shortened to 80 characters. Latin, Greek and Cyrillic letters print. | |
| cycles | No | Semi-log and log-log: number of log cycles (decades) on the vertical axis, 1 to 6, e.g. 3. Default 3. | |
| margin | No | Page margin, e.g. "10 mm" or "0.5 in". Default 1/2 in on US pages, 10 mm on A pages; at least 0.2 in. | |
| spacing | No | Grid or line spacing with a unit, e.g. "5 mm", "1/4 inch", "0.5 cm", "5 squares per inch" or "4x4". For hex: across the flats; isometric: triangle side; polar: ring spacing; music: gap between staff lines; lined/cornell: line spacing; calligraphy: x-height. Default depends on the type (1/4 in on US pages, 5 mm on A pages). | |
| x_cycles | No | Log-log only: log cycles on the horizontal axis, 1 to 6, e.g. 2. Default 2. | |
| name_date | No | Print Name and Date lines at the top, e.g. true. Default false (Cornell notes: true). | |
| page_size | No | Paper size: Letter, Half Letter (5.5x8.5), Legal, Tabloid (11x17), A5, A4, A3 or B5, e.g. "A4". Default Letter (A4 for millimetre paper). "8.5x11", "US letter" and "A4 landscape" also work. | |
| angle_step | No | Polar only: degrees between spokes, e.g. 15 (default), 10, 5 or 30. | |
| line_color | No | Line colour as a name or hex, e.g. "light blue", "gray", "green", "black" or "#4A7FC1". Default depends on the type. | |
| paper_type | Yes | Paper type, e.g. "square" (graph paper), "dot", "isometric", "isometric dot", "hex", "polar", "semi-log", "log-log", "engineering", "quad ruled" (4 squares per inch), "millimetre paper" (1 mm grid), or "coordinate plane" for a grid with x and y axes. Lined, Cornell, music staff, guitar tab and calligraphy also work here. | |
| line_weight | No | Line thickness in points or a word, e.g. 0.4, "0.25 pt", "thin" or "bold". Default 0.4 pt (dots 1.4 pt). | |
| major_every | No | Draw a heavier line every N squares, e.g. 5 or 10. Default none (engineering: 5 per inch; 1 mm paper: 10). | |
| orientation | No | portrait or landscape, e.g. "landscape". Default portrait. | |
| hex_orientation | No | Hex only: "flat" (flat-top, default) or "pointy" (pointy-top). | |
| calibration_ruler | No | Print the 5 cm or 2 in check ruler in the bottom margin, e.g. true. Default true. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | ||
| notes | Yes | ||
| pages | Yes | ||
| layout | Yes | ||
| margin | Yes | ||
| assumed | Yes | ||
| request | Yes | ||
| spacing | Yes | ||
| downloads | Yes | ||
| page_size | Yes | ||
| paper_type | Yes | ||
| spacing_mm | Yes | ||
| spacing_pt | Yes | ||
| orientation | Yes | ||
| print_check | Yes | ||
| page_width_mm | Yes | ||
| page_height_mm | Yes |