semvec/pypi-packages huggingface dataset:
geogems 0.1.4.3
GEMS Geomodelling package
License: MIT
Requires Python: >=2.7

![mit license](https://img.shields.io/github/license/t1nak/geogems?logo=geogems)

# GEMS Friction Surface pipeline 
Some helper functions and classes for GEMS fricton surface modelling pipeline.

* [Examples (in jupyter notebook)](#Examples-%28run-in-jupyter-notebook%29)

	* [1. Start geogems and load images](#first-bullet)
        * [Show wet and dry season from sentinel 2 images for Malawi](#firstb-bullet)
            * [Dry season](#Dry-season)
            * [Wet season](#Wet--season)
	* [2. Load landcover satellite images](#second-bullet)



# Examples (jupyter notebook)
## 1. Start geogems and load images <a class="anchor" id="first-bullet"></a>
### Show wet and dry season from [sentinel 2](https://eos.com/sentinel-2/) images for Malawi <a class="anchor" id="firstb-bullet"></a>
```
import ee
import geogems  
# ee.Authenticate() #uncomment for first run to authorise with google 
ee.Initialize()

area= 'Malawi'
lat = -12.8018637
lon = 33.4752805

#time series 
dry_season = ('2019-05-01' , '2019-10-30') 
wet_season = ('2019-11-01', '2020-04-30')

#load the earth engine helper functions
geography_object = geogems.map.ee_helper()
#load the map 
map_malawai=geography_object.show(lat, lon, 6.5)

#get earth engines objects (bounds and sentinet images)
bounds=geography_object.get_country_polygon_by_name(ee, area) #pass in country name
image_dry,image_wet,trueColor_palette= geography_object.\
                                        get_sentinel_dry_wet_season(dry_season,wet_season ,ee,bounds)
```
In the next cell, type the object name to load map. 

```
map_malawai
```
Next, add Sentinel images
```
#Add image
map_malawai.addLayer(image_dry, trueColor_palette, '2019 Dry season true color');
map_malawai.addLayerControl()  
```

Output:
### Dry season 
![dry season malawi](https://github.com/t1nak/geogems/blob/main/pics/sentinel-dry%20season.png?raw=true)


### Wet  season 
![wet season malawi](https://github.com/t1nak/geogems/blob/main/pics/sentinel_wet_season.png?raw=true)

## 2. Get Modis landcover images <a class="anchor" id="second-bullet"></a>


```
#load images 
maplc_malawai=geography_object.show(lat, lon, 6.5)
image_lc,legend= geography_object.get_Modis_MCD12Q1_landcover_2013_01_01(ee,bounds)
```

```
#show map
maplc_malawai
```
```
#add modis images
maplc_malawai.addLayer(image_lc, {}, 'MODIS Land Cover')
maplc_malawai.add_legend(legend_title="MODIS Global Land Cover", legend_dict=legend)
 
```
Output:
![modis lc malawi](https://github.com/t1nak/geogems/blob/main/pics/modis_lc.png?raw=true)



## Dependencies 

google earth engine, pydrive