parser_s...d_options(1grass)

📦
version 8.5.0 · 9 versions
, in alpine 3.24, ubuntu stonking

✨ Parser standard options ✨

okay so bestie, welcome to the parser_s...d_options(1grass) manual! 💖 This is the GRASS User's Manual, and we're about to go through the parser standard options together. No cap, we're listing every single one. 🎀

Here's the tea ☕: each option has these fields: option, answer, description, descriptions, gisprompt, key, key_desc, label, multiple, options, required, type. Some are blank, some are filled, and we're spilling all the deets. 💅

  • G_OPT_DB_SQL 💖
    • descriptions: Example: select * from towns where population > 10000 — it's giving "here's a whole SQL SELECT example" energy.
    • key: sql
    • key_desc: sql_query
    • label: SQL SELECT statement
    • required: NO
    • type: TYPE_STRING
  • G_OPT_DB_WHERE 🦋
    • descriptions: Example: income < 1000 and population >= 10000 — literally the example WHERE clause vibes.
    • gisprompt: old,sql_query,sql_query
    • key: where
    • key_desc: sql_query
    • label: WHERE conditions of SQL statement without ’where’ keyword — note the curly quotes around ’where’, bestie, we keep it exact.
    • required: NO
    • type: TYPE_STRING
  • G_OPT_DB_TABLE 🌸
    • description: Name of attribute table — it's giving "what's the table called?" realness.
    • gisprompt: old,dbtable,dbtable
    • key: table
    • key_desc: name
    • multiple: NO
    • required: NO
    • type: TYPE_STRING
  • G_OPT_DB_DRIVER 🌈
    • description: Name of database driver — the driver's name, periodt.
    • gisprompt: old,dbdriver,dbdriver
    • key: driver
    • key_desc: name
    • multiple: NO
    • required: NO
    • type: TYPE_STRING
  • G_OPT_DB_DATABASE 💜
    • description: Name of database — like, what's the database called?
    • gisprompt: old,dbname,dbname
    • key: database
    • key_desc: name
    • multiple: NO
    • required: NO
    • type: TYPE_STRING
  • G_OPT_DB_SCHEMA 🧚
    • description: Do not use this option if schemas are not supported by driver/database server — big warning energy! If your driver/database server doesn't do schemas, do NOT use this. 🚫
    • key: schema
    • key_desc: name
    • label: Database schema
    • multiple: NO
    • required: NO
    • type: TYPE_STRING
  • G_OPT_DB_COLUMN 🍓
    • description: Name of attribute column — the column's name, bestie.
    • gisprompt: old,dbcolumn,dbcolumn
    • key: column
    • key_desc: name
    • multiple: NO
    • required: NO
    • type: TYPE_STRING
  • G_OPT_DB_COLUMNS 🎀
    • description: Name of attribute column(s) — yes, plural, multiple columns are welcome here.
    • gisprompt: old,dbcolumn,dbcolumn
    • key: columns
    • key_desc: name
    • multiple: YES
    • required: NO
    • type: TYPE_STRING
  • G_OPT_DB_KEYCOLUMN 👑
    • answer: GV_KEY_COLUMN
    • description: Must refer to an integer column — it's gotta be an integer column, no exceptions.
    • key: key
    • key_desc: name
    • label: Name of key column
    • multiple: NO
    • required: NO
    • type: TYPE_STRING
  • G_OPT_I_GROUP 🦋
    • description: Name of input imagery group — the imagery group's name, slay.
    • gisprompt: old,group,group
    • key: group
    • key_desc: name
    • required: YES
    • type: TYPE_STRING
  • G_OPT_I_SUBGROUP 🌸
    • description: Name of input imagery subgroup — the subgroup's name, iconic.
    • gisprompt: old,subgroup,subgroup
    • key: subgroup
    • key_desc: name
    • required: YES
    • type: TYPE_STRING
  • G_OPT_MEMORYMB 💖
    • answer: 300
    • description: Cache size for raster rows — it's giving cache size vibes.
    • key: memory
    • key_desc: memory in MB
    • label: Maximum memory to be used (in MB)
    • multiple: NO
    • required: NO
    • type: TYPE_INTEGER
  • G_OPT_R_INPUT ✨
    • description: Name of input raster map — the input raster map's name, fr fr.
    • gisprompt: old,cell,raster
    • key: input
    • key_desc: name
    • required: YES
    • type: TYPE_STRING
  • G_OPT_R_INPUTS 🌈
    • description: Name of input raster map(s) — plural, multiple raster maps, we love to see it.
    • gisprompt: old,cell,raster
    • key: input
    • key_desc: name
    • multiple: YES
    • required: YES
    • type: TYPE_STRING
  • G_OPT_R_OUTPUT 💅
    • description: Name for output raster map — the name you're giving to the output raster map, periodt.
    • gisprompt: new,cell,raster
    • key: output
    • key_desc: name
    • required: YES
    • type: TYPE_STRING

okay so we're back in the ✨standard options✨ roster, and this chunk is the raster girlies plus the 3D raster girlies 💖 same row format as before — every entry hands you its description, its gisprompt, its key, its key description, a label when it has one, required, options, multiple and type. let's go, no skips, no crumbs:

  • G_OPT_R_OUTPUTS — Name for output raster map(s). plural coded and the flags agree, bestie — required YES and multiple YES, so it wants a whole squad of output names, not one lonely lil map.
    • the row: gisprompt new,cell,raster · key output · key description name · required YES · multiple YES · type TYPE_STRING
  • G_OPT_R_MAP — Name of raster map. one (1) raster map, singular, iconic, no crowd.
    • the row: gisprompt old,cell,raster · key map · key description name · required YES · type TYPE_STRING
  • G_OPT_R_MAPS — Name of raster map(s). same energy as the map one but it said "yes and also bring friends" 🌈.
    • the row: gisprompt old,cell,raster · key map · key description name · required YES · multiple YES · type TYPE_STRING
  • G_OPT_R_BASE — Name of base raster map. it's giving the base one, and it is required YES.
    • the row: gisprompt old,cell,raster · key base · key description name · required YES · type TYPE_STRING
  • G_OPT_R_COVER — Name of cover raster map. the cover one 🎀, also required YES, also TYPE_STRING, also not up for debate.
    • the row: gisprompt old,cell,raster · key cover · key description name · required YES · type TYPE_STRING
  • G_OPT_R_ELEV — Name of input elevation raster map. elevation, single serving, required YES 💅.
    • the row: gisprompt old,cell,raster · key elevation · key description name · required YES · type TYPE_STRING
  • G_OPT_R_ELEVS — Name of input elevation raster map(s). elevation but make it a whole collection, so required YES + multiple YES 🦋.
    • the row: gisprompt old,cell,raster · key elevation · key description name · required YES · multiple YES · type TYPE_STRING
  • G_OPT_R_TYPE — Storage type for resultant raster map. this one's the storage-type selector, and unlike its friends it is not required — the flag literally reads NO 🙂‍↕️.
    • the row: key type · question/label text Type of raster map to be created · required NO · options CELL,FCELL,DCELL · multiple YES · type TYPE_STRING
  • G_OPT_R_INTERP_TYPE — Sampling interpolation method. the sampling method picker, and it comes with the exact menu of values you'd expect: nearest,bilinear,bicubic ✨.
    • the row: key method · options nearest,bilinear,bicubic · then a NO · type TYPE_STRING
  • G_OPT_R_BASENAME_INPUT — Name of input basename raster map(s). input, but as a basename — and note it's required NO, so it's the optional lil guy in this lineup 🙈.
    • the row: gisprompt old,cell,raster · key input · key description basename · required NO · multiple YES · type TYPE_STRING
  • G_OPT_R_BASENAME_OUTPUT — Name for output basename raster map(s). the output twin of the one above, same basename situation, gisprompt is the new,cell,raster one 💖.
    • the row: gisprompt new,cell,raster · key output · key description basename · required NO · multiple YES · type TYPE_STRING
  • G_OPT_R3_INPUT — Name of input 3D raster map. we're in 3D now, bestie — gisprompt flips to old,grid3,raster_3d 🌸.
    • the row: gisprompt old,grid3,raster_3d · key input · key description name · required YES · type TYPE_STRING
  • G_OPT_R3_INPUTS — Name of input 3D raster map(s). 3D inputs, plural, required YES, multiple YES, zero chill 🫶.
    • the row: gisprompt old,grid3,raster_3d · key input · key description name · required YES · multiple YES · type TYPE_STRING
  • G_OPT_R3_OUTPUT — Name for output 3D raster map. output side of the 3D world, gisprompt new,grid3,raster_3d ⭐.
    • the row: gisprompt new,grid3,raster_3d · key output · key description name · required YES · type TYPE_STRING
  • G_OPT_R3_MAP — Name of 3D raster map. one 3D raster map, singular, required YES, no notes 💅.
    • the row: gisprompt old,grid3,raster_3d · key map · key description name · required YES · type TYPE_STRING
  • G_OPT_R3_MAPS — Name of 3D raster map(s). the "and friends" version of the 3D map, multiple YES 🔥.
    • the row: gisprompt old,grid3,raster_3d · key map · key description name · required YES · multiple YES · type TYPE_STRING
  • G_OPT_R3_TYPE — Data type used in the output raster3d map. the 3D data-type picker — and heads up, there's a stray default sitting right after the name in this row, like it just moved in 🍓.
    • the row: default (right after the name) · key type · required NO · options default,double,float · multiple NO · type TYPE_STRING

and that's the whole raster + raster3d block, all seventeen of them, every flag intact periodt 🌈 next batch is loading up 💜

okay so the standard-options parade keeps going and honestly? every single one of these bad boys is here 💅

  • G_OPT_R3_PRECISION 🌸 — the digits situation: number of digits used as mantissa in the internal map storage, 0 -23 for float, 0 - 52 for double, max or default.
    • key: precision
    • default answer: default
    • required: NO
    • multiple: NO
    • type: TYPE_STRING
  • G_OPT_R3_COMPRESSION 🎀 — which compression method gets used in the output raster3d map.
    • key: compression
    • default answer: default
    • allowed values: default,zip,none
    • required: NO
    • multiple: NO
    • type: TYPE_STRING
  • G_OPT_R3_TILE_DIMENSION ✨ — the dimensions of the tiles used in the output raster3d map (XxYxZ or default: 16x16x8).
    • key: tiledimension
    • shown as: XxYxZ
    • default answer: default
    • required: NO
    • multiple: NO
    • type: TYPE_STRING
  • G_OPT_V_INPUT 💖 — name of input vector map, or data source for direct OGR access.
    • key: input
    • gisprompt: old,vector,vector
    • and there's a lil name slot sitting in the table too 🙈
    • required: YES
    • type: TYPE_STRING
  • G_OPT_V_INPUTS 💖💖 — the plural queen: name of input vector map(s), or data source(s) for direct OGR access.
    • key: input
    • gisprompt: old,vector,vector
    • lil name slot again 🙈
    • required: YES
    • multiple: YES
    • type: TYPE_STRING
  • G_OPT_V_OUTPUT 🦋 — name for output vector map. this is where the slay gets written, bestie.
    • key: output
    • gisprompt: new,vector,vector
    • required: YES
    • type: TYPE_STRING
  • G_OPT_V_MAP 🌸 — name of vector map, or data source for direct OGR access.
    • key: map
    • gisprompt: old,vector,vector
    • lil name slot 🙈
    • required: YES
    • type: TYPE_STRING
  • G_OPT_V_MAPS 🌸🌸 — name of vector map(s).
    • key: map
    • gisprompt: old,vector,vector
    • required: YES
    • multiple: YES
    • type: TYPE_STRING
  • G_OPT_V_TYPE 🔥 — input feature type, and you get to pick from the menu.
    • key: type
    • allowed values: point,line,boundary,centroid,area
    • required: YES
    • multiple: NO
    • type: TYPE_STRING
  • G_OPT_V3_TYPE 🔥🔥 — input feature type but make it 3D-coded, extra flavours included.
    • key: type
    • allowed values: point,line,boundary,centroid,area,face,kernel
    • required: YES
    • multiple: NO
    • type: TYPE_STRING
  • G_OPT_V_FIELD 💅 — the whole "which layer are we even talking about" moment. Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.
    • key: layer
    • gisprompt: old,layer,layer
    • described as: Layer number or name
    • default answer: 1
    • required: NO
    • type: TYPE_STRING
  • G_OPT_V_FIELD_ALL 💅💅 — same energy, but all of them. A single vector map can be connected to multiple database tables. This number determines which table to use. When used with direct OGR access this is the layer name.
    • key: layer
    • gisprompt: old,layer_all,layer
    • described as: Layer number or name (’-1’ for all layers)
    • default answer: -1
    • required: NO
    • type: TYPE_STRING
  • G_OPT_V_CAT 🍓 — category value.
    • key: cat
    • gisprompt: old,cat,cats
    • required: NO
    • type: TYPE_INTEGER
  • G_OPT_V_CATS 🍓🍓 — category values, plural, little ranges and everything. the description literally just says Example: 1,3,7-9,13 and honestly? iconic, it shows instead of tells.
    • key: cats
    • gisprompt: old,cats,cats
    • the table also shows range and Category values in there 🫶
    • required: NO
    • type: TYPE_STRING
  • G_OPT_V_ID ⭐ — feature id.
    • key: id
    • required: NO
    • type: TYPE_INTEGER

(still the exact same table, same column order, same everything — I'm just reading each row straight across and skipping the blank cells, because blank is blank, bestie 😌)

  • G_OPT_V_IDS 🎯 — Example: 1,3,7-9,13 · ids · range · Feature ids · NO · TYPE_STRING
  • G_OPT_F_INPUT 📂 — Name of input file · old,file,file · input · name · YES · TYPE_STRING
  • G_OPT_F_BIN_INPUT 💾 — Name of input file · old,bin,file · input · name · YES · TYPE_STRING
  • G_OPT_F_OUTPUT 📤 — Name for output file · new,file,file · output · name · YES · TYPE_STRING
  • G_OPT_F_SEP 🍡 — pipe · Special characters: pipe, comma, space, tab, newline · old,separator,separator · separator · character · Field separator · NO · TYPE_STRING
  • G_OPT_F_FORMAT 🎨 — plain · plain;Plain text output;json;JSON (JavaScript Object Notation); · format · name · Output format · plain,json · YES · TYPE_STRING
not the ;-separated chunk staying exactly as written — plain;Plain text output;json;JSON (JavaScript Object Notation); — trailing semicolon and all, no notes, no edits 💅
  • G_OPT_C 🌈 — DEFAULT_FG_COLOR · Either a standard color name or R:G:B triplet · old,color,color · color · name · Color · NO · TYPE_STRING
  • G_OPT_CN 🎀 — DEFAULT_FG_COLOR · Either a standard color name, R:G:B triplet, or "none" · old,color_none,color · color · name · Color · NO · TYPE_STRING
  • G_OPT_C_FORMAT 💠 — hex · Color format for output values. · color_format · name · Color format · NO · rgb,hex,hsv,triplet · YES · TYPE_STRING
  • G_OPT_M_DIR 📁 — Name of input directory · old,dir,dir · input · name · YES · TYPE_STRING
  • G_OPT_M_UNITS 📏 — Units · units · NO · miles,feet,meters,kilometers,acres,hectares · NO · TYPE_STRING
  • G_OPT_M_DATATYPE 🔢 — Data type(s) · type · datatype · YES · YES · TYPE_STRING
  • G_OPT_M_MAPSET 🗂️ — '.' for current mapset · old,mapset,mapset · mapset · name · Name of mapset (default: current search path) · NO · NO · TYPE_STRING
  • G_OPT_M_LOCATION 🌍 — Project name (not path to project) · old,location,location · project · name · Project (location) name · NO · NO · TYPE_STRING
  • G_OPT_M_DBASE 🗄️ — Default: path to the current GRASS database · old,dbase,dbase · dbase · path · GRASS database directory · NO · NO · TYPE_STRING
  • G_OPT_M_COORDS 📍 — Coordinates · old,coords,coords · coordinates · east,north · NO · NO · TYPE_DOUBLE
  • G_OPT_M_COLR 🌸 — Name of color table · G_color_rules_description_type() · old,colortable,colortable · color · style · G_color_rules_options() · NO · TYPE_STRING
okay the G_color_rules_description_type() and G_color_rules_options() cells are literally written like that, function-call parentheses and everything, so don't go "fixing" them into pretty words. They sit exactly where they sit. 🫶

and that's where this chunk of the table lands — next rows comin' right up 💖

still deep in the standard-options table, carrying on exactly where we left off 💅

quick reminder of the vibe: each row gives you the description first, then the rest of the fields in the same left-to-right order the table has them, kept character for character so nothing gets lost in translation. no cap.

  • G_OPT_M_NULL_VALUE — String representing NULL value — null_value · string · NO · NO · TYPE_STRING
  • G_OPT_M_REGION — Name of saved region — old,windows,region · region · name · NO · TYPE_STRING
  • G_OPT_M_NPROCS — Number of threads for parallel computing — nprocs · NO · NO · TYPE_INTEGER — and the row also carries the bits about what the numbers mean: 0 · 0: use OpenMP default; >0: use nprocs; <0: use MAX-nprocs
  • G_OPT_M_SEED — Seed value for the random number generator — seed · NO · TYPE_INTEGER — with the note riding along that using the same seed ensures identical results, while a randomly generated seed produces different outcomes in each run.

and now the whole space-time dataset family, which is genuinely so satisfying because they're all the same pattern 🦋

  • G_OPT_STDS_INPUT — Name of the input space time dataset — old,stds,stds · input · name · YES · TYPE_STRING
  • G_OPT_STDS_INPUTS — Name of the input space time datasets — old,stds,stds · inputs · name · YES · YES · TYPE_STRING
  • G_OPT_STDS_OUTPUT — Name of the output space time dataset — new,stds,stds · output · name · YES · TYPE_STRING
  • G_OPT_STRDS_INPUT — Name of the input space time raster dataset — old,strds,strds · input · name · YES · TYPE_STRING
  • G_OPT_STRDS_INPUTS — Name of the input space time raster datasets — old,strds,strds · inputs · name · YES · YES · TYPE_STRING
  • G_OPT_STRDS_OUTPUT — Name of the output space time raster dataset — new,strds,strds · output · name · YES · TYPE_STRING
  • G_OPT_STRDS_OUTPUTS — Name of the output space time raster datasets — new,strds,strds · outputs · name · YES · YES · TYPE_STRING
  • G_OPT_STVDS_INPUT — Name of the input space time vector dataset — old,stvds,stvds · input · name · YES · TYPE_STRING
  • G_OPT_STVDS_INPUTS — Name of the input space time vector datasets — old,stvds,stvds · inputs · name · YES · YES · TYPE_STRING
  • G_OPT_STVDS_OUTPUT — Name of the output space time vector dataset — new,stvds,stvds · output · name · YES · TYPE_STRING
  • G_OPT_STR3DS_INPUT — Name of the input space time raster3d dataset — old,str3ds,str3ds · input · name · YES · TYPE_STRING
  • G_OPT_STR3DS_INPUTS — Name of the input space time raster3d datasets — old,str3ds,str3ds · inputs · name · YES · YES · TYPE_STRING

notice the pattern bestie: old,... for stuff coming in, new,... for stuff going out, singular keys for one, plural keys (inputs, outputs) when it wants a whole list instead of just one — and the plural ones are the only ones stacking that second YES on top of the first ✨

  • G_OPT_STR3DS_OUTPUT — okay so this one is your brand-new output space time raster3d dataset name 💖
    • What it's giving: "Name of the output space time raster3d dataset"
    • Key: output · Type: name
    • Row token: new,str3ds,str3ds
    • Required: YES — it's mandatory, no skipping bestie 💅
    • Answer type: TYPE_STRING
  • G_OPT_STDS_TYPE — the "which flavour of space time dataset are we talking about" picker 🦋
    • What it's giving: "Type of the input space time dataset"
    • Key: type · Type: name
    • Values: strds,stvds,str3ds
    • Row token: strds
    • Required: NO
    • Answer type: TYPE_STRING
  • G_OPT_MAP_INPUT — one single input map, pls and thank you 🎀
    • What it's giving: "Name of the input map"
    • Key: map · Type: name
    • Row token: old,map,map
    • Required: YES
    • Answer type: TYPE_STRING
  • G_OPT_MAP_INPUTS — the plural era, "Name of the input maps" 🌈 (yes, maps, we're not doing just one)
    • Key: maps · Type: name
    • Row token: old,map,map
    • Required: YES — and the row double-stamps a second YES right there too, it's a whole double-yes situation 😌
    • Answer type: TYPE_STRING
  • G_OPT_MAP_TYPE — "Type of the input map", quick little vibe check on your map 💜
    • Key: type · Type: name
    • Values: raster,vector,raster_3d
    • Row token: raster
    • Required: NO
    • Answer type: TYPE_STRING
  • G_OPT_T_SUFFIX — the suffix adder, and it is serving options 🌸
    • What it's giving: "Suffix to add at basename: set 'gran' for granularity, 'time' for the full time format, 'num' for numerical suffix with a specific number of digits (default %%05)"
    • Key: suffix · Type: name
    • Row token: gran
    • Required: NO
    • Answer type: TYPE_STRING
  • G_OPT_T_TYPE — "The temporal type of the space time dataset", i.e. absolute or relative, pick your timeline ⏳
    • Key: temporaltype · Type: name
    • Values: absolute,relative
    • Row token: absolute
    • Required: NO
    • Answer type: TYPE_STRING
  • G_OPT_T_WHERE — the SQL WHERE machine, and it goes hard 👑
    • What it's giving: "WHERE conditions of SQL statement without 'where' keyword used in the temporal GIS framework"
    • Example the row hands you: start_time > '2001-01-01 12:30:00'
    • Key: where · Type: sql_query
    • Required: NO
    • Answer type: TYPE_STRING
  • G_OPT_T_SAMPLE — "The method to be used for sampling the input dataset" 🧚
    • Key: sampling · Type: name
    • Values: start,during,overlap,contain,equal,follows,precedes
    • Row token: start — and a YES also pops up in that row right before the values list, so yeah, there are two flags living in there 🙈
    • Required: NO
    • Answer type: TYPE_STRING

🦋 the index lineup

  • Main index
  • Topics index
  • Keywords index
  • Graphical index
  • Full index
And that's a wrap, bestie!! 💖 This page lives in the GRASS 8.5.0 Reference Manual, copyright © 2003-2026 GRASS Development Team, and the footer tags it as GRASS 8.5.0 alongside parser_s...d_options(1grass). Go build something iconic with these 🫶✨
📦 where this page comes from