README.md

GeoStatsImages.jl

Training images for geostastical simulation in Julia.

This package converts famous training images from the geostatistcs literature to a standard format for quick experimentation in Julia. It is part of the GeoStats.jl framework and can be used in conjunction with multiple-point simulation algorithms.

The contributors of this package do not hold any copyright on the data. Please give credit to the sources listed on the preview table.

Usage

The geostatsimage function takes a string identifier as its only argument, and returns a geotable as discussed in the book Geospatial Data Science with Julia:

julia> geostatsimage("WalkerLake")
160000×2 GeoTable over 400×400 CartesianGrid
┌────────────┬───────────────────────────────────────────────────────────────┐
│     Z      │                           geometry                            │
│ Continuous │                          Quadrangle                           │
│ [NoUnits]  │                     🖈 Cartesian{NoDatum}                      │
├────────────┼───────────────────────────────────────────────────────────────┤
│  0.256614  │  Quadrangle((x: 0.0 m, y: 0.0 m), ..., (x: 0.0 m, y: 1.0 m))  │
│  0.260752  │  Quadrangle((x: 1.0 m, y: 0.0 m), ..., (x: 1.0 m, y: 1.0 m))  │
│  0.26127   │  Quadrangle((x: 2.0 m, y: 0.0 m), ..., (x: 2.0 m, y: 1.0 m))  │
│  0.24452   │  Quadrangle((x: 3.0 m, y: 0.0 m), ..., (x: 3.0 m, y: 1.0 m))  │
│  0.220545  │  Quadrangle((x: 4.0 m, y: 0.0 m), ..., (x: 4.0 m, y: 1.0 m))  │
│  0.211095  │  Quadrangle((x: 5.0 m, y: 0.0 m), ..., (x: 5.0 m, y: 1.0 m))  │
│  0.21892   │  Quadrangle((x: 6.0 m, y: 0.0 m), ..., (x: 6.0 m, y: 1.0 m))  │
│  0.239326  │  Quadrangle((x: 7.0 m, y: 0.0 m), ..., (x: 7.0 m, y: 1.0 m))  │
│     ⋮      │                               ⋮                               │
└────────────┴───────────────────────────────────────────────────────────────┘
                                                           159992 rows omitted

The list of available identifiers can be found with GeoStatsImages.available().

Preview

Identifier	Preview	Type	Data source
WalkerLake		Continuous	Mariethoz & Caers, 2014
WalkerLakeTruth		Continuous	Mariethoz & Caers, 2014
StoneWall		Continuous	Mariethoz & Caers 2014
Herten		Continuous	Mariethoz & Caers 2014
Lena		Continuous	Mariethoz & Caers 2014
StanfordV		Continuous	Mao & Journel 2014
Gaussian30x10		Continuous	Hoffimann 2020
Strebelle		Categorical	Strebelle 2002
Ellipsoids		Categorical	Mariethoz & Caers 2014
WestCoastAfrica		Categorical	Mariethoz & Caers 2014
Flumy		Categorical	Hoffimann et al 2017
Fluvsim		Categorical	Mariethoz & Caers, 2014
Ketton		Categorical	Imperial College Pore-Scale Modelling Group

Collections

St. Anthony Falls Laboratory

FlumeContinuous

FlumeBinary

Contributing

Contributions are very welcome, as are feature requests and suggestions.

If you have any questions, please contact our community.