---
name: t.list
description: "Lists space time datasets and maps registered in the temporal database."
keywords: [ temporal, map management, list, time ]
---

# t.list

Lists space time datasets and maps registered in the temporal database.

=== "Command line"

    **t.list**
    [**-c**]
    [**type**=*string*]
    [**temporaltype**=*name* [,*name*,...]]
    [**order**=*string* [,*string*,...]]
    [**columns**=*string* [,*string*,...]]
    [**where**=*sql_query*]
    **format**=*name*
    [**mapset**=*name* [,*name*,...]]
    [**separator**=*character*]
    [**output**=*name*]
    [**--overwrite**]
    [**--verbose**]
    [**--quiet**]
    [**--qq**]
    [**--ui**]

    Example:

    ```sh
    t.list format=plain
    ```

=== "Python (grass.tools)"

    *grass.tools.Tools.t_list*(**type**=*"strds"*,
        **temporaltype**=*"absolute,relative"*,
        **order**=*"id"*,
        **columns**=*""*,
        **where**=*None*,
        **format**=*"plain"*,
        **mapset**=*None*,
        **separator**=*""*,
        **output**=*None*,
        **flags**=*None*,
        **overwrite**=*None*,
        **verbose**=*None*,
        **quiet**=*None*,
        **superquiet**=*None*)

    Example:

    ```python
    tools = Tools()
    tools.t_list(format="json")
    ```

    This grass.tools API is experimental in version 8.5 and expected to be stable in version 8.6.

=== "Python (grass.script)"

    *grass.script.parse_command*("***t.list***",
        **type**=*"strds"*,
        **temporaltype**=*"absolute,relative"*,
        **order**=*"id"*,
        **columns**=*""*,
        **where**=*None*,
        **format**=*"plain"*,
        **mapset**=*None*,
        **separator**=*""*,
        **output**=*None*,
        **flags**=*None*,
        **overwrite**=*None*,
        **verbose**=*None*,
        **quiet**=*None*,
        **superquiet**=*None*)

    Example:

    ```python
    gs.parse_command("t.list", format="json")
    ```

## Parameters

=== "Command line"

    **type**=*string*  
    &nbsp;&nbsp;&nbsp;&nbsp;Type of the space time dataset or map, default is strds  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *strds,  str3ds,  stvds,  raster,  raster_3d,  vector*  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *strds*  
    **temporaltype**=*name* [,*name*,...]  
    &nbsp;&nbsp;&nbsp;&nbsp;The temporal type of the space time dataset  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *absolute, relative*  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *absolute,relative*  
    **order**=*string* [,*string*,...]  
    &nbsp;&nbsp;&nbsp;&nbsp;Sort the space time dataset by category  
    &nbsp;&nbsp;&nbsp;&nbsp;Columns number_of_maps and granularity only available for space time datasets  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *id, name, semantic_label, creator, mapset, number_of_maps, creation_time, start_time, end_time, interval, north, south, west, east, granularity*  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *id*  
    **columns**=*string* [,*string*,...]  
    &nbsp;&nbsp;&nbsp;&nbsp;Columns to be printed to stdout  
    &nbsp;&nbsp;&nbsp;&nbsp;Columns number_of_maps and granularity only available for space time datasets  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *id, name, semantic_label, creator, mapset, number_of_maps, creation_time, start_time, end_time, north, south, west, east, granularity, all*  
    **where**=*sql_query*  
    &nbsp;&nbsp;&nbsp;&nbsp;WHERE conditions of SQL statement without 'where' keyword used in the temporal GIS framework  
    &nbsp;&nbsp;&nbsp;&nbsp;Example: start_time &gt; '2001-01-01 12:30:00'  
    **format**=*name* **[required]**  
    &nbsp;&nbsp;&nbsp;&nbsp;Output format  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *plain, line, json, csv*  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *plain*  
    &nbsp;&nbsp;&nbsp;&nbsp;**plain**: Plain text output  
    &nbsp;&nbsp;&nbsp;&nbsp;**line**: Comma separated list of dataset names  
    &nbsp;&nbsp;&nbsp;&nbsp;**json**: JSON (JavaScript Object Notation)  
    &nbsp;&nbsp;&nbsp;&nbsp;**csv**: CSV (Comma Separated Values)  
    **mapset**=*name* [,*name*,...]  
    &nbsp;&nbsp;&nbsp;&nbsp;Name of mapset (default: current search path)  
    &nbsp;&nbsp;&nbsp;&nbsp;Name of mapsets to list ('.' for current, '\*' for all mapsets)  
    **separator**=*character*  
    &nbsp;&nbsp;&nbsp;&nbsp;Field separator character between the output columns  
    &nbsp;&nbsp;&nbsp;&nbsp;Special characters: pipe, comma, space, tab, newline  
    **output**=*name*  
    &nbsp;&nbsp;&nbsp;&nbsp;Name for output file  
    **-c**  
    &nbsp;&nbsp;&nbsp;&nbsp;Print the column names as first row  
    **--overwrite**  
    &nbsp;&nbsp;&nbsp;&nbsp;Allow output files to overwrite existing files  
    **--help**  
    &nbsp;&nbsp;&nbsp;&nbsp;Print usage summary  
    **--verbose**  
    &nbsp;&nbsp;&nbsp;&nbsp;Verbose module output  
    **--quiet**  
    &nbsp;&nbsp;&nbsp;&nbsp;Quiet module output  
    **--qq**  
    &nbsp;&nbsp;&nbsp;&nbsp;Very quiet module output  
    **--ui**  
    &nbsp;&nbsp;&nbsp;&nbsp;Force launching GUI dialog

=== "Python (grass.tools)"

    **type** : str, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Type of the space time dataset or map, default is strds  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *strds,  str3ds,  stvds,  raster,  raster_3d,  vector*  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *strds*  
    **temporaltype** : str | list[str], *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;The temporal type of the space time dataset  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: *name*  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *absolute, relative*  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *absolute,relative*  
    **order** : str | list[str], *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Sort the space time dataset by category  
    &nbsp;&nbsp;&nbsp;&nbsp;Columns number_of_maps and granularity only available for space time datasets  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *id, name, semantic_label, creator, mapset, number_of_maps, creation_time, start_time, end_time, interval, north, south, west, east, granularity*  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *id*  
    **columns** : str | list[str], *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Columns to be printed to stdout  
    &nbsp;&nbsp;&nbsp;&nbsp;Columns number_of_maps and granularity only available for space time datasets  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *id, name, semantic_label, creator, mapset, number_of_maps, creation_time, start_time, end_time, north, south, west, east, granularity, all*  
    **where** : str, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;WHERE conditions of SQL statement without 'where' keyword used in the temporal GIS framework  
    &nbsp;&nbsp;&nbsp;&nbsp;Example: start_time &gt; '2001-01-01 12:30:00'  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: *sql_query*  
    **format** : str, *required*  
    &nbsp;&nbsp;&nbsp;&nbsp;Output format  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: *name*  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *plain, line, json, csv*  
    &nbsp;&nbsp;&nbsp;&nbsp;**plain**: Plain text output  
    &nbsp;&nbsp;&nbsp;&nbsp;**line**: Comma separated list of dataset names  
    &nbsp;&nbsp;&nbsp;&nbsp;**json**: JSON (JavaScript Object Notation)  
    &nbsp;&nbsp;&nbsp;&nbsp;**csv**: CSV (Comma Separated Values)  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *plain*  
    **mapset** : str | list[str], *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Name of mapset (default: current search path)  
    &nbsp;&nbsp;&nbsp;&nbsp;Name of mapsets to list ('.' for current, '\*' for all mapsets)  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: input, mapset, *name*  
    **separator** : str, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Field separator character between the output columns  
    &nbsp;&nbsp;&nbsp;&nbsp;Special characters: pipe, comma, space, tab, newline  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: input, separator, *character*  
    **output** : str, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Name for output file  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: output, file, *name*  
    **flags** : str, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *c*  
    &nbsp;&nbsp;&nbsp;&nbsp;**c**  
    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print the column names as first row  
    **overwrite** : bool, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Allow output files to overwrite existing files  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *None*  
    **verbose** : bool, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Verbose module output  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *None*  
    **quiet** : bool, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Quiet module output  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *None*  
    **superquiet** : bool, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Very quiet module output  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *None*  

    Returns:

    **result** : grass.tools.support.ToolResult | None  
    If the tool produces text as standard output, a *ToolResult* object will be returned. Otherwise, `None` will be returned.

    Raises:

    *grass.tools.ToolError*: When the tool ended with an error.

=== "Python (grass.script)"

    **type** : str, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Type of the space time dataset or map, default is strds  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *strds,  str3ds,  stvds,  raster,  raster_3d,  vector*  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *strds*  
    **temporaltype** : str | list[str], *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;The temporal type of the space time dataset  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: *name*  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *absolute, relative*  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *absolute,relative*  
    **order** : str | list[str], *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Sort the space time dataset by category  
    &nbsp;&nbsp;&nbsp;&nbsp;Columns number_of_maps and granularity only available for space time datasets  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *id, name, semantic_label, creator, mapset, number_of_maps, creation_time, start_time, end_time, interval, north, south, west, east, granularity*  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *id*  
    **columns** : str | list[str], *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Columns to be printed to stdout  
    &nbsp;&nbsp;&nbsp;&nbsp;Columns number_of_maps and granularity only available for space time datasets  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *id, name, semantic_label, creator, mapset, number_of_maps, creation_time, start_time, end_time, north, south, west, east, granularity, all*  
    **where** : str, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;WHERE conditions of SQL statement without 'where' keyword used in the temporal GIS framework  
    &nbsp;&nbsp;&nbsp;&nbsp;Example: start_time &gt; '2001-01-01 12:30:00'  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: *sql_query*  
    **format** : str, *required*  
    &nbsp;&nbsp;&nbsp;&nbsp;Output format  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: *name*  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *plain, line, json, csv*  
    &nbsp;&nbsp;&nbsp;&nbsp;**plain**: Plain text output  
    &nbsp;&nbsp;&nbsp;&nbsp;**line**: Comma separated list of dataset names  
    &nbsp;&nbsp;&nbsp;&nbsp;**json**: JSON (JavaScript Object Notation)  
    &nbsp;&nbsp;&nbsp;&nbsp;**csv**: CSV (Comma Separated Values)  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *plain*  
    **mapset** : str | list[str], *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Name of mapset (default: current search path)  
    &nbsp;&nbsp;&nbsp;&nbsp;Name of mapsets to list ('.' for current, '\*' for all mapsets)  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: input, mapset, *name*  
    **separator** : str, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Field separator character between the output columns  
    &nbsp;&nbsp;&nbsp;&nbsp;Special characters: pipe, comma, space, tab, newline  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: input, separator, *character*  
    **output** : str, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Name for output file  
    &nbsp;&nbsp;&nbsp;&nbsp;Used as: output, file, *name*  
    **flags** : str, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Allowed values: *c*  
    &nbsp;&nbsp;&nbsp;&nbsp;**c**  
    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print the column names as first row  
    **overwrite** : bool, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Allow output files to overwrite existing files  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *None*  
    **verbose** : bool, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Verbose module output  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *None*  
    **quiet** : bool, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Quiet module output  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *None*  
    **superquiet** : bool, *optional*  
    &nbsp;&nbsp;&nbsp;&nbsp;Very quiet module output  
    &nbsp;&nbsp;&nbsp;&nbsp;Default: *None*

## DESCRIPTION

*t.list* lists any dataset that is registered in the temporal database.
Datasets are raster, 3D raster and vector maps as well as their
corresponding space time datasets (STRDS, STR3DS and STVDS). The type of
the dataset can be specified using the *type* option, default is STRDS.
By default all datasets with relative and absolute time are listed.
However, the user has the ability to specify a single temporal type with
the *temporaltype* option. The user can define the columns that should
be printed for each dataset and the order of the datasets. In addition a
SQL WHERE statement can be specified to select a subset of the requested
datasets.

## NOTES

The SQL *where* and *sort* expression will be applied for each temporal
database that was found in accessible mapsets. Hence sorting works only
on mapset basis.

The **mapset** option allows the user to filter the output to one
or multiple specific mapsets, or to query all mapsets in the project regardless
of the current search path. By default (if the **mapset** option is not provided),
Temporal datasets are listed from all mapsets in the user's current search path
(managed with [g.mapsets](g.mapsets.md)).

The **mapset** parameter accepts the following inputs:
`mapset='.'` lists datasets only in the current mapset.
`mapset='*'` lists datasets in all mapsets in the project (location), bypassing
the search path.
`mapset=name1,name2` lists datasets strictly from the explicitly named mapsets,
even if they are outside the current search path.

## EXAMPLES

Obtain the list of space time raster dataset(s) in the current search path:

```sh
t.list strds
----------------------------------------------
Space time raster datasets with absolute time available in mapset <climate_2000_2012>:
tempmean_monthly@climate_2000_2012
```

Obtain the list of space time raster datasets in a specific mapset, even if it is
not in the search path:

```sh
t.list strds mapset=modis2002lst
----------------------------------------------
Space time raster datasets with absolute time available in mapset <modis2002lst>:
mini_set@modis2002lst
```

Obtain the list of space time raster datasets across all mapsets in the project
(location) using '*':

```sh
t.list type=strds mapset='*'
----------------------------------------------
Space time raster datasets with absolute time available in mapset <climate_2000_2012>:
precip_abs@climate_2000_2012
precipitation@climate_2000_2012
tempmean@climate_2000_2012
Space time raster datasets with absolute time available in mapset <modis2002lst>:
mini_set@modis2002lst
```

Obtain the list of space time raster datasets in a specific mapset (Note
that the target mapset must be in the user's search path):

```sh
# strds in PERMANENT
t.list strds where="mapset = 'PERMANENT'"
----------------------------------------------

# strds in climate_2000_2012
t.list strds where="mapset = 'climate_2000_2012'"
----------------------------------------------
Space time raster datasets with absolute time available in mapset <climate_2000_2012>:
precip_abs@climate_2000_2012
precipitation@climate_2000_2012
tempmean@climate_2000_2012
```

The *where* option can also be used to list the stds with a certain
pattern in their name, i.e. as the pattern option in
[g.list](g.list.md).

```sh
# strds whose name start with "precip"
t.list type=strds where="name LIKE 'precip%'"
----------------------------------------------
Space time raster datasets with absolute time available in mapset <climate_1970_2012>:
precip_abs@climate_1970_2012
precipitation@climate_1970_2012
```

The user can also obtain the list of time stamped raster maps. These
maps might be registered in strds or not. The output of the following
command can vary according to the accessible mapsets specified through
[g.mapsets](g.mapsets.md).

```sh
t.list raster
Time stamped raster maps with absolute time available in mapset <climate_2000_2012>:
2009_01_tempmean@climate_2000_2012
2009_02_tempmean@climate_2000_2012
2009_03_tempmean@climate_2000_2012
...
2012_10_tempmean@climate_2000_2012
2012_11_tempmean@climate_2000_2012
2012_12_tempmean@climate_2000_2012
```

You can also use the *format=* option with `plain` (default), `csv`, `line`, and
`json`.
For `plain`, `csv`, and `line`, you can also use the *separator=* option to change
 the output delimiter.

To output the list in JSON format, use `format=json`. By default, if no
columns are specified in json format, it will output all available metadata. You
can restrict the output using the `columns` parameter.

```sh
t.list type=raster format=json columns=id,start_time
```

```json
[
    {
        "id": "2009_01_tempmean@climate_2000_2012",
        "start_time": "2009-01-01 00:00:00"
    },
    {
        "id": "2009_02_tempmean@climate_2000_2012",
        "start_time": "2009-02-01 00:00:00"
    },
    {
        "id": "2009_03_tempmean@climate_2000_2012",
        "start_time": "2009-03-01 00:00:00"
    },
    ...
    {
        "id": "2012_11_tempmean@climate_2000_2012",
        "start_time": "2012-11-01 00:00:00"
    },
    {
        "id": "2012_12_tempmean@climate_2000_2012",
        "start_time": "2012-12-01 00:00:00"
    }
]

```

## SEE ALSO

*[g.list](g.list.md), [t.create](t.create.md), [t.info](t.info.md),
[t.rast.list](t.rast.list.md), [t.rast3d.list](t.rast3d.list.md),
[t.vect.list](t.vect.list.md)*

## AUTHOR

Sören Gebbert, Thünen Institute of Climate-Smart Agriculture

## SOURCE CODE

Available at: [t.list source code](https://github.com/OSGeo/grass/tree/main/temporal/t.list)
([history](https://github.com/OSGeo/grass/commits/main/temporal/t.list))  
Latest change: Thursday Jul 09 03:03:48 2026 in commit [dcb3324](https://github.com/OSGeo/grass/commit/dcb3324768fc8dddb7d3937bea0fd6ab49f614c1)
