Skip to content

Commit c240adc

Browse files
kasra-keshavarzkasra-keshavarz
authored
Soil class (#25)
* soil_classes dev version * adding soil-class dataset - temporary solution * updating the branch and soil_class.sh to accept additional argument --include-na * descriptions for modis and soil class updated - added info on the classification and accompanying .csv file * adding documentation * bumping version to 0.1.2
1 parent f131743 commit c240adc

File tree

8 files changed

+541
-376
lines changed

8 files changed

+541
-376
lines changed

‎README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,8 @@ Script options:
5555
|**3**|Soil Grids (v1) |Not Applicable (N/A) |4326 |10.1371/journal.pone.0169748 |[link](soil_grids) |
5656
|**4**|Landsat NALCMS |2010 and 2015 |4326 |10.3390/rs9111098 |[link](landsat) |
5757
|**5**|Global Depth to Bedrock |Not Applicable (N/A) | |10.1002/2016MS000686 |[link](depth_to_bedrock) |
58-
58+
|**6**|USDA Soil Class |Not Applicable (N/A) |4326 |10.4211/hs.1361509511e44adfba814f6950c6e742|[link](soil_class)|
59+
|**7**|Global Soil Dataset for Earth System Modelling (GSDE)|Not Applicable (N/A)|4326 |10.1002/2013MS000293 |[link](GSDE) |
5960

6061
# General Example
6162
As an example, follow the code block below. Please remember that you MUST have access to Graham cluster with Digital Alliance of Canada and have access to `MERIT-Hydro` dataset. Also, remember to generate a [Personal Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) with GitHub in advance. Enter the following codes in your Graham shell as a test case:

‎VERSION

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
0.1.1
1+
0.1.2

‎gsde/README.md

Lines changed: 143 additions & 374 deletions
Large diffs are not rendered by default.

‎modis/README.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,3 +76,30 @@ This dataset has 1 main variable that is described in the following table:
7676
|-------|---------------------------------------|---------------------------------------|---------------|
7777
|1 |`MCD12Q1.006` |Global land cover classes | |
7878

79+
# Other relevant information
80+
## Land Cover Types
81+
Below the land cover types for each values of the `.tif` files is detailed based on [1].
82+
83+
|Class Value (used in `gistool`) |Name |Land Cover Description |
84+
|---------------------------------------|---------------------------------------|---------------------------------------------------------------|
85+
|1 |Evergreen Needleleaf Forests |Dominated by evergreen conifer trees (canopy>2m). Tree cover>60%.|
86+
|2 |Evergreen Broadleaf Forests |Dominated by evergreen broadleaf and palmate trees (canopy >2m). Tree cover >60%.|
87+
|3 |Deciduous Needleleaf Forests |Dominated by deciduous needleleaf (larch) trees (canopy >2m). Tree cover >60%.|
88+
|4 |Deciduous Broadleaf Forests |Dominated by deciduous broadleaf trees (canopy >2m). Tree cover >60%.|
89+
|5 |Mixed Forests |Dominated by neither deciduous nor evergreen (40-60% of each) tree type (canopy >2m). Tree cover >60%.|
90+
|6 |Closed Shrublands |Dominated by woody perennials (1-2m height) >60% cover. |
91+
|7 |Open Shrublands |Dominated by woody perennials (1-2m height) 10-60% cover. |
92+
|8 |Woody Savannas |Tree cover 30-60% (canopy >2m). |
93+
|9 |Savannas |Tree cover 10-30% (canopy >2m). |
94+
|10 |Grasslands |Dominated by herbaceous annuals (<2m). |
95+
|11 |Permanent Wetlands |Permanently inundated lands with 30-60% water cover and >10% vegetated cover.|
96+
|12 |Croplands |At least 60% of area is cultivated cropland. |
97+
|13 |Urban and Built-up Lands |At least 30% impervious surface area including building materials, asphalt, and vehicles.|
98+
|14 |Cropland/Natural Vegetation Mosaics |Mosaics of small-scale cultivation 40-60% with natural tree, shrub, or herbaceous vegetation.|
99+
|15 |Permanent Snow and Ice |At least 60% of area is covered by snow and ice for at least 10 months of the year.|
100+
|16 |Barren |At least 60% of area is non-vegetated barren (sand, rock, soil) areas with less than 10% veg- etation.|
101+
|17 |Water Bodies |At least 60% of area is covered by permanent wa- ter bodies. |
102+
|255 |Unclassified |Has not received a map label because of missing inputs. |
103+
104+
Also, the details of the above table has been included in the following files: [modis_classes.csv](./modis_classes.csv).
105+

‎modis/modis_classes.csv

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
1,Evergreen Needleleaf Forests
2+
2,Evergreen Broadleaf Forests
3+
3,Deciduous Needleleaf Forests
4+
4,Deciduous Broadleaf Forests
5+
5,Mixed Forests
6+
6,Closed Shrublands
7+
7,Open Shrublands
8+
8,Woody Savannas
9+
9,Savannas
10+
10,Grasslands
11+
11,Permanent Wetlands
12+
12,Croplands
13+
13,Urban and Built-up Lands
14+
14,Cropland/Natural Vegetation Mosaics
15+
15,Permanent Snow and Ice
16+
16,Barren
17+
17,Water Bodies
18+
18,Unclassified

‎soil_class/README.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# `soil_class` Geospatial Dataset
2+
In this file, the necessary technical details of the dataset is explained.
3+
4+
## Location of the `soil_class` Dataset Files
5+
The `soil_class` geospatial dataset files are located under the following directory accessible from Digital Research Alliance of Canada (DRA, formerly Compute Canada) Graham cluster:
6+
7+
```console
8+
/project/6008034/wknoben/CWARHM_data/domain_NorthAmerica/parameters/soilclass/2_soil_classes_domain/
9+
```
10+
11+
And the structure of the files is as following:
12+
13+
```console
14+
/project/6008034/wknoben/CWARHM_data/domain_NorthAmerica/parameters/soilclass/2_soil_classes_domain/
15+
└── soil_classes.tif
16+
```
17+
18+
## Spatial and Temporal Extents
19+
The spatial extent of this dataset covers longitudes from approximately `-180` to `+180` degress and latitudes from approximately `-90` to `+90` degress. This dataset is static and does not vary with time.
20+
21+
## Dataset Variables
22+
This variables of this dataset are detailed in the table below:
23+
24+
|# |Variable Name (used in `gistool`) |Description |Comments |
25+
|-------|---------------------------------------|---------------------------------------|---------------|
26+
|1 |soil-class |USDA soil class |[link](https://www.hydroshare.org/resource/1361509511e44adfba814f6950c6e742/)|
27+
28+
29+
# Other relevant information
30+
## Land Cover Types
31+
Below the land cover types for each values of the `.tif` files is detailed based on [1].
32+
33+
|Class Value (used in `gistool`) |Soil Type |
34+
|---------------------------------------|-------------------------------|
35+
|0 |no class assigned |
36+
|1 |Clay |
37+
|2 |Clay loam |
38+
|3 |Loam |
39+
|4 |Loamy sand |
40+
|5 |Sand |
41+
|6 |Sandy clay |
42+
|7 |Sandy clay loam |
43+
|8 |Sandy loam |
44+
|9 |Silt |
45+
|10 |Silty Clay |
46+
|11 |Silty clay loam |
47+
|12 |Silt loam |
48+
49+
Also, the details of the above table has been included in the following files: [soil_classes.csv](./soil_classes.csv).
50+

0 commit comments

Comments
 (0)