---
name: "osgearth_cache"
section: "1"
platform: "linux"
package: "osgearth"
version: "2.10.0+dfsg-1+b1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/osgearth_cache"
---

# osgearth\_cache(1)

manage osgEarth's cache

## NAME

osgearth\_cache - manage osgEarth's cache

## SYNOPSIS

**osgearth\_cache**  \[**--list** \| **--seed** \| **--estimate** \| **--threads** \| **--min-level** *level* \| **--max-level** *level* \| **--bounds** *xmin* *ymin* *xmax* *ymax* \| **--index** *shapefile* \| **--cache-path** *path* \| **--cache-type** *type* \| **--purge**\] *file.earth*

## DESCRIPTION

**osgearth\_cache** can be used to manage osgEarth's cache. The most common usage of **osgearth\_cache** is to populate a cache in a non-interactive manner using the FC**--seed**F\[0\] argument. See Caching ⟨http://docs.osgearth.org/en/latest/user/caching.html⟩ for more information on caching.

## OPTIONS

- FC**--list**F\[0\]

  Lists info about the cache in a .earth file

- FC**--seed**F\[0\]

  Seeds the cache in a .earth file

- FC**--estimate**F\[0\]

  Print out an estimation of the number of tiles, disk space and time it will take to perform this seed operation

- FC**--threads**F\[0\]

  The number of threads to use for the seed operation (default=1)

- FC**--min-level**F\[0\] *level*

  Lowest LOD level to seed (default=0)

- FC**--max-level**F\[0\] *level*

  Highest LOD level to seed (default=highest available)

- FC**--bounds**F\[0\] *xmin* *ymin* *xmax* *ymax*

  Geospatial bounding box to seed (in map coordinates; default=entire map)

- FC**--index**F\[0\] *shapefile*

  Loads a shapefile (.shp) and uses the feature extents to set the cache seeding bounding box(es). For each feature in the shapefile, adds a bounding box (similar to FC**--bounds**F\[0\]) to constrain the region you wish to cache.

- FC**--cache-path**F\[0\] *path*

  Overrides the cache path in the .earth file

- FC**--cache-type**F\[0\] *type*

  Overrides the cache type in the .earth file

- FC**--purge**F\[0\]

  Purges a layer cache in a .earth file

- *file.earth*

  Path to the earth file