Skip to content

Commit c007471

Browse files
thhothho
committed
change installation to renv workflow
1 parent d2120fe commit c007471

5 files changed

Lines changed: 168 additions & 14 deletions

File tree

‎README.md‎

Lines changed: 59 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# StaMPS-Visualizer
22

3-
![](https://github.com/thho/StaMPS_Visualizer/blob/master/stamps_visualizer21_preview.png "StaMPS-Visualizer 2.1 preview")
3+
![](https://github.com/thho/StaMPS_Visualizer/blob/master/preview30_map.png "StaMPS-Visualizer 3.0")
44

55
A Shiny application for visualizing DInSAR results processed by [StaMPS/MTI](https://homepages.see.leeds.ac.uk/~earahoo/stamps/).
66

@@ -10,28 +10,72 @@ Further discussion about the application can be found in ESA's [Step-Forum](http
1010

1111
An example of the app is currently available online, hosted with a free shinyapps.io account. Therefore it may be that the app is not accessible if all active hours per month are exhausted. To work with the app and adding your own data locally, download or clone the repo. [StaMPS-Visualizer example](https://thho.shinyapps.io/StaMPS_Visualizer/)
1212

13+
## Installation
14+
15+
You need R 3.6 or higher and RStudio
16+
17+
**Linux**
18+
19+
Tested on Ubuntu 20.04.1 LTS
20+
21+
```
22+
# first install gdal libraries
23+
sudo apt update
24+
sudo apt install gdal-bin libgdal-dev -y
25+
26+
# install R
27+
sudo apt update
28+
sudo apt install r-base gdebi-core -y
29+
30+
# install RStudio
31+
# download RStudio
32+
# https://rstudio.com/products/rstudio/download/#download
33+
34+
cd ~/Downloads
35+
sudo gdebi rstudio-1.3.1093-amd64.deb
36+
```
37+
38+
**Windows**
39+
40+
Download R https://cran.r-project.org/bin/windows/base/ and run the ```.exe```.
41+
42+
Download RStudio https://rstudio.com/products/rstudio/download/#download and run the ```.exe```
43+
44+
### Installation with renv (recommended)
45+
46+
Since version 3.0 StaMPS-Visualizer is managed as a *Rproject* with ```renv```. ```renv``` [is a tool to create reproducible environments of R packages](https://rstudio.github.io/renv/index.html).
47+
48+
* clone this repository
49+
* open the ```Stamps_Visualizer.Rproj``` file with Rstudio
50+
* run ```renv::restore()``` in the R Console to restore the environment
51+
* go to File --> Open File... and open ```ui.R```
52+
* click on **Run App** in the upper left panel in the upper right corner
53+
54+
### Manual installation of all packages
55+
1356
To run the application locally, following packages are requiered:
1457

1558
```{r install-packages eval=FALSE}
1659
install.packages("leaflet")
1760
install.packages("lubridate")
1861
install.packages("shiny")
62+
install.packages("shinycssloaders")
63+
install.packages("shinyalert")
1964
install.packages("colorRamps")
65+
install.packages("rgdal")
66+
install.packages("data.table")
2067
```
2168

2269
Copy paste the code to your R console, or run the R script *install_packages.R*
2370

24-
## Disclaimer
25-
26-
<br/>
71+
in order to start the Visualizer, open the ```ui.R``` script in RStudio and click on **Run App** in the upper left panel in the upper right corner.
2772

28-
*StaMPS-Visualizer* is a free application and comes with **absolutely no warranty**.
73+
## License
2974

75+
The StaMPS-Visualizer is licensed under a [creative commons attribution license](https://github.com/thho/StaMPS_Visualizer/blob/master/LICENSE.md)
3076

3177
## Citing the Application *StaMPS-Visualizer*
3278

33-
<br/>
34-
3579
The application is part of a [master thesis at the Department of Geography, Bonn University](https://doi.org/10.13140/RG.2.2.35085.59362). To cite the application, cite the thesis including the application:
3680

3781
Bibtex:
@@ -46,3 +90,11 @@ Bibtex:
4690
doi = {10.13140/RG.2.2.35085.59362}
4791
}
4892
```
93+
94+
## Disclaimer
95+
96+
<br/>
97+
98+
*StaMPS-Visualizer* is a free application and comes with **absolutely no warranty**.
99+
100+
<br/>

‎install_packages.R‎

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,11 @@
22
##install packages##
33
####################
44

5-
5+
install.packages("leaflet")
66
install.packages("lubridate")
77
install.packages("shiny")
8+
install.packages("shinycssloaders")
9+
install.packages("shinyalert")
810
install.packages("colorRamps")
9-
install.packages("leaflet")
10-
11-
####not necessary yet
1211
install.packages("rgdal")
13-
#for Ubuntu 16 and higher do
14-
#sudo apt-get install libudunits2-dev libgdal-dev libgeos-dev libproj-dev
15-
system("sudo -S apt-get -y install libudunits2-dev libgdal-dev libgeos-dev libproj-dev", input = "<password>")
12+
install.packages("data.table")

‎preview30_bplot.png‎

97.2 KB
Loading

‎preview30_map.png‎

959 KB
Loading

‎renv.lock‎

Lines changed: 105 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,13 @@
99
]
1010
},
1111
"Packages": {
12+
"BH": {
13+
"Package": "BH",
14+
"Version": "1.72.0-3",
15+
"Source": "Repository",
16+
"Repository": "CRAN",
17+
"Hash": "8f9ce74c6417d61f0782cbae5fd2b7b0"
18+
},
1219
"MASS": {
1320
"Package": "MASS",
1421
"Version": "7.3-51.5",
@@ -93,6 +100,13 @@
93100
"Repository": "CRAN",
94101
"Hash": "abea3384649ef37f60ef51ce002f3547"
95102
},
103+
"commonmark": {
104+
"Package": "commonmark",
105+
"Version": "1.7",
106+
"Source": "Repository",
107+
"Repository": "CRAN",
108+
"Hash": "0f22be39ec1d141fd03683c06f3a6e67"
109+
},
96110
"crayon": {
97111
"Package": "crayon",
98112
"Version": "1.3.4",
@@ -107,6 +121,13 @@
107121
"Repository": "CRAN",
108122
"Hash": "ae55f5d7c02f0ab43c58dd050694f2b4"
109123
},
124+
"data.table": {
125+
"Package": "data.table",
126+
"Version": "1.13.4",
127+
"Source": "Repository",
128+
"Repository": "CRAN",
129+
"Hash": "626afb25b020646f53105e6485e695c6"
130+
},
110131
"desc": {
111132
"Package": "desc",
112133
"Version": "1.2.0",
@@ -156,6 +177,13 @@
156177
"Repository": "CRAN",
157178
"Hash": "dad6793a5a1f73c8e91f1a1e3e834b05"
158179
},
180+
"fastmap": {
181+
"Package": "fastmap",
182+
"Version": "1.0.1",
183+
"Source": "Repository",
184+
"Repository": "CRAN",
185+
"Hash": "83ab58a0518afe3d17e41da01af13b60"
186+
},
159187
"generics": {
160188
"Package": "generics",
161189
"Version": "0.1.0",
@@ -205,6 +233,13 @@
205233
"Repository": "CRAN",
206234
"Hash": "0aaf56b7960bb066646e1868cadcaf07"
207235
},
236+
"httpuv": {
237+
"Package": "httpuv",
238+
"Version": "1.5.4",
239+
"Source": "Repository",
240+
"Repository": "CRAN",
241+
"Hash": "4e6dabb220b006ccdc3b3b5ff993b205"
242+
},
208243
"isoband": {
209244
"Package": "isoband",
210245
"Version": "0.2.2",
@@ -226,6 +261,13 @@
226261
"Repository": "CRAN",
227262
"Hash": "3d5108641f47470611a32d0bdf357a72"
228263
},
264+
"later": {
265+
"Package": "later",
266+
"Version": "1.1.0.1",
267+
"Source": "Repository",
268+
"Repository": "CRAN",
269+
"Hash": "d0a62b247165aabf397fded504660d8a"
270+
},
229271
"lattice": {
230272
"Package": "lattice",
231273
"Version": "0.20-40",
@@ -366,6 +408,13 @@
366408
"Repository": "CRAN",
367409
"Hash": "03446ed0b8129916f73676726cb3c48f"
368410
},
411+
"promises": {
412+
"Package": "promises",
413+
"Version": "1.1.1",
414+
"Source": "Repository",
415+
"Repository": "CRAN",
416+
"Hash": "a8730dcbdd19f9047774909f0ec214a4"
417+
},
369418
"ps": {
370419
"Package": "ps",
371420
"Version": "1.4.0",
@@ -394,6 +443,13 @@
394443
"Repository": "CRAN",
395444
"Hash": "398cc1ea892e1aade66d1ecbb2874d24"
396445
},
446+
"rgdal": {
447+
"Package": "rgdal",
448+
"Version": "1.5-18",
449+
"Source": "Repository",
450+
"Repository": "CRAN",
451+
"Hash": "402fc3169948d26581d585360825c65c"
452+
},
397453
"rlang": {
398454
"Package": "rlang",
399455
"Version": "0.4.8",
@@ -422,6 +478,41 @@
422478
"Repository": "CRAN",
423479
"Hash": "6f76f71042411426ec8df6c54f34e6dd"
424480
},
481+
"shiny": {
482+
"Package": "shiny",
483+
"Version": "1.5.0",
484+
"Source": "Repository",
485+
"Repository": "CRAN",
486+
"Hash": "ee4ed72d7a5047d9e73cf922ad66e9c9"
487+
},
488+
"shinyalert": {
489+
"Package": "shinyalert",
490+
"Version": "2.0.0",
491+
"Source": "Repository",
492+
"Repository": "CRAN",
493+
"Hash": "a130b62f6d5533fcc1cab6c8161358d9"
494+
},
495+
"shinycssloaders": {
496+
"Package": "shinycssloaders",
497+
"Version": "1.0.0",
498+
"Source": "Repository",
499+
"Repository": "CRAN",
500+
"Hash": "f39bb3c44a9b496723ec7e86f9a771d8"
501+
},
502+
"shinydashboard": {
503+
"Package": "shinydashboard",
504+
"Version": "0.7.1",
505+
"Source": "Repository",
506+
"Repository": "CRAN",
507+
"Hash": "133639dc106955eee4ffb8ec73edac37"
508+
},
509+
"sourcetools": {
510+
"Package": "sourcetools",
511+
"Version": "0.1.7",
512+
"Source": "Repository",
513+
"Repository": "CRAN",
514+
"Hash": "947e4e02a79effa5d512473e10f41797"
515+
},
425516
"sp": {
426517
"Package": "sp",
427518
"Version": "1.4-4",
@@ -450,6 +541,13 @@
450541
"Repository": "CRAN",
451542
"Hash": "4a5081acfb7b81a572e4384a7aaf2af1"
452543
},
544+
"uuid": {
545+
"Package": "uuid",
546+
"Version": "0.1-4",
547+
"Source": "Repository",
548+
"Repository": "CRAN",
549+
"Hash": "e4169eb989a5d03ccb6b628cad1b1b50"
550+
},
453551
"vctrs": {
454552
"Package": "vctrs",
455553
"Version": "0.3.4",
@@ -492,6 +590,13 @@
492590
"Repository": "CRAN",
493591
"Hash": "a42372606cb76f34da9d090326e9f955"
494592
},
593+
"xtable": {
594+
"Package": "xtable",
595+
"Version": "1.8-4",
596+
"Source": "Repository",
597+
"Repository": "CRAN",
598+
"Hash": "b8acdf8af494d9ec19ccb2481a9b11c2"
599+
},
495600
"yaml": {
496601
"Package": "yaml",
497602
"Version": "2.2.1",

0 commit comments

Comments
 (0)