jekyll build from Action 2943dff

UCL · Dec 11, 2024 · 7ff1f7c · 7ff1f7c
commit 7ff1f7c
Show file tree

Hide file tree

Showing 283 changed files with 69,562 additions and 0 deletions.
diff --git a/.nojekyll b/.nojekyll
diff --git a/01projects/index.html b/01projects/index.html
diff --git a/01projects/sec01Git.html b/01projects/sec01Git.html
diff --git a/01projects/sec02IntroToCpp.html b/01projects/sec02IntroToCpp.html
diff --git a/02cpp1/index.html b/02cpp1/index.html
diff --git a/02cpp1/sec01Types.html b/02cpp1/sec01Types.html
diff --git a/02cpp1/sec02PassByValueOrReference.html b/02cpp1/sec02PassByValueOrReference.html
diff --git a/02cpp1/sec03ObjectOrientedProgramming.html b/02cpp1/sec03ObjectOrientedProgramming.html
diff --git a/02cpp1/sec04StandardLibrary.html b/02cpp1/sec04StandardLibrary.html
diff --git a/02cpp1/sec05Pointers.html b/02cpp1/sec05Pointers.html
diff --git a/03cpp2/index.html b/03cpp2/index.html
diff --git a/03cpp2/sec01Exceptions.html b/03cpp2/sec01Exceptions.html
diff --git a/03cpp2/sec02ErrorHandling.html b/03cpp2/sec02ErrorHandling.html
diff --git a/03cpp2/sec03CMakeBasics.html b/03cpp2/sec03CMakeBasics.html
diff --git a/03cpp2/sec04UnitTesting.html b/03cpp2/sec04UnitTesting.html
diff --git a/03cpp2/sec05SoftwareBuilds.html b/03cpp2/sec05SoftwareBuilds.html
diff --git a/03cpp2/sec06CMakeBackground.html b/03cpp2/sec06CMakeBackground.html
diff --git a/03cpp2/sec07CMakeHelloWorld.html b/03cpp2/sec07CMakeHelloWorld.html
diff --git a/03cpp2/sec08BuildHelloWorld.html b/03cpp2/sec08BuildHelloWorld.html
diff --git a/04cpp3/index.html b/04cpp3/index.html
diff --git a/04cpp3/sec01Inheritance.html b/04cpp3/sec01Inheritance.html
diff --git a/04cpp3/sec03Templates.html b/04cpp3/sec03Templates.html
diff --git a/05libraries/ProgrammingParadigms.html b/05libraries/ProgrammingParadigms.html
diff --git a/05libraries/index.html b/05libraries/index.html
diff --git a/05libraries/sec01DesigningClasses.html b/05libraries/sec01DesigningClasses.html
diff --git a/05libraries/sec03CppCodeDesign.html b/05libraries/sec03CppCodeDesign.html
diff --git a/06tooling/index.html b/06tooling/index.html
diff --git a/06tooling/sec00TimingAndTooling.html b/06tooling/sec00TimingAndTooling.html
diff --git a/06tooling/sec01ChoosingLibraries.html b/06tooling/sec01ChoosingLibraries.html
diff --git a/06tooling/sec02LibraryBasics.html b/06tooling/sec02LibraryBasics.html
diff --git a/06tooling/sec03LinkingLibraries.html b/06tooling/sec03LinkingLibraries.html
diff --git a/06tooling/sec04InstallingLibraries.html b/06tooling/sec04InstallingLibraries.html
diff --git a/06tooling/sec05Summary.html b/06tooling/sec05Summary.html
diff --git a/07performance/img/CacheTranspose1.png b/07performance/img/CacheTranspose1.png
diff --git a/07performance/img/CacheTranspose10.png b/07performance/img/CacheTranspose10.png
diff --git a/07performance/img/CacheTranspose2.png b/07performance/img/CacheTranspose2.png
diff --git a/07performance/img/CacheTranspose3.png b/07performance/img/CacheTranspose3.png
diff --git a/07performance/img/CacheTranspose4.png b/07performance/img/CacheTranspose4.png
diff --git a/07performance/img/CacheTranspose5.png b/07performance/img/CacheTranspose5.png
diff --git a/07performance/img/CacheTranspose6.png b/07performance/img/CacheTranspose6.png
diff --git a/07performance/img/CacheTranspose7.png b/07performance/img/CacheTranspose7.png
diff --git a/07performance/img/CacheTranspose8.png b/07performance/img/CacheTranspose8.png
diff --git a/07performance/img/CacheTranspose9.png b/07performance/img/CacheTranspose9.png
diff --git a/07performance/img/insert_sort _11.jpg b/07performance/img/insert_sort _11.jpg
diff --git a/07performance/img/insert_sort _12.jpg b/07performance/img/insert_sort _12.jpg
diff --git a/07performance/img/insert_sort _13.jpg b/07performance/img/insert_sort _13.jpg
diff --git a/07performance/img/insert_sort _14.jpg b/07performance/img/insert_sort _14.jpg
diff --git a/07performance/img/insert_sort.jpg b/07performance/img/insert_sort.jpg
diff --git a/07performance/img/insert_sort_1.jpg b/07performance/img/insert_sort_1.jpg
diff --git a/07performance/img/insert_sort_10.jpg b/07performance/img/insert_sort_10.jpg
diff --git a/07performance/img/insert_sort_2.jpg b/07performance/img/insert_sort_2.jpg
diff --git a/07performance/img/insert_sort_3.jpg b/07performance/img/insert_sort_3.jpg
diff --git a/07performance/img/insert_sort_4.jpg b/07performance/img/insert_sort_4.jpg
diff --git a/07performance/img/insert_sort_5.jpg b/07performance/img/insert_sort_5.jpg
diff --git a/07performance/img/insert_sort_6.jpg b/07performance/img/insert_sort_6.jpg
diff --git a/07performance/img/insert_sort_7.jpg b/07performance/img/insert_sort_7.jpg
diff --git a/07performance/img/insert_sort_8.jpg b/07performance/img/insert_sort_8.jpg
diff --git a/07performance/img/insert_sort_9.jpg b/07performance/img/insert_sort_9.jpg
diff --git a/07performance/img/merge_sort.jpg b/07performance/img/merge_sort.jpg
diff --git a/07performance/img/merge_sort_1.jpg b/07performance/img/merge_sort_1.jpg
diff --git a/07performance/img/merge_sort_2.jpg b/07performance/img/merge_sort_2.jpg
diff --git a/07performance/img/merge_sort_3.jpg b/07performance/img/merge_sort_3.jpg
diff --git a/07performance/img/merge_sort_4.jpg b/07performance/img/merge_sort_4.jpg
diff --git a/07performance/img/merge_sort_6.jpg b/07performance/img/merge_sort_6.jpg
diff --git a/07performance/img/merge_sort_7.jpg b/07performance/img/merge_sort_7.jpg
diff --git a/07performance/img/merge_sort_8.jpg b/07performance/img/merge_sort_8.jpg
diff --git a/07performance/img/merge_sort_9.jpg b/07performance/img/merge_sort_9.jpg
diff --git a/07performance/index.html b/07performance/index.html
diff --git a/07performance/sec00Motivation.html b/07performance/sec00Motivation.html
diff --git a/07performance/sec01Complexity.html b/07performance/sec01Complexity.html
diff --git a/07performance/sec02Memory.html b/07performance/sec02Memory.html
diff --git a/07performance/sec03Optimisation.html b/07performance/sec03Optimisation.html
diff --git a/08openmp/01_parallel_programming.html b/08openmp/01_parallel_programming.html
diff --git a/08openmp/02_intro_openmp.html b/08openmp/02_intro_openmp.html
diff --git a/08openmp/03_fractal_example.html b/08openmp/03_fractal_example.html
diff --git a/08openmp/04_cache_performance.html b/08openmp/04_cache_performance.html
diff --git a/08openmp/05_summary.html b/08openmp/05_summary.html
diff --git a/08openmp/img/cfd.png b/08openmp/img/cfd.png
diff --git a/08openmp/img/fork_join.jpg b/08openmp/img/fork_join.jpg
diff --git a/08openmp/img/fork_join.png b/08openmp/img/fork_join.png
diff --git a/08openmp/img/mandelbrot.jpg b/08openmp/img/mandelbrot.jpg
diff --git a/08openmp/img/moores_law.png b/08openmp/img/moores_law.png
diff --git a/08openmp/img/neural_net.jpg b/08openmp/img/neural_net.jpg
diff --git a/08openmp/img/pi_integration.png b/08openmp/img/pi_integration.png
diff --git a/08openmp/img/strong_scaling.png b/08openmp/img/strong_scaling.png
diff --git a/08openmp/img/text_mandel.png b/08openmp/img/text_mandel.png
diff --git a/08openmp/index.html b/08openmp/index.html
diff --git a/09distributed_computing/images/GOL_Processes.jpg b/09distributed_computing/images/GOL_Processes.jpg
diff --git a/09distributed_computing/images/Merge_Sort_Pairwise.jpg b/09distributed_computing/images/Merge_Sort_Pairwise.jpg
diff --git a/09distributed_computing/images/Merge_Sort_Processes.jpg b/09distributed_computing/images/Merge_Sort_Processes.jpg
diff --git a/09distributed_computing/images/Merge_Sort_Simple.jpg b/09distributed_computing/images/Merge_Sort_Simple.jpg
diff --git a/09distributed_computing/images/Process_Diagram.jpg b/09distributed_computing/images/Process_Diagram.jpg
diff --git a/09distributed_computing/images/Simple_Cluster.jpg b/09distributed_computing/images/Simple_Cluster.jpg
diff --git a/09distributed_computing/images/Square_Allocation_Grid.jpg b/09distributed_computing/images/Square_Allocation_Grid.jpg
diff --git a/09distributed_computing/images/Unallocated_Grid.jpg b/09distributed_computing/images/Unallocated_Grid.jpg
diff --git a/09distributed_computing/images/Vertical_Allocation_Grid.jpg b/09distributed_computing/images/Vertical_Allocation_Grid.jpg
diff --git a/09distributed_computing/index.html b/09distributed_computing/index.html
diff --git a/09distributed_computing/sec01DistributedMemoryModels.html b/09distributed_computing/sec01DistributedMemoryModels.html
diff --git a/09distributed_computing/sec02ProgrammingWithMPI.html b/09distributed_computing/sec02ProgrammingWithMPI.html
diff --git a/10parallel_algorithms/AsynchronousMPI.html b/10parallel_algorithms/AsynchronousMPI.html
diff --git a/10parallel_algorithms/WorkDepth.html b/10parallel_algorithms/WorkDepth.html
diff --git a/10parallel_algorithms/images/Batch1.png b/10parallel_algorithms/images/Batch1.png
diff --git a/10parallel_algorithms/images/MapCircuit.png b/10parallel_algorithms/images/MapCircuit.png
diff --git a/10parallel_algorithms/images/PartialScan.png b/10parallel_algorithms/images/PartialScan.png
diff --git a/10parallel_algorithms/images/PartialScan2.png b/10parallel_algorithms/images/PartialScan2.png
diff --git a/10parallel_algorithms/images/PartialScan3.png b/10parallel_algorithms/images/PartialScan3.png
diff --git a/10parallel_algorithms/images/Pipeline.png b/10parallel_algorithms/images/Pipeline.png
diff --git a/10parallel_algorithms/images/ReduceCircuit.png b/10parallel_algorithms/images/ReduceCircuit.png
diff --git a/10parallel_algorithms/images/SimpleCircuit.png b/10parallel_algorithms/images/SimpleCircuit.png
diff --git a/10parallel_algorithms/index.html b/10parallel_algorithms/index.html
diff --git a/Dockerfile b/Dockerfile
@@ -0,0 +1,10 @@
+FROM ubuntu:jammy-20221130
+
+COPY .github/texlive /
+RUN apt-get update -y; DEBIAN_FRONTEND=noninteractive TZ=Etc/UTC  apt-get install -y $(cat /requirements.txt)
+
+COPY .github/python /
+RUN  apt-get install -y python3 python3-pip python-is-python3; pip install -r /requirements.txt
+
+COPY Gemfile /
+RUN apt-get install -y ruby-full; gem install bundler; bundle check || bundle install --jobs=4 --retry=3; rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
diff --git a/README.md b/README.md
@@ -0,0 +1,79 @@
+research-computing-with-cpp
+===========================
+
+Deployed at:
+
+http://github-pages.ucl.ac.uk/research-computing-with-cpp
+
+
+How to build the lessons locally
+-----------------------------------
+
+Clone and build the various output files (that step will need some dependencies)
+``` bash
+git clone https://github.com/UCL-RITS/research-computing-with-cpp
+cd research-computing-with-cpp
+./build.sh
+```
+
+Then you can proceed to build the website locally. The easiest is via docker.
+
+```bash
+mkdir ../bundle # To don't download every single time the ruby dependencies
+docker run --rm --volume="$PWD:/srv/jekyll" --volume="$PWD/../bundle:/usr/local/bundle" -it jekyll/jekyll:4 jekyll build
+python -m http.server -d _site
+```
+
+Dependencies
+-------------
+
+All the dependencies are set in the `.github/{texlive,python}/requirements.txt` for an ubuntu machine.
+
+On a Mac, we use g++ installed via [homebrew](https://brew.sh/). So, for g++ version 7, we would run the build command as:
+
+``` bash
+CC=gcc-7 CXX=g++-7 ./build.sh
+```
+
+The explicit compiler selection is needed on Mac OS for OpenMP (and possibly MPI)
+examples to build. Update the version number as necessary.
+
+You will need to have a bunch of stuff installed in order for the build to succeed.
+For Mac:
+* Libraries:
+   * `brew install boost`
+* For building MPI and OpenMP examples:
+   * `brew install open-mpi`
+   * `brew install gcc`
+* Ruby stuff:
+   * `brew install ruby`
+   * `gem install jekyll --version '~> 4'`
+   * `gem install kramdown --version '~> 2.3.1'
+   * `gem install jekyll-remote-theme`
+`
+* Other utilities:
+   * `brew install wget`
+* Python libraries:
+   * `matplotlib` (plus several other scientific python libraries)
+
+A full LaTeX distribution needs to be available to generate a PDF version of the course notes by the build script.
+
+Alternatively, you can build the docker container available and build the site through it:
+
+```
+$ docker build -t rcpp
+$ docker run -it --rm --volume=$PWD:/root rcpp:latest bash
+# cd
+# ITK_DIR=/usr/lib/InsightToolkit ./build.sh
+# make _site
+```
+
+Then in folder _site, you'll have the `html`'s.
+Or, for a shortcut: `make preview`
+
+
+
+See https://github.com/UCL-RITS/research-computing-with-cpp/blob/master/01cpp/index.md for an example of how to reference a C file, CMake file, and run an executable
+
+And https://github.com/UCL-RITS/research-computing-with-cpp/tree/master/01cpp/cpp/hello
+for the corresponding code
diff --git a/assets/css/jekyll-styles.css b/assets/css/jekyll-styles.css
@@ -0,0 +1,73 @@
+div#slidelink {
+    float: right;
+}
+
+.hll { background-color: #ffffcc }
+.c { color: #999988; font-style: italic } /* Comment */
+.err { color: #a61717; background-color: #e3d2d2 } /* Error */
+.k { color: #000000; font-weight: bold } /* Keyword */
+.o { color: #000000; font-weight: bold } /* Operator */
+.cm { color: #999988; font-style: italic } /* Comment.Multiline */
+.cp { color: #999999; font-weight: bold; font-style: italic } /* Comment.Preproc */
+.c1 { color: #999988; font-style: italic } /* Comment.Single */
+.cs { color: #999999; font-weight: bold; font-style: italic } /* Comment.Special */
+.gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
+.ge { color: #000000; font-style: italic } /* Generic.Emph */
+.gr { color: #aa0000 } /* Generic.Error */
+.gh { color: #999999 } /* Generic.Heading */
+.gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
+.go { color: #888888 } /* Generic.Output */
+.gp { color: #555555 } /* Generic.Prompt */
+.gs { font-weight: bold } /* Generic.Strong */
+.gu { color: #aaaaaa } /* Generic.Subheading */
+.gt { color: #aa0000 } /* Generic.Traceback */
+.kc { color: #000000; font-weight: bold } /* Keyword.Constant */
+.kd { color: #000000; font-weight: bold } /* Keyword.Declaration */
+.kn { color: #000000; font-weight: bold } /* Keyword.Namespace */
+.kp { color: #000000; font-weight: bold } /* Keyword.Pseudo */
+.kr { color: #000000; font-weight: bold } /* Keyword.Reserved */
+.kt { color: #445588; font-weight: bold } /* Keyword.Type */
+.m { color: #009999 } /* Literal.Number */
+.s { color: #d01040 } /* Literal.String */
+.na { color: #008080 } /* Name.Attribute */
+.nb { color: #0086B3 } /* Name.Builtin */
+.nc { color: #445588; font-weight: bold } /* Name.Class */
+.no { color: #008080 } /* Name.Constant */
+.nd { color: #3c5d5d; font-weight: bold } /* Name.Decorator */
+.ni { color: #800080 } /* Name.Entity */
+.ne { color: #990000; font-weight: bold } /* Name.Exception */
+.nf { color: #990000; font-weight: bold } /* Name.Function */
+.nl { color: #990000; font-weight: bold } /* Name.Label */
+.nn { color: #555555 } /* Name.Namespace */
+.nt { color: #000080 } /* Name.Tag */
+.nv { color: #008080 } /* Name.Variable */
+.ow { color: #000000; font-weight: bold } /* Operator.Word */
+.w { color: #bbbbbb } /* Text.Whitespace */
+.mf { color: #009999 } /* Literal.Number.Float */
+.mh { color: #009999 } /* Literal.Number.Hex */
+.mi { color: #009999 } /* Literal.Number.Integer */
+.mo { color: #009999 } /* Literal.Number.Oct */
+.sb { color: #d01040 } /* Literal.String.Backtick */
+.sc { color: #d01040 } /* Literal.String.Char */
+.sd { color: #d01040 } /* Literal.String.Doc */
+.s2 { color: #d01040 } /* Literal.String.Double */
+.se { color: #d01040 } /* Literal.String.Escape */
+.sh { color: #d01040 } /* Literal.String.Heredoc */
+.si { color: #d01040 } /* Literal.String.Interpol */
+.sx { color: #d01040 } /* Literal.String.Other */
+.sr { color: #009926 } /* Literal.String.Regex */
+.s1 { color: #d01040 } /* Literal.String.Single */
+.ss { color: #990073 } /* Literal.String.Symbol */
+.bp { color: #999999 } /* Name.Builtin.Pseudo */
+.vc { color: #008080 } /* Name.Variable.Class */
+.vg { color: #008080 } /* Name.Variable.Global */
+.vi { color: #008080 } /* Name.Variable.Instance */
+.il { color: #009999 } /* Literal.Number.Integer.Long */
+.photograph {
+  background-color: #007e9e;
+}
+.header--mobile { 
+  background-color: #007e9e; 
+  border-bottom-color: #007e9e; 
+} 
+
diff --git a/assets/css/print.css b/assets/css/print.css
@@ -0,0 +1 @@
+