-
Notifications
You must be signed in to change notification settings - Fork 4
/
index.tex
13979 lines (12474 loc) · 681 KB
/
index.tex
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
% Options for packages loaded elsewhere
\PassOptionsToPackage{unicode}{hyperref}
\PassOptionsToPackage{hyphens}{url}
\PassOptionsToPackage{dvipsnames,svgnames,x11names}{xcolor}
%
\documentclass[
letterpaper,
DIV=11,
numbers=noendperiod]{scrreprt}
\usepackage{amsmath,amssymb}
\usepackage{iftex}
\ifPDFTeX
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{textcomp} % provide euro and other symbols
\else % if luatex or xetex
\usepackage{unicode-math}
\defaultfontfeatures{Scale=MatchLowercase}
\defaultfontfeatures[\rmfamily]{Ligatures=TeX,Scale=1}
\fi
\usepackage{lmodern}
\ifPDFTeX\else
% xetex/luatex font selection
\fi
% Use upquote if available, for straight quotes in verbatim environments
\IfFileExists{upquote.sty}{\usepackage{upquote}}{}
\IfFileExists{microtype.sty}{% use microtype if available
\usepackage[]{microtype}
\UseMicrotypeSet[protrusion]{basicmath} % disable protrusion for tt fonts
}{}
\makeatletter
\@ifundefined{KOMAClassName}{% if non-KOMA class
\IfFileExists{parskip.sty}{%
\usepackage{parskip}
}{% else
\setlength{\parindent}{0pt}
\setlength{\parskip}{6pt plus 2pt minus 1pt}}
}{% if KOMA class
\KOMAoptions{parskip=half}}
\makeatother
\usepackage{xcolor}
\setlength{\emergencystretch}{3em} % prevent overfull lines
\setcounter{secnumdepth}{5}
% Make \paragraph and \subparagraph free-standing
\ifx\paragraph\undefined\else
\let\oldparagraph\paragraph
\renewcommand{\paragraph}[1]{\oldparagraph{#1}\mbox{}}
\fi
\ifx\subparagraph\undefined\else
\let\oldsubparagraph\subparagraph
\renewcommand{\subparagraph}[1]{\oldsubparagraph{#1}\mbox{}}
\fi
\usepackage{color}
\usepackage{fancyvrb}
\newcommand{\VerbBar}{|}
\newcommand{\VERB}{\Verb[commandchars=\\\{\}]}
\DefineVerbatimEnvironment{Highlighting}{Verbatim}{commandchars=\\\{\}}
% Add ',fontsize=\small' for more characters per line
\usepackage{framed}
\definecolor{shadecolor}{RGB}{241,243,245}
\newenvironment{Shaded}{\begin{snugshade}}{\end{snugshade}}
\newcommand{\AlertTok}[1]{\textcolor[rgb]{0.68,0.00,0.00}{#1}}
\newcommand{\AnnotationTok}[1]{\textcolor[rgb]{0.37,0.37,0.37}{#1}}
\newcommand{\AttributeTok}[1]{\textcolor[rgb]{0.40,0.45,0.13}{#1}}
\newcommand{\BaseNTok}[1]{\textcolor[rgb]{0.68,0.00,0.00}{#1}}
\newcommand{\BuiltInTok}[1]{\textcolor[rgb]{0.00,0.23,0.31}{#1}}
\newcommand{\CharTok}[1]{\textcolor[rgb]{0.13,0.47,0.30}{#1}}
\newcommand{\CommentTok}[1]{\textcolor[rgb]{0.37,0.37,0.37}{#1}}
\newcommand{\CommentVarTok}[1]{\textcolor[rgb]{0.37,0.37,0.37}{\textit{#1}}}
\newcommand{\ConstantTok}[1]{\textcolor[rgb]{0.56,0.35,0.01}{#1}}
\newcommand{\ControlFlowTok}[1]{\textcolor[rgb]{0.00,0.23,0.31}{#1}}
\newcommand{\DataTypeTok}[1]{\textcolor[rgb]{0.68,0.00,0.00}{#1}}
\newcommand{\DecValTok}[1]{\textcolor[rgb]{0.68,0.00,0.00}{#1}}
\newcommand{\DocumentationTok}[1]{\textcolor[rgb]{0.37,0.37,0.37}{\textit{#1}}}
\newcommand{\ErrorTok}[1]{\textcolor[rgb]{0.68,0.00,0.00}{#1}}
\newcommand{\ExtensionTok}[1]{\textcolor[rgb]{0.00,0.23,0.31}{#1}}
\newcommand{\FloatTok}[1]{\textcolor[rgb]{0.68,0.00,0.00}{#1}}
\newcommand{\FunctionTok}[1]{\textcolor[rgb]{0.28,0.35,0.67}{#1}}
\newcommand{\ImportTok}[1]{\textcolor[rgb]{0.00,0.46,0.62}{#1}}
\newcommand{\InformationTok}[1]{\textcolor[rgb]{0.37,0.37,0.37}{#1}}
\newcommand{\KeywordTok}[1]{\textcolor[rgb]{0.00,0.23,0.31}{#1}}
\newcommand{\NormalTok}[1]{\textcolor[rgb]{0.00,0.23,0.31}{#1}}
\newcommand{\OperatorTok}[1]{\textcolor[rgb]{0.37,0.37,0.37}{#1}}
\newcommand{\OtherTok}[1]{\textcolor[rgb]{0.00,0.23,0.31}{#1}}
\newcommand{\PreprocessorTok}[1]{\textcolor[rgb]{0.68,0.00,0.00}{#1}}
\newcommand{\RegionMarkerTok}[1]{\textcolor[rgb]{0.00,0.23,0.31}{#1}}
\newcommand{\SpecialCharTok}[1]{\textcolor[rgb]{0.37,0.37,0.37}{#1}}
\newcommand{\SpecialStringTok}[1]{\textcolor[rgb]{0.13,0.47,0.30}{#1}}
\newcommand{\StringTok}[1]{\textcolor[rgb]{0.13,0.47,0.30}{#1}}
\newcommand{\VariableTok}[1]{\textcolor[rgb]{0.07,0.07,0.07}{#1}}
\newcommand{\VerbatimStringTok}[1]{\textcolor[rgb]{0.13,0.47,0.30}{#1}}
\newcommand{\WarningTok}[1]{\textcolor[rgb]{0.37,0.37,0.37}{\textit{#1}}}
\providecommand{\tightlist}{%
\setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}\usepackage{longtable,booktabs,array}
\usepackage{multirow}
\usepackage{calc} % for calculating minipage widths
% Correct order of tables after \paragraph or \subparagraph
\usepackage{etoolbox}
\makeatletter
\patchcmd\longtable{\par}{\if@noskipsec\mbox{}\fi\par}{}{}
\makeatother
% Allow footnotes in longtable head/foot
\IfFileExists{footnotehyper.sty}{\usepackage{footnotehyper}}{\usepackage{footnote}}
\makesavenoteenv{longtable}
\usepackage{graphicx}
\makeatletter
\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth\else\Gin@nat@width\fi}
\def\maxheight{\ifdim\Gin@nat@height>\textheight\textheight\else\Gin@nat@height\fi}
\makeatother
% Scale images if necessary, so that they will not overflow the page
% margins by default, and it is still possible to overwrite the defaults
% using explicit options in \includegraphics[width, height, ...]{}
\setkeys{Gin}{width=\maxwidth,height=\maxheight,keepaspectratio}
% Set default figure placement to htbp
\makeatletter
\def\fps@figure{htbp}
\makeatother
\KOMAoption{captions}{tableheading}
\makeatletter
\makeatother
\makeatletter
\@ifpackageloaded{bookmark}{}{\usepackage{bookmark}}
\makeatother
\makeatletter
\@ifpackageloaded{caption}{}{\usepackage{caption}}
\AtBeginDocument{%
\ifdefined\contentsname
\renewcommand*\contentsname{Table of contents}
\else
\newcommand\contentsname{Table of contents}
\fi
\ifdefined\listfigurename
\renewcommand*\listfigurename{List of Figures}
\else
\newcommand\listfigurename{List of Figures}
\fi
\ifdefined\listtablename
\renewcommand*\listtablename{List of Tables}
\else
\newcommand\listtablename{List of Tables}
\fi
\ifdefined\figurename
\renewcommand*\figurename{Figure}
\else
\newcommand\figurename{Figure}
\fi
\ifdefined\tablename
\renewcommand*\tablename{Table}
\else
\newcommand\tablename{Table}
\fi
}
\@ifpackageloaded{float}{}{\usepackage{float}}
\floatstyle{ruled}
\@ifundefined{c@chapter}{\newfloat{codelisting}{h}{lop}}{\newfloat{codelisting}{h}{lop}[chapter]}
\floatname{codelisting}{Listing}
\newcommand*\listoflistings{\listof{codelisting}{List of Listings}}
\makeatother
\makeatletter
\@ifpackageloaded{caption}{}{\usepackage{caption}}
\@ifpackageloaded{subcaption}{}{\usepackage{subcaption}}
\makeatother
\makeatletter
\@ifpackageloaded{tcolorbox}{}{\usepackage[skins,breakable]{tcolorbox}}
\makeatother
\makeatletter
\@ifundefined{shadecolor}{\definecolor{shadecolor}{rgb}{.97, .97, .97}}
\makeatother
\makeatletter
\makeatother
\makeatletter
\makeatother
\ifLuaTeX
\usepackage{selnolig} % disable illegal ligatures
\fi
\IfFileExists{bookmark.sty}{\usepackage{bookmark}}{\usepackage{hyperref}}
\IfFileExists{xurl.sty}{\usepackage{xurl}}{} % add URL line breaks if available
\urlstyle{same} % disable monospaced font for URLs
\hypersetup{
pdftitle={Web Mapping and Geovisualisation},
pdfauthor={Gabriele Filomena and Elisabetta Pietrostefani},
colorlinks=true,
linkcolor={blue},
filecolor={Maroon},
citecolor={Blue},
urlcolor={Blue},
pdfcreator={LaTeX via pandoc}}
\title{Web Mapping and Geovisualisation}
\author{Gabriele Filomena and Elisabetta Pietrostefani}
\date{2024-03-20}
\begin{document}
\maketitle
\ifdefined\Shaded\renewenvironment{Shaded}{\begin{tcolorbox}[frame hidden, boxrule=0pt, interior hidden, borderline west={3pt}{0pt}{shadecolor}, sharp corners, enhanced, breakable]}{\end{tcolorbox}}\fi
\renewcommand*\contentsname{Table of contents}
{
\hypersetup{linkcolor=}
\setcounter{tocdepth}{2}
\tableofcontents
}
\bookmarksetup{startatroot}
\hypertarget{welcome}{%
\chapter*{Welcome}\label{welcome}}
\addcontentsline{toc}{chapter}{Welcome}
\markboth{Welcome}{Welcome}
This is the website for ``Web Mapping and Geovisualisation'' (module
\textbf{ENVS456}) at the University of Liverpool. This course is
designed and delivered by Dr.~Gabriele Filomena and Dr.~Elisabetta
Pietrostefani from the Geographic Data Science Lab at the University of
Liverpool, United Kingdom. The module has two main aims. It seeks to
provide hands-on experience and training in:
\begin{itemize}
\tightlist
\item
The design and generation of web-based mapping and geographical
information tools.
\item
The use of software to access, analyse and visualize web-based
geographical information.
\end{itemize}
The website is \textbf{free to use} and is licensed under the
\href{https://creativecommons.org/licenses/by-nc-nd/4.0/}{Attribution-NonCommercial-NoDerivatives
4.0 International}. A compilation of this web course is hosted as a
GitHub repository that you can access:
\begin{itemize}
\tightlist
\item
As an \href{https://gdsl-ul.github.io/wma}{html website}.
\item
As a \href{https://github.com/GDSL-UL/wma}{GitHub repository}.
\end{itemize}
\hypertarget{contact}{%
\section*{Contact}\label{contact}}
\addcontentsline{toc}{section}{Contact}
\markright{Contact}
\begin{quote}
Gabriele Filomena - gfilo {[}at{]} liverpool.ac.uk Lecturer in
Geographic Data Science Office 1xx, Roxby Building, University of
Liverpool - 74 Bedford St S, Liverpool, L69 7ZT, United Kingdom.
\end{quote}
\begin{quote}
Elisabetta Pietrostefani - e.pietrostefani {[}at{]} liverpool.ac.uk
Lecturer in Geographic Data Science Office 6xx, Roxby Building,
University of Liverpool - 74 Bedford St S, Liverpool, L69 7ZT, United
Kingdom.
\end{quote}
\bookmarksetup{startatroot}
\hypertarget{syllabus}{%
\chapter*{Syllabus}\label{syllabus}}
\addcontentsline{toc}{chapter}{Syllabus}
\markboth{Syllabus}{Syllabus}
\textbf{Week 1}
\begin{itemize}
\item
Lecture: Introduction to the module
\item
Lab: Powerful examples and Python Refresher
\end{itemize}
\textbf{Week 2}
\begin{itemize}
\item
Lecture: Geovisualisation: Design Principles and Statistical
Visualisation
\item
Lab: Static Maps
\end{itemize}
\textbf{Week 3}
\begin{itemize}
\item
Lecture: The Web's Architecture
\item
Lab: Web Architectures and APIs
\end{itemize}
\textbf{Week 4}
\begin{itemize}
\item
Lecture: Data architechtures \& formats
\item
Lab: Data architechtures \& Tiles
\end{itemize}
\textbf{Week 5}
\begin{itemize}
\item
Lecture: Interactive Maps
\item
Lab: Interactive Maps
\end{itemize}
\textbf{Week 6}
\begin{itemize}
\item
Lecture \& Lab: Q\&A \& Assignment I Clinic
\item
\textbf{Assignment I Due}
\end{itemize}
\textbf{Week 7}
\begin{itemize}
\item
Lecture: OpenStreetMap Data \& Spatial Network
\item
Lab: Retrieving Data From OpenStreetMap
\end{itemize}
\textbf{Week 8}
\begin{itemize}
\item
Lecture: Dashboards
\item
Lab: Designing Dashboard for Geovisualisation
\end{itemize}
\textbf{Week 9}
\begin{itemize}
\item
Lecture: Advanced Tools
\item
Lab
\end{itemize}
\textbf{Week 10}
\begin{itemize}
\tightlist
\item
Lecture \& Lab: Review \& Assignment II clinic
\item
\textbf{Assignment II Due (Week 11)}
\end{itemize}
\bookmarksetup{startatroot}
\hypertarget{overview}{%
\chapter*{Overview}\label{overview}}
\addcontentsline{toc}{chapter}{Overview}
\markboth{Overview}{Overview}
\hypertarget{aims}{%
\section*{Aims}\label{aims}}
\addcontentsline{toc}{section}{Aims}
\markright{Aims}
This module aims to provide hands-on experience and training in: - The
design and generation of (good looking) web-based mapping and
geographical information tools. - The use of software to access, analyse
and visualize web-based geographical information.
\hypertarget{learning-outcomes}{%
\section*{Learning Outcomes}\label{learning-outcomes}}
\addcontentsline{toc}{section}{Learning Outcomes}
\markright{Learning Outcomes}
By the end of the module, students should be able to:
\begin{enumerate}
\def\labelenumi{(\arabic{enumi})}
\setcounter{enumi}{1}
\tightlist
\item
Visualise and represent geo-data through static and dynamic maps.
\item
Recognise and describe the component of web based mapping
infrastructure.
\item
Collect Web-based data.
\item
Generate interactive maps and dashboards.
\item
Understand basic concepts of spatial network analysis.
\item
Manipulate geo-data through scripting in Python.
\end{enumerate}
\hypertarget{feedback}{%
\section*{Feedback}\label{feedback}}
\addcontentsline{toc}{section}{Feedback}
\markright{Feedback}
\href{https://gdsl-ul.github.io/wma/assess.html}{\emph{Formal
assessment}}. Two pieces of coursework (50\%/50\%). Equivalent to 2,500
words each
\emph{Verbal face-to-face feedback}. Immediate face-to-face feedback
will be provided during computer, discussion and clinic sessions in
interaction with staff. This will take place in all live sessions during
the semester. \emph{Teams Forum}. Asynchronous written feedback will be
provided via Teams. Students are encouraged to contribute by asking and
answering questions relating to the module content. Staff will monitor
the forum Monday to Friday 9am-5pm, but it will be open to students to
make contributions at all times. Response time will vary depending on
the complexity of the question and staff availability.
\bookmarksetup{startatroot}
\hypertarget{assessments}{%
\chapter*{Assessments}\label{assessments}}
\addcontentsline{toc}{chapter}{Assessments}
\markboth{Assessments}{Assessments}
\hypertarget{assignment-i}{%
\section*{Assignment I}\label{assignment-i}}
\addcontentsline{toc}{section}{Assignment I}
\markright{Assignment I}
\begin{itemize}
\tightlist
\item
\textbf{Title:} Exporing APIs and Interactive Maps in Python.
\item
\textbf{Type:} Coursework.
\item
\textbf{Due: Thursday March 7th, Week 6}.
\item
50\% of the final mark.
\item
Electronic submission only.
\end{itemize}
In this assessment, you will have the opportunity to explore different
sources and combine them in a map that can be explored interactively
throbh a web browser. \textbf{The assignment aims to evaluate your
knowledge and aptitude in the following areas}:
\begin{itemize}
\tightlist
\item
Understanding of core ``backend'' concepts in web mapping such as
tilesets, client-server architecture, and APIs.
\item
Ability to use the web as a resource for original data.
\item
Design skills to represent effectively a diverse set of geospatial
data in a web map.
\end{itemize}
\hypertarget{design-data-pan-assemblage.}{%
\subsection*{Design, data pan
assemblage.}\label{design-data-pan-assemblage.}}
\addcontentsline{toc}{subsection}{Design, data pan assemblage.}
This assignment requires you to source data from the web in different
formats, assemble them, and document the process. To be successful, you
will need to demonstrate your understanding not only of the technical
aspects involved in the process, but also of the conceptual notions that
underpin them. Below are described the required components for your
submission.
\begin{enumerate}
\def\labelenumi{\arabic{enumi}.}
\tightlist
\item
\textbf{Data}. Draft a list of potential spatial datasets that you can
access by developing a simple API in Python. The data should contain
spatial information or should be easy to link to other existing
spatial data sources (e.g.~combining different datasets). While you
can make use of available datasets, \textbf{you are required to
demonstrate the ability to develop your own API request}. Once you
know which datasets you are interested and able to obtain, think about
what data/variables deserve consideration and how they could be
presented.
\item
\textbf{Design}. Start by designing a map that represents the spatial
units of the dataset (e.g.~buildings, train stations, cities, etc.).
Use \texttt{folium} to incorporate initial basic interactivity. At
this point, check on your ideas with the module teachers, who will be
able to assess whether potential problems may arise from your choices.
Move to the incorporation of data, both for categorical (if
appropriate) and numerical variables, and consider how to represent it
through the map. This stage should draw some inspiration from the
first weeks of the course, where we looked at examples of web maps and
spent time discussing what made them good and why.
\item
\textbf{Assemblage}. Embellish your map, consider the usage of widgets
for facilitating the exploration of the dataset. Play and choose one
of the available tilesets. Conisder creating your own in
\texttt{Mapbox}. Pay attention to the design aspects involved in this
step too. For example, what is the extent of your map (not necessarily
the extent of each of your data)? What are the zoom levels your map
will allow? Do you have the same ``map'' for every zoom level? These
are questions you will have to ask (and answer!) yourself to complete
this stage successfully.
\end{enumerate}
Once you have developed your API and created the interactive map, you
will need to present it. An important aspect of this stage is that it is
not really the code/map you need to present, but the \emph{process} of
creation you have followed and the \emph{design} choices you have made
that should go into the text. Additionally, you will need to provide
evidence that you understand the concepts behind some of the
technologies you have used.
\hypertarget{in-a-nutshell-assignment-1-should-contain}{%
\subsection*{In a Nutshell, Assignment 1 should
contain:}\label{in-a-nutshell-assignment-1-should-contain}}
\addcontentsline{toc}{subsection}{In a Nutshell, Assignment 1 should
contain:}
\textbf{Code}
\begin{itemize}
\tightlist
\item
Introductory Static Maps (2 to 3), presenting the topic and the
geographic context.
\item
An API request written by your own.
\item
All the necessary steps for making your API work and for data
cleaning/exploration.
\item
An interactive final map (and intermediate ones, if necessary, to
present the final development). This should be fed with data obtained
through the API request.
\end{itemize}
Up to \textbf{1,000 words} - distributed across the notebook, and
included as Markdown Cells - referring to:
\textbf{Map brief:}
\begin{verbatim}
- About 250 words introducing the map(s). This should cover what it tries to represent (what is it about?) and the choices you have made along the way to take that idea into fruition.
- About 250 words discussing and motivating the sources of data you have used. Here you should engage not only with what data you are using but why and what they bring to the map. Everything should be in the map for a reason, make sure to spell it out clearly.
\end{verbatim}
\textbf{Conceptual background:}
\begin{verbatim}
- About 250 words with your description of what your API is, how it works and how it has made your map possible.
- About 250 words with your description of how your final interactive map works, its components and your design ideas.
\end{verbatim}
\hypertarget{submission}{%
\subsection*{Submission}\label{submission}}
\addcontentsline{toc}{subsection}{Submission}
You will submit through Canvas a \texttt{.html} file obtained from a
Python \texttt{.ipynb} Jupyter Notebook file. To do so, in your
\texttt{.ipynb} file, follow these steps: \texttt{File} --\textgreater{}
\texttt{Save\ and\ Export\ as..} --\textgreater{} \texttt{HTML}. Prior
to this step, the notebook needs to be rendered (i.e.~all the cells
should be executed). Other file formats will not be accepted.
\hypertarget{evaulation}{%
\subsection*{Evaulation}\label{evaulation}}
\addcontentsline{toc}{subsection}{Evaulation}
The assignment will be evaluated based on four main pillars, on which
you will have to be successful to achieve a good mark:
\begin{enumerate}
\def\labelenumi{\arabic{enumi}.}
\tightlist
\item
\textbf{Map design abilities.} This includes ideas that were discussed
in week 2, 3 and 4.
\item
\textbf{Technical skills}. This includes your ability to master
technologies that allow you to create a compelling map, but also to
access interesting and sophiticated data sources.
\item
\textbf{Overall narrative}. This assesses your aptitude to introduce,
motivate and justify your map, as well as you ability to bring each
component of the assignment into a coherent whole that ``fits
together''.
\item
\textbf{Conceptual understanding of key technologies} presented in the
course, in particular as regards the usage of APIs.
\end{enumerate}
\hypertarget{how-is-this-assignment-useful}{%
\subsection*{\texorpdfstring{\emph{How is this assignment
useful?}}{How is this assignment useful?}}\label{how-is-this-assignment-useful}}
\addcontentsline{toc}{subsection}{\emph{How is this assignment useful?}}
This assessment includes several elements that will help you improve
critical aspects of your web mapping skills:
\begin{itemize}
\tightlist
\item
\textbf{Design}: this is not about making maps, this is about making
good maps. And behind every good map there is a set of conscious
choices that you will have to think throug to be successful (what map?
what data? how to present the data? etc.).
\item
\textbf{Technology}: at the end of the day, building good web maps
requires solid understanding of current technology that goes beyond
what the average person can be expected to know. In this assignment,
you will need to demonstrate you are proficient in a series of tasks
manipulating geospatial data in a web environment.
\item
\textbf{Presentation}: in many real-world contexts, your work is as
good as it can come across to the audience it is intended to. This
means that it is vital to be able to communicate not only what you are
doing but why and on what building blocks it is based on.
\end{itemize}
\hypertarget{assignment-ii}{%
\section*{Assignment II}\label{assignment-ii}}
\addcontentsline{toc}{section}{Assignment II}
\markright{Assignment II}
\begin{itemize}
\tightlist
\item
\textbf{Title:} \emph{A dashboard that explores a Spatial Dataset}.
\item
\textbf{Type:} Coursework.
\item
\textbf{Due: Thursday May 2nd, Week 11}.
\item
50\% of the final mark.
\item
Electronic submission only.
\end{itemize}
This assignment requires you to build a dashboard for a \textbf{spatial
data set of your choice}. To be successful, you will need to demonstrate
your understanding not only of technical elements, but of the design
process required to create a product that can communicate complex ideas
effectively. There are three core building blocks you will have to
assemble to build your dashboard: the main maps(s), base map, and
widgets.
\begin{enumerate}
\def\labelenumi{\arabic{enumi}.}
\tightlist
\item
\textbf{The main map(s)}. Import your data and start building a
dashboard with \texttt{panel}. Think about what you want to show, how,
which interactive elements you will allow the user to access and how
they will let them modify the experience of your dashboard. It goes
without saying that the dashbord should include interactive map(s),
besides allowing the user to play with the dataset.
\item
\textbf{The basemap}. Design your own basemap using \texttt{Mapbox} or
through scripting (e.g.~assembling a basemap with OpenStreetMap
features in a unique layer). Think about the data in the background,
which colors, the zoom levels that will be allowed, and how it all
comes together to create a backdrop for your main message that is
conducent to the experience you want to create. Use the basemap to
enhance the visualisation experience of the user.
\item
\textbf{Additional widgets}. One of the advantages of dashboards in
comparison to standard web maps is that they allow to bring elements
of analysis to a more finished product. Think about what you want your
users to be able to analyse, why, and how that will modify the main
map.
\end{enumerate}
\hypertarget{submission-1}{%
\subsection*{Submission}\label{submission-1}}
\addcontentsline{toc}{subsection}{Submission}
You will submit through Canvas a \texttt{.html} file obtained from a
Python \texttt{.ipynb} Jupyter Notebook file. To do so, in your
\texttt{.ipynb} file, follow these steps: \texttt{File} --\textgreater{}
\texttt{Save\ and\ Export\ as..} --\textgreater{} \texttt{HTML}. Prior
to this step, the notebook needs to be rendered (i.e.~all the cells
should be executed). Other file formats will not be accepted. Besides
the necessary code, the report should include up to \textbf{1,000} words
and the following:
\begin{itemize}
\tightlist
\item
About 250 words for the overall idea of the dashboard. What do you
want to communicate? What is the story you want to tell?
\item
About 250 words for the data used. Which datasets are you using? Why?
What new information do they bring and how they complement each other?
\item
About 250 words to describe your design choices in the layers
presented (e.g.~choropleths).
\item
About 250 words to describe your design choices around interactivity,
including both cartographic elements (e.g.~zooming, panning) as well
as additional interactivity built around components such as widgets.
\end{itemize}
\hypertarget{evaluation}{%
\subsection*{Evaluation}\label{evaluation}}
\addcontentsline{toc}{subsection}{Evaluation}
The assignment will be evaluated based on four main pillars, on which
you will have to be successful to achieve a good mark:
\begin{enumerate}
\def\labelenumi{\arabic{enumi}.}
\tightlist
\item
\emph{Overall design of the experience.} It is very important you
think through every step of preparing this assignment as if it was
part of something bigger towards which it contributes. Because that is
exactly what it is. Everything should have a reason to be there, and
every aspect of the dashboard should be connected to each other
following a common thread. And, of course, make this connection and
holistic approach come alive in your report.
\item
\emph{Map design}. Critically introduce every aspect you have thought
about when designing the maps, and explicitly connect it to the
overall aim of the dashboard. Be clear in your descriptions and
critical in how you engage every design choice.
\item
\emph{Interactivity design.} Your dashboard should use interactivity
when necessary to deliver a more compelling and fuller experience that
better gets your message across. Be sure to clearly lay out in your
report which elements are used and why.
\item
\emph{Narrative around the description of the process.} Finally, the
final mark will also take into account not only how good your
dashboard is, but how well you are able to introduce it. Start with
the key goals, and then unpack every element in an integrated and
compelling way.
\end{enumerate}
\hypertarget{how-is-this-assignment-useful-1}{%
\subsection*{\texorpdfstring{\emph{How is this assignment
useful?}}{How is this assignment useful?}}\label{how-is-this-assignment-useful-1}}
\addcontentsline{toc}{subsection}{\emph{How is this assignment useful?}}
This assignment combines several elements that will help you improve
critical aspects of web mapping:
\begin{itemize}
\tightlist
\item
\emph{Design}: this is not about making maps, this is about making
good maps. And behind every good map there is a set of conscious
choices that you will have to think through to be successful (what
map? what data? how to present the data? etc.).
\item
\emph{Technology}: at the end of the day, building good web maps
requires familiarity with the state-of-the-art in terms of web mapping
tools. In this assignment, you will need to demonstrate your mastering
of some of the key tools that are leading both industry and academia.
\item
\emph{Presentation}: in many real-world contexts, your work is as good
as it can come across to the audience it is intended to. This means
that it is vital to be able to communicate not only what you are doing
but why and on what building blocks it is based on.
\end{itemize}
\hypertarget{marking-criteria}{%
\section*{Marking Criteria}\label{marking-criteria}}
\addcontentsline{toc}{section}{Marking Criteria}
\markright{Marking Criteria}
This course follows the standard marking criteria (the general ones and
those relating to GIS assignments in particular) set by the School of
Environmental Sciences. Please make sure to check the student handbook
and familiarise with them. In addition to these generic criteria, the
following specific criteria will be used in cases where computer code is
part of the work being assessed:
\begin{itemize}
\tightlist
\item
0-15: the code does not run and there is no documentation to follow
it.
\item
16-39: the code does not run, or runs but it does not produce the
expected outcome. There is some documentation explaining its logic.
\item
40-49: the code runs and produces the expected output. There is some
documentation explaining its logic.
\item
50-59: the code runs and produces the expected output. There is
extensive documentation explaining its logic.
\item
60-69: the code runs and produces the expected output. There is
extensive documentation, properly formatted, explaining its logic.
\item
70-79: all as above, plus the code design includes clear evidence of
skills presented in advanced sections of the course (e.g.~custom
methods, list comprehensions, etc.).
\item
80-100: all as above, plus the code contains novel contributions that
extend/improve the functionality the student was provided with
(e.g.~algorithm optimizations, novel methods to perform the task,
etc.).
\end{itemize}
\bookmarksetup{startatroot}
\hypertarget{setting-up-the-working-environment}{%
\chapter*{Setting up the Working
Environment}\label{setting-up-the-working-environment}}
\addcontentsline{toc}{chapter}{Setting up the Working Environment}
\markboth{Setting up the Working Environment}{Setting up the Working
Environment}
Follow the instructions for yuour Operating System and test your
installation. If you experience any issues, write a message on the Ms
Teams channel of the module. Setting up the Python environment is
necessary for:
\begin{itemize}
\tightlist
\item
Executing the \href{https://docs.jupyter.org/en/latest/}{Jupyter
Notebooks} of the Lab sessions of the course.
\item
Preparing your own Jupyter Notebooks for the assignments (one each).
\end{itemize}
We will use \texttt{Minconda} to handle our working environment.
\emph{Miniconda is a free minimal installer for conda. It is a small
bootstrap version of Anaconda that includes only conda, Python, the
packages they both depend on, and a small number of other useful
packages (like pip, zlib, and a few others)}
\hypertarget{set-up-miniconda-and-python-on-ms-windows}{%
\section*{Set up Miniconda (and Python) on Ms
Windows}\label{set-up-miniconda-and-python-on-ms-windows}}
\addcontentsline{toc}{section}{Set up Miniconda (and Python) on Ms
Windows}
\markright{Set up Miniconda (and Python) on Ms Windows}
\hypertarget{installation}{%
\subsection*{Installation}\label{installation}}
\addcontentsline{toc}{subsection}{Installation}
\begin{enumerate}
\def\labelenumi{\arabic{enumi}.}
\tightlist
\item
Install Miniconda:
\begin{itemize}
\tightlist
\item
\emph{Option 1}: On a UoL Machine: Download and install Miniconda
from
\href{https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe}{here}.
This will install Miniconda and Python in
\texttt{C:\textbackslash{}}. If this process is aborted because it
requires administrator rights, press \texttt{Start}, select
\texttt{Install\ University\ Applications}, type and choose
\texttt{Miniconda}.
\item
\emph{Option 2}, \textbf{Recommended}: Install Miniconda on your
personal Laptop: Follow the instructions
\href{https://docs.conda.io/projects/miniconda/en/latest/miniconda-install.html}{here}.
\end{itemize}
\item
During the installation, leave the default settings. In particular,
when asked whom to ``Install Miniconda for'', choose ``Just for me''.
\end{enumerate}
\textbf{Important:} If you do choose to work on University Machines you
will have to reinstall \texttt{Miniconda} every lab session unless you
use a PC where Miniconda has been installed already.
\textbf{Alternatively}, you can work on the lab notebooks directly on
the web. This does not require to install \texttt{Miniconda}. However,
it represents a much slower option, especially when setting up the
environment. To do so, you can access the data and the lab notebooks in
the \texttt{\textbackslash{}labs} directory from a virtual copy of the
course repository
\href{https://mybinder.org/v2/gh/GDSL-UL/wma/HEAD}{here}. If you opt for
this option, you do not need to follow the rest of the instructions
below.
\hypertarget{set-up-the-directories}{%
\subsection*{Set up the Directories}\label{set-up-the-directories}}
\addcontentsline{toc}{subsection}{Set up the Directories}
\begin{enumerate}
\def\labelenumi{\arabic{enumi}.}
\tightlist
\item
Create a folder where you want to keep your work conducted throughout
this course. For example, call it \texttt{envs456}. You can save it
wherever you want. If you are working on a university machine, it
could be worth creating it in \texttt{M:/}, which should your
``virtual'' hard-disk.
\item
Download the
\href{https://minhaskamal.github.io/DownGit/\#/home?url=https://github.com/GDSL-UL/wma/tree/main/data}{data}
and the
\href{https://minhaskamal.github.io/DownGit/\#/home?url=https://github.com/GDSL-UL/wma/tree/main/labs_img}{images}
for running and rendering the jupyter notebooks.
\item
Unzip the folders and move the nested folders into the folder
\texttt{envs456}.
\item
Create another folder called \texttt{labs}
\end{enumerate}
The folder structure should look like:
\begin{verbatim}
envs456/
├── data/
├── labs_img/
└── labs/
\end{verbatim}
\hypertarget{set-up-the-python-environment}{%
\subsection*{Set up the Python
Environment}\label{set-up-the-python-environment}}
\addcontentsline{toc}{subsection}{Set up the Python Environment}
\begin{enumerate}
\def\labelenumi{\arabic{enumi}.}
\tightlist
\item
Download the \texttt{envs456.yml} from GitHub by cliciking
\texttt{Download\ raw\ file}, top right
\href{https://github.com/GDSL-UL/wma/blob/main/envs456.yml}{at this
page}
\item
Save it in the folder \texttt{envs456} created before.
\item
Type in the search bar and find the
\texttt{Anaconda\ Prompt\ (miniconda\ 3)}. Launch it. The terminal
should appear.
\end{enumerate}
\begin{enumerate}
\def\labelenumi{\arabic{enumi}.}
\setcounter{enumi}{2}
\tightlist
\item
In the \textbf{Anaconda Terminal} write:
\texttt{conda\ env\ create\ -n\ envs456\ -\/-file\ C:\textbackslash{}envs456\textbackslash{}envs456.yml}
and press \texttt{Enter}; if the file is located elsewhere you'll need
to use the corresponding file path.
\item
If you are prompted any questions, press \texttt{y}. This process will
install all the packages necessary to carry out the lab sessions.
\item
In the \textbf{Anaconda Terminal} write
\texttt{conda\ activate\ envs456} and press \texttt{Enter}. This
activates your working environment.
\item
\emph{Necessary} on University machines, otherwise \emph{Optional}:
Configuration of Jupyter Notebooks
\begin{itemize}
\tightlist
\item
In the \textbf{Anaconda Terminal}, write
\texttt{jupyter\ server\ -\/-generate-config} and press enter. This,
at least in Windows, should create a file to:
\texttt{C:\textbackslash{}Users\textbackslash{}username\textbackslash{}.jupyter\textbackslash{}jupyter\_server\_config.py}.
\item
Open the file with a text editor
(e.g.~\href{https://notepad-plus-plus.org}{Notepad++}), do a
\texttt{ctrl-f} search for: \texttt{c.ServerApp.root\_dir},
uncomment it by removing the and change it to
\texttt{c.ServerApp.notebook\_dir\ =\ \textquotesingle{}C:\textbackslash{}\textbackslash{}your\textbackslash{}\textbackslash{}new\textbackslash{}\textbackslash{}path},
for example the directory where you created the \texttt{envs456}
folder. In the University Machines, it is advised to work on the
directory \texttt{M:\textbackslash{}}.