Loading [MathJax]/jax/output/HTML-CSS/jax.js
  • Course Aims
  • Day 1 Schedule
  • 1. Introduction to R and its environment
    • What’s R?
    • R plotting capabilities
    • Who uses R? Not just academics!
    • R can facilitate Reproducible Research
    • Getting started
    • Basic concepts in R - simple arithmetic
    • Basic concepts in R - variables
    • Basic concepts in R - functions
    • Basic concepts in R - vectors
    • Basic concepts in R - vector arithmetic
    • Basic concepts in R - Character vectors and naming
    • Exercise: Body-Mass Index
    • Getting help
    • R packages
    • Installing packages
    • Example: Load packages ggplot2 and DESeq2

Course Aims

  • To introduce you to the basics of R
    • Reading data
    • Perform simple analyses
    • Producing graphs
    • How to get help!
  • Give you all the background you need to practice by yourselves
  • Introduce tools that will help you to work in a reproducible manner

Day 1 Schedule

  1. Introduction to R and its environment
  2. Data Structures
  3. Data Analysis Walkthrough
  4. Plotting in R

1. Introduction to R and its environment

What’s R?

  • A statistical programming environment
    • based on ‘S’
    • suited to high-level data analysis
  • But offers much more than just statistics
  • Open source and cross platform
  • Extensive graphics capabilities
  • Diverse range of add-on packages
  • Active community of developers
  • Thorough documentation

http://www.r-project.org/

R screenshot

R screenshot

New York Times, Jan 2009

New York Times, Jan 2009

R can facilitate Reproducible Research

Sidney Harris - New York Times

Sidney Harris - New York Times

  • Statisticians at MD Anderson tried to reproduce results from a Duke paper and unintentionally unravelled a web of incompetence and skullduggery
    • as reported in the New York Times
New York Times, July 2011

New York Times, July 2011

  • Very entertaining talk from Keith Baggerly in Cambridge, December 2010

According to recent editorials, the reproducibility crisis is still on-going

Nature, May 2016

Nature, May 2016

Reality check on reproducibility

1,500 scientists lift the lid on reproducibility

Getting started

  • Latest release 3.3.2 (October 2016)
    • Base package and Contributed packages (general purpose extras)
    • 10838 available packages as of Fri Jun 16 10:03:38 2017
  • Download from http://mirrors.ebi.ac.uk/CRAN/
  • Windows, Mac and Linux versions available
  • Executed using command line, or a graphical user interface (GUI)
  • On this course, we use the RStudio GUI (www.rstudio.com)
rstudio

rstudio

To launch RStudio, find the RStudio icon and click

RStudio screenshot

RStudio screenshot

  • The traditional way to enter R commands is via the Terminal, or using the console in RStudio (bottom-left)
  • However, for this course we will use a relatively new feature called R-notebooks.
  • An R-notebook mixes plain text with R code
    • The R code can be run from inside the document and the results are displayed directly underneath
  • Each chunk of R code looks something like this.
  • Each line of R can be executed by clicking on the line and pressing CTRL and ENTER
  • Or you can press the green triangle on the right-hand side to run everything in the chunk
  • Try this now!
print("Hello World")
  • The R notebook can be rendered into a format such as PDF or HTML so they can be shared with your collaborators
  • On the course website you will see compiled versions of each session

Basic concepts in R - simple arithmetic

  • The command line can be used as a calculator and understands the usual arithmetic operators +, -, *, /
  • Try adding a few more calculations here
2 + 2
2 - 2
4 * 3
10 / 2

Note: The number in the square brackets is an indicator of the position in the output. In this case the output is a ‘vector’ of length 1 (i.e. a single number). More on vectors coming up…

In the case of expressions involving multiple operations, R respects the BODMAS system to decide the order in which operations should be performed.

2 + 2 *3
2 + (2 * 3)
(2 + 2) * 3

R is capable of more complicated arithmetic such as trigonometry and logarithms; like you would find on a fancy scientific calculator. Of course, R also has a plethora of statistical operations as we will see.

pi
sin (pi/2)
cos(pi)
tan(2)
log(1)

We can only go so far with performing simple calculations like this. Eventually we will need to store our results for later use. For this, we need to make use of variables.

Basic concepts in R - variables

  • A variable is a letter or word which takes (or contains) a value. We use the assignment operator: <-
x <- 10
x
myNumber <- 25
myNumber
  • We can perform arithmetic on variables:
sqrt(myNumber)
  • We can add variables together:
x + myNumber
  • We can change the value of an existing variable:
x <- 21
x
  • We can set one variable to equal the value of another variable:
x <- myNumber
x
  • We can modify the contents of a variable:
myNumber <- myNumber + sqrt(16)
myNumber

When we are feeling lazy we might give our variables short names (x, y, i…etc), but a better practice would be to give them meaningful names. There are some restrictions on creating variable names. They cannot start with a number or contain characters such as ., _, ‘-’. Naming variables the same as in-built functions in R, such as c, T, mean should also be avoided.

Naming variables is a matter of taste. Some conventions exist such as a separating words with - or using CamelCaps. Whatever convention you decided, stick with it!

Basic concepts in R - functions

  • Functions in R perform operations on arguments (the inputs(s) to the function). We have already used:
sin(x)
  • This returns the sine of x
    • In this case the function has one argument: x.
    • Arguments are always contained in parentheses – curved brackets, () – separated by commas.

Arguments can be named or unnamed, but if they are unnamed they must be ordered (we will see later how to find the right order). The names of the arguments are determined by the author of the function and can be found in the help page for the function. When testing code, it is easier and safer to name the arguments.

seq is a function for generating a numeric sequence from and to particular numbers.

  • Type ?seq to get the help page for this function.
  • When testing code, it is easier and safer to name the arguments
seq(from = 2, to = 20, by = 4)
seq(2, 20, 4)

Arguments can have default values, meaning we do not need to specify values for these in order to run the function.

rnorm is a function that will generate a series of values from a normal distribution. In order to use the function, we need to tell R how many values we want

rnorm(n=10)

The normal distribution is defined by a mean (average) and standard deviation (spread). However, in the above example we didn’t tell R what mean and standard deviation we wanted. So how does R know what to do? All arguments to a function and their default values are listed in the help page

(N.B sometimes help pages can describe more than one function)

?rnorm

In this case, we see that the defaults for mean and standard deviation are 0 and 1. We can change the function to generate values from a distribution with a different mean and standard deviation using the mean and sd arguments. It is important that we get the spelling of these arguments exactly right, otherwise R will an error message, or (worse?) do something unexpected.

rnorm(n=10, mean=2,sd=3)
rnorm(10, 2, 3)

In the examples above, seq and rnorm were both outputting a series of numbers, which is called a vector in R and is the most-fundamental data-type.

Basic concepts in R - vectors

  • The basic data structure in R is a vector – an ordered collection of values.
  • R treats even single values as 1-element vectors.
  • The function c combines its arguments into a vector:
x <- c(3,4,5,6)
x
  • The square brackets [] indicate the position within the vector (the index).
  • We can extract individual elements by using the [] notation:
x[1]
x[4]
  • We can even put a vector inside the square brackets (vector indexing):
  • Before executing this line of code, what do you think it will produce?
y <- c(2,3)
x[y]
  • There are a number of shortcuts to create a vector.
  • Instead of:
x <- c(3, 4, 5, 6, 7, 8, 9, 10, 11, 12)
x
  • we can write:
x <- 3:12
x
  • or we can use the seq() function, which returns a vector:
x <- seq(2, 20, 4)
x
x <- seq(2, 20, length.out=5)
x
  • or we can use the rep() function:
y <- rep(3, 5)
y
y <- rep(1:3, 5)
y
  • We have seen some ways of extracting elements of a vector. We can use these shortcuts to make things easier (or more complex!)
x <- 3:12
# Extract elements from x:

x[3:7]
x[seq(2, 6, 2)]
x[rep(3, 2)]
  • We can add an element to a vector:
y <- c(x, 1)
y
  • We can glue vectors together:
z <- c(x, y)
z
  • We can “remove” element(s) from a vector:
    • NOTE: the vector x doesn’t get modified
    • we’re just displaying what the vector looks like without particular elements
x <- 3:12

x[-3]
x[-(5:7)]
x[-seq(2, 6, 2)]
x
  • Finally, we can modify the contents of a vector:
x[6] <- 4
x

x[3:5] <- 1
x

Remember!

  • Square brackets [ ] for indexing
  • Parentheses () for function arguments

Basic concepts in R - vector arithmetic

  • When applying all standard arithmetic operations to vectors, application is element-wise
x <- 1:10
y <- x*2
y
z <- x^2
z
  • Adding two vectors:
y + z
  • If vectors are not the same length, the shorter one will be recycled:
x + 1:2
  • But be careful if the vector lengths aren’t factors of each other:
x + 1:3
  • Sometimes R will give a warning message. It has performed the calculation you asked it to, but the results may be unexpected. You need to check the output carefully to make sure it is what you really wanted.

Basic concepts in R - Character vectors and naming

  • All the vectors we have seen so far have contained numbers, but we can also store text (/“strings”) in vector
    • this is called a character vector.
gene.names <- c("Pax6", "Beta-actin", "FoxP2", "Hox9")
gene.names
  • We can name elements of vectors using the names() function, which can be useful to keep track of the meaning of our data:
gene.expression <- c(0, 3.2, 1.2, -2)
names(gene.expression) <- gene.names
gene.expression
  • We can also use the names() function to get a vector of the names of an object:
names(gene.expression)

Exercise: Body-Mass Index

  • Let’s try some vector arithmetic. Here are the weights and heights of five individuals
Person Weight (kg) Height (cm)
Jo 65.8 192
Sam 67.9 179
Charlie 75.3 169
Frankie 61.9 175
Alex 92.4 171
  • Create weight and height vectors to hold the data in each column using the c function. Create a person vector and use this vector to name the values in the other two vectors.
  1. The body-mass index is given by the formula:- BMI=(Weight)/(Height2); where Height is given in metres
    • Create a new vector to record this, called bmi.
  2. Create a new vector bmi.sorted where the bmi values are put in increasing numeric order (HINT: look up the help on the sort function)
  3. The interquartile range (IQR) of a vector is defined as the 75% percentile of the data minus the 25% percentile. Calculate the IQR for our bmi values
    • check your answer using the IQR function
### YOUR ANSWER HERE (please) ###

Getting help

  • This is possibly the most important slide in the whole course!?!
  • To get help on any R function, type ? followed by the function name. For example:
?seq
  • This retrieves the syntax and arguments for the function. The help page shows the default order of arguments. It also tells you which package it belongs to.
  • There is typically a usage example, which you can test using the example function:
example(seq)
  • If you can’t remember the exact name, type ?? followed by your guess. R will return a list of possibilities:
??mean
  • The Packages tab in the lower-right panel of RStudio will help you locate the help pages for a particular package and its functions
    • Often there will be a user-guide or ‘vignette’ too

R packages

  • R comes ready loaded with various libraries of functions called packages. For example: the function sum() is in the base package and sd(), which calculates the standard deviation of a vector, is in the stats package
  • There are 1000s of additional packages provided by third parties, and the packages can be found in numerous server locations on the web called repositories
  • The two repositories you will come across the most are:
  • Bottomline: always first look if there is already an R package that does what you want before trying to implement it yourself

Installing packages

  • CRAN packages can be installed using install.packages()

    • or clicking on the Packages tab in RStudio
install.packages(name.of.my.package)
  • Set the Bioconductor package download tool by typing:
source("http://bioconductor.org/biocLite.R")
  • Bioconductor packages are then installed with the biocLite() function:
biocLite("PackageName")
  • ggplot2 is a commonly used graphics package:
    • in RStudio, go to Tools → Install Packages… and type the package name
    • or use install.packages() function to install it:
install.packages("ggplot2")
source("http://www.bioconductor.org/biocLite.R")
biocLite("DESeq2")

Example: Load packages ggplot2 and DESeq2

  • R needs to be told to use the new functions from the installed packages. Use library(...) function to load the newly installed features:
library(ggplot2) # loads ggplot functions
library(DESeq2)   # loads DESeq functions
library()        # Lists all the packages 
                 # you've got installed
LS0tCnRpdGxlOiAiSW50cm9kdWN0aW9uIHRvIFNvbHZpbmcgQmlvbG9naWNhbCBQcm9ibGVtcyBVc2luZyBSIC0gRGF5IDEiCmF1dGhvcjogTWFyayBEdW5uaW5nLCBTdXJhaiBNZW5vbiBhbmQgQWlvcmEgWmFiYWxhLiBPcmlnaW5hbCBtYXRlcmlhbCBieSBSb2JlcnQgU3Rvam5pxIcsCiAgTGF1cmVudCBHYXR0bywgUm9iIEZveSwgSm9obiBEYXZleSwgRMOhdmlkIE1vbG7DoXIgYW5kIElhbiBSb2JlcnRzCmRhdGU6ICdgciBmb3JtYXQoU3lzLnRpbWUoKSwgIkxhc3QgbW9kaWZpZWQ6ICVkICViICVZIilgJwpvdXRwdXQ6CiAgaHRtbF9ub3RlYm9vazoKICAgIHRvYzogeWVzCiAgICB0b2NfZmxvYXQ6IHllcwpjc3M6IG15c3R5bGUuY3NzCi0tLQpgYGB7ciBpbmNsdWRlID0gRkFMU0V9CmxpYnJhcnkoa25pdHIpCm9wdHNfY2h1bmskc2V0KGNvbW1lbnQgPSBOQSxldmFsPUZBTFNFKSAjIGVsaW1pbmF0ZXMgaGFzaHRhZyBmcm9tIFIgb3V0cHV0cwpgYGAKCgoKIyBDb3Vyc2UgQWltcwoKLSBUbyBpbnRyb2R1Y2UgeW91IHRvIHRoZSBiYXNpY3Mgb2YgUgogICAgKyBSZWFkaW5nIGRhdGEKICAgICsgUGVyZm9ybSBzaW1wbGUgYW5hbHlzZXMKICAgICsgUHJvZHVjaW5nIGdyYXBocwogICAgKyAqKipIb3cgdG8gZ2V0IGhlbHAhKioqCi0gR2l2ZSB5b3UgYWxsIHRoZSBiYWNrZ3JvdW5kIHlvdSBuZWVkIHRvICoqKnByYWN0aWNlKioqIGJ5IHlvdXJzZWx2ZXMKLSBJbnRyb2R1Y2UgdG9vbHMgdGhhdCB3aWxsIGhlbHAgeW91IHRvIHdvcmsgaW4gYSAqKipyZXByb2R1Y2libGUqKiogbWFubmVyCgojIERheSAxIFNjaGVkdWxlCgoxLiBJbnRyb2R1Y3Rpb24gdG8gUiBhbmQgaXRzIGVudmlyb25tZW50CjIuIERhdGEgU3RydWN0dXJlcwozLiBEYXRhIEFuYWx5c2lzIFdhbGt0aHJvdWdoCjQuIFBsb3R0aW5nIGluIFIKCiMxLiBJbnRyb2R1Y3Rpb24gdG8gUiBhbmQgaXRzIGVudmlyb25tZW50CgojI1doYXQncyBSPwoKKiBBIHN0YXRpc3RpY2FsIHByb2dyYW1taW5nIGVudmlyb25tZW50CiAgICArIGJhc2VkIG9uICdTJwogICAgKyBzdWl0ZWQgdG8gaGlnaC1sZXZlbCBkYXRhIGFuYWx5c2lzCiogQnV0IG9mZmVycyBtdWNoIG1vcmUgdGhhbiBqdXN0IHN0YXRpc3RpY3MKKiBPcGVuIHNvdXJjZSBhbmQgY3Jvc3MgcGxhdGZvcm0KKiBFeHRlbnNpdmUgZ3JhcGhpY3MgY2FwYWJpbGl0aWVzCiogRGl2ZXJzZSByYW5nZSBvZiBhZGQtb24gcGFja2FnZXMKKiBBY3RpdmUgY29tbXVuaXR5IG9mIGRldmVsb3BlcnMKKiBUaG9yb3VnaCBkb2N1bWVudGF0aW9uCgoKCmh0dHA6Ly93d3cuci1wcm9qZWN0Lm9yZy8KCiFbUiBzY3JlZW5zaG90XShpbWFnZXMvUi1wcm9qZWN0LnBuZykKCiFbTmV3IFlvcmsgVGltZXMsIEphbiAyMDA5XShpbWFnZXMvTllUaW1lc19SX0FydGljbGUucG5nKQoKCiMjUiBwbG90dGluZyBjYXBhYmlsaXRpZXMKCmh0dHBzOi8vd3d3LmZhY2Vib29rLmNvbS9ub3Rlcy9mYWNlYm9vay1lbmdpbmVlcmluZy92aXN1YWxpemluZy1mcmllbmRzaGlwcy80Njk3MTYzOTg5MTkKIVtSIGZhY2Vib29rXShpbWFnZXMvZmFjZWJvb2stbmV0d29yay5wbmcpCgojI1dobyB1c2VzIFI/IE5vdCBqdXN0IGFjYWRlbWljcyEKCmh0dHA6Ly93d3cucmV2b2x1dGlvbmFuYWx5dGljcy5jb20vY29tcGFuaWVzLXVzaW5nLXIKCi0gRmFjZWJvb2sKICAgICsgaHR0cDovL2Jsb2cucmV2b2x1dGlvbmFuYWx5dGljcy5jb20vMjAxMC8xMi9hbmFseXNpcy1vZi1mYWNlYm9vay1zdGF0dXMtdXBkYXRlcy5odG1sCi0gR29vZ2xlCiAgICArIGh0dHA6Ly9ibG9nLnJldm9sdXRpb25hbmFseXRpY3MuY29tLzIwMDkvMDUvZ29vZ2xlLXVzaW5nLXItdG8tYW5hbHl6ZS1lZmZlY3RpdmVuZXNzLW9mLXR2LWFkcy5odG1sCi0gTWljcm9zb2Z0CiAgICArIGh0dHA6Ly9ibG9nLnJldm9sdXRpb25hbmFseXRpY3MuY29tLzIwMTQvMDUvbWljcm9zb2Z0LXVzZXMtci1mb3IteGJveC1tYXRjaG1ha2luZy5odG1sCi0gTmV3IFlvcmsgVGltZXMKICAgICsgaHR0cDovL2Jsb2cucmV2b2x1dGlvbmFuYWx5dGljcy5jb20vMjAxMS8wMy9ob3ctdGhlLW5ldy15b3JrLXRpbWVzLXVzZXMtci1mb3ItZGF0YS12aXN1YWxpemF0aW9uLmh0bWwKLSBCdXp6ZmVlZAogICAgKyBodHRwOi8vYmxvZy5yZXZvbHV0aW9uYW5hbHl0aWNzLmNvbS8yMDE1LzEyL2J1enpmZWVkLXVzZXMtci1mb3ItZGF0YS1qb3VybmFsaXNtLmh0bWwKLSBOZXcgWmVhbGFuZCBUb3VyaXN0IEJvYXJkCiAgICArIGh0dHBzOi8vbWJpZW56LnNoaW55YXBwcy5pby90b3VyaXNtX2Rhc2hib2FyZF9wcm9kLwoKICAgIAojIyBSIGNhbiBmYWNpbGl0YXRlIFJlcHJvZHVjaWJsZSBSZXNlYXJjaAoKIVtTaWRuZXkgSGFycmlzIC0gTmV3IFlvcmsgVGltZXNdKGltYWdlcy9TaWRuZXlIYXJyaXNfTWlyYWNsZVdlYi5qcGcpCgoKCgotIFN0YXRpc3RpY2lhbnMgYXQgTUQgQW5kZXJzb24gdHJpZWQgdG8gcmVwcm9kdWNlIHJlc3VsdHMgZnJvbSBhIER1a2UgcGFwZXIgYW5kIHVuaW50ZW50aW9uYWxseSB1bnJhdmVsbGVkIGEgd2ViIG9mIGluY29tcGV0ZW5jZSBhbmQgc2t1bGxkdWdnZXJ5CiAgICArIGFzIHJlcG9ydGVkIGluIHRoZSAqKipOZXcgWW9yayBUaW1lcyoqKgogICAgCiFbTmV3IFlvcmsgVGltZXMsIEp1bHkgMjAxMV0oaW1hZ2VzL3JlcC1yZXNlYXJjaC1ueXQucG5nKQoKCgotIFZlcnkgZW50ZXJ0YWluaW5nIHRhbGsgZnJvbSBLZWl0aCBCYWdnZXJseSBpbiBDYW1icmlkZ2UsIERlY2VtYmVyIDIwMTAKCjxpZnJhbWUgd2lkdGg9IjU2MCIgaGVpZ2h0PSIzMTUiIHNyYz0iaHR0cHM6Ly93d3cueW91dHViZS5jb20vZW1iZWQvN2dZSXM3dVliTW8iIGZyYW1lYm9yZGVyPSIwIiBhbGxvd2Z1bGxzY3JlZW4+PC9pZnJhbWU+CgpBY2NvcmRpbmcgdG8gcmVjZW50IGVkaXRvcmlhbHMsIHRoZSByZXByb2R1Y2liaWxpdHkgY3Jpc2lzIGlzIHN0aWxsIG9uLWdvaW5nCgohW05hdHVyZSwgTWF5IDIwMTZdKGltYWdlcy9yZXAtY3Jpc2lzLnBuZykKCgpbUmVhbGl0eSBjaGVjayBvbiByZXByb2R1Y2liaWxpdHldKGh0dHA6Ly93d3cubmF0dXJlLmNvbS9uZXdzL3JlYWxpdHktY2hlY2stb24tcmVwcm9kdWNpYmlsaXR5LTEuMTk5NjEpCgpbMSw1MDAgc2NpZW50aXN0cyBsaWZ0IHRoZSBsaWQgb24gcmVwcm9kdWNpYmlsaXR5XShodHRwOi8vd3d3Lm5hdHVyZS5jb20vbmV3cy8xLTUwMC1zY2llbnRpc3RzLWxpZnQtdGhlLWxpZC1vbi1yZXByb2R1Y2liaWxpdHktMS4xOTk3MCkKCgojI0dldHRpbmcgc3RhcnRlZAotIExhdGVzdCByZWxlYXNlIDMuMy4yIChPY3RvYmVyIDIwMTYpCiAgICArIEJhc2UgcGFja2FnZSBhbmQgQ29udHJpYnV0ZWQgcGFja2FnZXMgKGdlbmVyYWwgcHVycG9zZSBleHRyYXMpCiAgICArIGByIGxlbmd0aChYTUw6OjpyZWFkSFRNTFRhYmxlKCJodHRwOi8vY3Jhbi5yLXByb2plY3Qub3JnL3dlYi9wYWNrYWdlcy9hdmFpbGFibGVfcGFja2FnZXNfYnlfZGF0ZS5odG1sIilbWzFdXVtbMl1dKWAgYXZhaWxhYmxlIHBhY2thZ2VzIGFzIG9mIGByIGRhdGUoKWAKLSBEb3dubG9hZCBmcm9tIGh0dHA6Ly9taXJyb3JzLmViaS5hYy51ay9DUkFOLwotIFdpbmRvd3MsIE1hYyBhbmQgTGludXggdmVyc2lvbnMgYXZhaWxhYmxlCi0gRXhlY3V0ZWQgdXNpbmcgY29tbWFuZCBsaW5lLCBvciBhIGdyYXBoaWNhbCB1c2VyIGludGVyZmFjZSAoR1VJKQotIE9uIHRoaXMgY291cnNlLCB3ZSB1c2UgdGhlIFJTdHVkaW8gR1VJICh3d3cucnN0dWRpby5jb20pCgohW3JzdHVkaW9dKGh0dHA6Ly93d3cucnN0dWRpby5jb20vd3AtY29udGVudC91cGxvYWRzLzIwMTQvMDMvYmx1ZS0xMjUucG5nKSAKICAgIAoKVG8gbGF1bmNoIFJTdHVkaW8sIGZpbmQgdGhlIFJTdHVkaW8gaWNvbiBhbmQgY2xpY2sKCiFbUlN0dWRpbyBzY3JlZW5zaG90XShpbWFnZXMvcnN0dWRpby13aW5kb3dzLnBuZykKCgoKCi0gVGhlIHRyYWRpdGlvbmFsIHdheSB0byBlbnRlciBSIGNvbW1hbmRzIGlzIHZpYSB0aGUgVGVybWluYWwsIG9yIHVzaW5nIHRoZSBjb25zb2xlIGluIFJTdHVkaW8gKGJvdHRvbS1sZWZ0KQotIEhvd2V2ZXIsIGZvciB0aGlzIGNvdXJzZSB3ZSB3aWxsIHVzZSBhIHJlbGF0aXZlbHkgbmV3IGZlYXR1cmUgY2FsbGVkICpSLW5vdGVib29rcyouCi0gQW4gUi1ub3RlYm9vayBtaXhlcyBwbGFpbiB0ZXh0IHdpdGggUiBjb2RlCiAgICArIFRoZSBSIGNvZGUgY2FuIGJlIHJ1biBmcm9tIGluc2lkZSB0aGUgZG9jdW1lbnQgYW5kIHRoZSByZXN1bHRzIGFyZSBkaXNwbGF5ZWQgZGlyZWN0bHkgdW5kZXJuZWF0aAotIEVhY2ggKmNodW5rKiBvZiBSIGNvZGUgbG9va3Mgc29tZXRoaW5nIGxpa2UgdGhpcy4gCi0gRWFjaCBsaW5lIG9mIFIgY2FuIGJlIGV4ZWN1dGVkIGJ5IGNsaWNraW5nIG9uIHRoZSBsaW5lIGFuZCBwcmVzc2luZyBDVFJMIGFuZCBFTlRFUgotIE9yIHlvdSBjYW4gcHJlc3MgdGhlIGdyZWVuIHRyaWFuZ2xlIG9uIHRoZSByaWdodC1oYW5kIHNpZGUgdG8gcnVuIGV2ZXJ5dGhpbmcgaW4gdGhlIGNodW5rCi0gVHJ5IHRoaXMgbm93IQoKYGBge3J9CnByaW50KCJIZWxsbyBXb3JsZCIpCgpgYGAKCi0gVGhlIFIgbm90ZWJvb2sgY2FuIGJlIHJlbmRlcmVkIGludG8gYSBmb3JtYXQgc3VjaCBhcyBQREYgb3IgSFRNTCBzbyB0aGV5IGNhbiBiZSBzaGFyZWQgd2l0aCB5b3VyIGNvbGxhYm9yYXRvcnMKLSBPbiB0aGUgY291cnNlIHdlYnNpdGUgeW91IHdpbGwgc2VlIGNvbXBpbGVkIHZlcnNpb25zIG9mIGVhY2ggc2Vzc2lvbgoKIyNCYXNpYyBjb25jZXB0cyBpbiBSIC0gc2ltcGxlIGFyaXRobWV0aWMKCi0gVGhlIGNvbW1hbmQgbGluZSBjYW4gYmUgdXNlZCBhcyBhIGNhbGN1bGF0b3IgYW5kIHVuZGVyc3RhbmRzIHRoZSB1c3VhbCBhcml0aG1ldGljIG9wZXJhdG9ycyArLCAtLCAqLCAvIAotIFRyeSBhZGRpbmcgYSBmZXcgbW9yZSBjYWxjdWxhdGlvbnMgaGVyZQoKYGBge3J9CjIgKyAyCjIgLSAyCjQgKiAzCjEwIC8gMgoKCmBgYAoKTm90ZTogVGhlIG51bWJlciBpbiB0aGUgc3F1YXJlIGJyYWNrZXRzIGlzIGFuIGluZGljYXRvciBvZiB0aGUKcG9zaXRpb24gaW4gdGhlIG91dHB1dC4gSW4gdGhpcyBjYXNlIHRoZSBvdXRwdXQgaXMgYSAndmVjdG9yJyBvZiBsZW5ndGggMQooaS5lLiBhIHNpbmdsZSBudW1iZXIpLiBNb3JlIG9uIHZlY3RvcnMgY29taW5nIHVwLi4uCgoKSW4gdGhlIGNhc2Ugb2YgZXhwcmVzc2lvbnMgaW52b2x2aW5nIG11bHRpcGxlIG9wZXJhdGlvbnMsIFIgcmVzcGVjdHMgdGhlIFtCT0RNQVNdKGh0dHBzOi8vZW4ud2lraXBlZGlhLm9yZy93aWtpL09yZGVyX29mX29wZXJhdGlvbnMjTW5lbW9uaWNzKSBzeXN0ZW0gdG8gZGVjaWRlIHRoZSBvcmRlciBpbiB3aGljaCBvcGVyYXRpb25zIHNob3VsZCBiZSBwZXJmb3JtZWQuCgpgYGB7cn0KMiArIDIgKjMKMiArICgyICogMykKKDIgKyAyKSAqIDMKYGBgCgpSIGlzIGNhcGFibGUgb2YgbW9yZSBjb21wbGljYXRlZCBhcml0aG1ldGljIHN1Y2ggYXMgdHJpZ29ub21ldHJ5IGFuZCBsb2dhcml0aG1zOyBsaWtlIHlvdSB3b3VsZCBmaW5kIG9uIGEgZmFuY3kgc2NpZW50aWZpYyBjYWxjdWxhdG9yLiBPZiBjb3Vyc2UsIFIgYWxzbyBoYXMgYSBwbGV0aG9yYSBvZiBzdGF0aXN0aWNhbCBvcGVyYXRpb25zIGFzIHdlIHdpbGwgc2VlLgoKCmBgYHtyfQpwaQpzaW4gKHBpLzIpCmNvcyhwaSkKdGFuKDIpCmxvZygxKQoKCmBgYAoKV2UgY2FuIG9ubHkgZ28gc28gZmFyIHdpdGggcGVyZm9ybWluZyBzaW1wbGUgY2FsY3VsYXRpb25zIGxpa2UgdGhpcy4gRXZlbnR1YWxseSB3ZSB3aWxsIG5lZWQgdG8gc3RvcmUgb3VyIHJlc3VsdHMgZm9yIGxhdGVyIHVzZS4gRm9yIHRoaXMsIHdlIG5lZWQgdG8gbWFrZSB1c2Ugb2YgKnZhcmlhYmxlcyouCgoKIyNCYXNpYyBjb25jZXB0cyBpbiBSIC0gdmFyaWFibGVzCgotIEEgdmFyaWFibGUgaXMgYSBsZXR0ZXIgb3Igd29yZCB3aGljaCB0YWtlcyAob3IgY29udGFpbnMpIGEgdmFsdWUuIFdlIHVzZSB0aGUgKiphc3NpZ25tZW50IG9wZXJhdG9yOiBgPC1gKioKYGBge3J9CnggPC0gMTAKeApteU51bWJlciA8LSAyNQpteU51bWJlcgpgYGAKCi0gV2UgY2FuIHBlcmZvcm0gYXJpdGhtZXRpYyBvbiB2YXJpYWJsZXM6CmBgYHtyfQpzcXJ0KG15TnVtYmVyKQpgYGAKCgotIFdlIGNhbiBhZGQgdmFyaWFibGVzIHRvZ2V0aGVyOgpgYGB7cn0KeCArIG15TnVtYmVyCmBgYAoKLSBXZSBjYW4gY2hhbmdlIHRoZSB2YWx1ZSBvZiBhbiBleGlzdGluZyB2YXJpYWJsZToKCmBgYHtyfQp4IDwtIDIxCngKYGBgCgoKLSBXZSBjYW4gc2V0IG9uZSB2YXJpYWJsZSB0byBlcXVhbCB0aGUgdmFsdWUgb2YgYW5vdGhlciB2YXJpYWJsZToKYGBge3J9CnggPC0gbXlOdW1iZXIKeApgYGAKCi0gV2UgY2FuIG1vZGlmeSB0aGUgY29udGVudHMgb2YgYSB2YXJpYWJsZToKCmBgYHtyfQpteU51bWJlciA8LSBteU51bWJlciArIHNxcnQoMTYpCm15TnVtYmVyCmBgYAoKV2hlbiB3ZSBhcmUgZmVlbGluZyBsYXp5IHdlIG1pZ2h0IGdpdmUgb3VyIHZhcmlhYmxlcyBzaG9ydCBuYW1lcyAoYHhgLCBgeWAsIGBpYC4uLmV0YyksIGJ1dCBhIGJldHRlciBwcmFjdGljZSB3b3VsZCBiZSB0byBnaXZlIHRoZW0gbWVhbmluZ2Z1bCBuYW1lcy4gVGhlcmUgYXJlIHNvbWUgcmVzdHJpY3Rpb25zIG9uIGNyZWF0aW5nIHZhcmlhYmxlIG5hbWVzLiBUaGV5IGNhbm5vdCBzdGFydCB3aXRoIGEgbnVtYmVyIG9yIGNvbnRhaW4gY2hhcmFjdGVycyBzdWNoIGFzIGAuYCwgYF9gLCAnLScuIE5hbWluZyB2YXJpYWJsZXMgdGhlIHNhbWUgYXMgaW4tYnVpbHQgZnVuY3Rpb25zIGluIFIsIHN1Y2ggYXMgYGNgLCBgVGAsIGBtZWFuYCBzaG91bGQgYWxzbyBiZSBhdm9pZGVkLgoKTmFtaW5nIHZhcmlhYmxlcyBpcyBhIG1hdHRlciBvZiB0YXN0ZS4gU29tZSBbY29udmVudGlvbnNdKGh0dHA6Ly9hZHYtci5oYWQuY28ubnovU3R5bGUuaHRtbCkgZXhpc3Qgc3VjaCBhcyBhIHNlcGFyYXRpbmcgd29yZHMgd2l0aCBgLWAgb3IgdXNpbmcgKkMqYW1lbCpDKmFwcy4gV2hhdGV2ZXIgY29udmVudGlvbiB5b3UgZGVjaWRlZCwgc3RpY2sgd2l0aCBpdCEKCiMjQmFzaWMgY29uY2VwdHMgaW4gUiAtIGZ1bmN0aW9ucwoKLSAqKkZ1bmN0aW9ucyoqIGluIFIgcGVyZm9ybSBvcGVyYXRpb25zIG9uICoqYXJndW1lbnRzKiogKHRoZSBpbnB1dHMocykgdG8gdGhlIGZ1bmN0aW9uKS4gV2UgaGF2ZSBhbHJlYWR5IHVzZWQ6CmBgYHtyfQpzaW4oeCkKYGBgCgotIFRoaXMgcmV0dXJucyB0aGUgc2luZSBvZiB4CiAgICAgKyBJbiB0aGlzIGNhc2UgdGhlIGZ1bmN0aW9uIGhhcyBvbmUgYXJndW1lbnQ6ICoqeCoqLiAKICAgICArIEFyZ3VtZW50cyBhcmUgYWx3YXlzIGNvbnRhaW5lZCBpbiBwYXJlbnRoZXNlcyAtLSBjdXJ2ZWQgYnJhY2tldHMsICoqKCkqKiAtLSBzZXBhcmF0ZWQgYnkgY29tbWFzLgogICAgIAogICAgIApBcmd1bWVudHMgY2FuIGJlIG5hbWVkIG9yIHVubmFtZWQsIGJ1dCBpZiB0aGV5IGFyZSB1bm5hbWVkIHRoZXkgbXVzdCBiZSBvcmRlcmVkICh3ZSB3aWxsIHNlZSBsYXRlciBob3cgdG8gZmluZCB0aGUgcmlnaHQgb3JkZXIpLiBUaGUgbmFtZXMgb2YgdGhlIGFyZ3VtZW50cyBhcmUgZGV0ZXJtaW5lZCBieSB0aGUgYXV0aG9yIG9mIHRoZSBmdW5jdGlvbiBhbmQgY2FuIGJlIGZvdW5kIGluIHRoZSBoZWxwIHBhZ2UgZm9yIHRoZSBmdW5jdGlvbi4gV2hlbiB0ZXN0aW5nIGNvZGUsIGl0IGlzIGVhc2llciBhbmQgc2FmZXIgdG8gbmFtZSB0aGUgYXJndW1lbnRzLiAKCmBzZXFgIGlzIGEgZnVuY3Rpb24gZm9yIGdlbmVyYXRpbmcgYSBudW1lcmljIHNlcXVlbmNlICpmcm9tKiBhbmQgKnRvKiBwYXJ0aWN1bGFyIG51bWJlcnMuIAoKLSBUeXBlIGA/c2VxYCB0byBnZXQgdGhlIGhlbHAgcGFnZSBmb3IgdGhpcyBmdW5jdGlvbi4KLSBXaGVuIHRlc3RpbmcgY29kZSwgaXQgaXMgZWFzaWVyIGFuZCBzYWZlciB0byBuYW1lIHRoZSBhcmd1bWVudHMKCmBgYHtyfQpzZXEoZnJvbSA9IDIsIHRvID0gMjAsIGJ5ID0gNCkKc2VxKDIsIDIwLCA0KQpgYGAKCkFyZ3VtZW50cyBjYW4gaGF2ZSAqZGVmYXVsdCogdmFsdWVzLCBtZWFuaW5nIHdlIGRvIG5vdCBuZWVkIHRvIHNwZWNpZnkgdmFsdWVzIGZvciB0aGVzZSBpbiBvcmRlciB0byBydW4gdGhlIGZ1bmN0aW9uLgoKYHJub3JtYCBpcyBhIGZ1bmN0aW9uIHRoYXQgd2lsbCBnZW5lcmF0ZSBhIHNlcmllcyBvZiB2YWx1ZXMgZnJvbSBhICpub3JtYWwgZGlzdHJpYnV0aW9uKi4gSW4gb3JkZXIgdG8gdXNlIHRoZSBmdW5jdGlvbiwgd2UgbmVlZCB0byB0ZWxsIFIgaG93IG1hbnkgdmFsdWVzIHdlIHdhbnQKCmBgYHtyfQpybm9ybShuPTEwKQpgYGAKClRoZSBub3JtYWwgZGlzdHJpYnV0aW9uIGlzIGRlZmluZWQgYnkgYSAqbWVhbiogKGF2ZXJhZ2UpIGFuZCAqc3RhbmRhcmQgZGV2aWF0aW9uKiAoc3ByZWFkKS4gSG93ZXZlciwgaW4gdGhlIGFib3ZlIGV4YW1wbGUgd2UgZGlkbid0IHRlbGwgUiB3aGF0IG1lYW4gYW5kIHN0YW5kYXJkIGRldmlhdGlvbiB3ZSB3YW50ZWQuIFNvIGhvdyBkb2VzIFIga25vdyB3aGF0IHRvIGRvPyBBbGwgYXJndW1lbnRzIHRvIGEgZnVuY3Rpb24gYW5kIHRoZWlyIGRlZmF1bHQgdmFsdWVzIGFyZSBsaXN0ZWQgaW4gdGhlIGhlbHAgcGFnZQoKKCpOLkIgc29tZXRpbWVzIGhlbHAgcGFnZXMgY2FuIGRlc2NyaWJlIG1vcmUgdGhhbiBvbmUgZnVuY3Rpb24qKQoKYGBge3J9Cj9ybm9ybQpgYGAKCkluIHRoaXMgY2FzZSwgd2Ugc2VlIHRoYXQgdGhlIGRlZmF1bHRzIGZvciBtZWFuIGFuZCBzdGFuZGFyZCBkZXZpYXRpb24gYXJlIDAgYW5kIDEuIFdlIGNhbiBjaGFuZ2UgdGhlIGZ1bmN0aW9uIHRvIGdlbmVyYXRlIHZhbHVlcyBmcm9tIGEgZGlzdHJpYnV0aW9uIHdpdGggYSBkaWZmZXJlbnQgbWVhbiBhbmQgc3RhbmRhcmQgZGV2aWF0aW9uIHVzaW5nIHRoZSBgbWVhbmAgYW5kIGBzZGAgKmFyZ3VtZW50cyouIEl0IGlzIGltcG9ydGFudCB0aGF0IHdlIGdldCB0aGUgc3BlbGxpbmcgb2YgdGhlc2UgYXJndW1lbnRzIGV4YWN0bHkgcmlnaHQsIG90aGVyd2lzZSBSIHdpbGwgYW4gZXJyb3IgbWVzc2FnZSwgb3IgKHdvcnNlPykgZG8gc29tZXRoaW5nIHVuZXhwZWN0ZWQuCgpgYGB7cn0Kcm5vcm0obj0xMCwgbWVhbj0yLHNkPTMpCnJub3JtKDEwLCAyLCAzKQpgYGAKCkluIHRoZSBleGFtcGxlcyBhYm92ZSwgYHNlcWAgYW5kIGBybm9ybWAgd2VyZSBib3RoIG91dHB1dHRpbmcgYSBzZXJpZXMgb2YgbnVtYmVycywgd2hpY2ggaXMgY2FsbGVkIGEgKnZlY3RvciogaW4gUiBhbmQgaXMgdGhlIG1vc3QtZnVuZGFtZW50YWwgZGF0YS10eXBlLgoKCgojI0Jhc2ljIGNvbmNlcHRzIGluIFIgLSB2ZWN0b3JzCgotIFRoZSBiYXNpYyBkYXRhIHN0cnVjdHVyZSBpbiBSIGlzIGEgKip2ZWN0b3IqKiAtLSBhbiBvcmRlcmVkIGNvbGxlY3Rpb24gb2YgdmFsdWVzLiAKLSBSIHRyZWF0cyBldmVuIHNpbmdsZSB2YWx1ZXMgYXMgMS1lbGVtZW50IHZlY3RvcnMuIAotIFRoZSBmdW5jdGlvbiAqKmBjYCoqICpjb21iaW5lcyogaXRzIGFyZ3VtZW50cyBpbnRvIGEgdmVjdG9yOgoKYGBge3J9CnggPC0gYygzLDQsNSw2KQp4CmBgYAotIFRoZSBzcXVhcmUgYnJhY2tldHMgYFtdYCBpbmRpY2F0ZSB0aGUgcG9zaXRpb24gd2l0aGluIHRoZSB2ZWN0b3IgKHRoZSAqKippbmRleCoqKikuCi0gV2UgY2FuIGV4dHJhY3QgaW5kaXZpZHVhbCBlbGVtZW50cyBieSB1c2luZyB0aGUgYFtdYCBub3RhdGlvbjoKCmBgYHtyfQp4WzFdCnhbNF0KCmBgYAoKLSBXZSBjYW4gZXZlbiBwdXQgYSB2ZWN0b3IgaW5zaWRlIHRoZSBzcXVhcmUgYnJhY2tldHMgKCp2ZWN0b3IgaW5kZXhpbmcqKToKLSAqKkJlZm9yZSBleGVjdXRpbmcgdGhpcyBsaW5lIG9mIGNvZGUsIHdoYXQgZG8geW91IHRoaW5rIGl0IHdpbGwgcHJvZHVjZT8qKgoKYGBge3J9CnkgPC0gYygyLDMpCnhbeV0KYGBgCgotIFRoZXJlIGFyZSBhIG51bWJlciBvZiBzaG9ydGN1dHMgdG8gY3JlYXRlIGEgdmVjdG9yLiAKLSBJbnN0ZWFkIG9mOgoKYGBge3J9CnggPC0gYygzLCA0LCA1LCA2LCA3LCA4LCA5LCAxMCwgMTEsIDEyKQp4CmBgYAotIHdlIGNhbiB3cml0ZToKCmBgYHtyfQp4IDwtIDM6MTIKeApgYGAKCi0gb3Igd2UgY2FuIHVzZSB0aGUgKipgc2VxKClgKiogZnVuY3Rpb24sIHdoaWNoIHJldHVybnMgYSB2ZWN0b3I6CgpgYGB7cn0KeCA8LSBzZXEoMiwgMjAsIDQpCngKYGBgCgpgYGB7cn0KeCA8LSBzZXEoMiwgMjAsIGxlbmd0aC5vdXQ9NSkKeApgYGAKCi0gb3Igd2UgY2FuIHVzZSB0aGUgKipgcmVwKClgKiogZnVuY3Rpb246CgoKYGBge3J9CnkgPC0gcmVwKDMsIDUpCnkKYGBgCgpgYGB7cn0KeSA8LSByZXAoMTozLCA1KQp5CmBgYAoKCi0gV2UgaGF2ZSBzZWVuIHNvbWUgd2F5cyBvZiBleHRyYWN0aW5nIGVsZW1lbnRzIG9mIGEgdmVjdG9yLiBXZSBjYW4gdXNlIHRoZXNlIHNob3J0Y3V0cyB0byBtYWtlIHRoaW5ncyBlYXNpZXIgKG9yIG1vcmUgY29tcGxleCEpCgpgYGB7cn0KeCA8LSAzOjEyCiMgRXh0cmFjdCBlbGVtZW50cyBmcm9tIHg6Cgp4WzM6N10KeFtzZXEoMiwgNiwgMildCnhbcmVwKDMsIDIpXQpgYGAKCgotIFdlIGNhbiBhZGQgYW4gZWxlbWVudCB0byBhIHZlY3RvcjoKCmBgYHtyfQp5IDwtIGMoeCwgMSkKeQpgYGAKCi0gV2UgY2FuIGdsdWUgdmVjdG9ycyB0b2dldGhlcjoKCmBgYHtyfQp6IDwtIGMoeCwgeSkKegpgYGAKCi0gV2UgY2FuICJyZW1vdmUiIGVsZW1lbnQocykgZnJvbSBhIHZlY3RvcjoKICAgICsgTk9URTogdGhlIHZlY3RvciB4IGRvZXNuJ3QgZ2V0IG1vZGlmaWVkCiAgICArIHdlJ3JlIGp1c3QgZGlzcGxheWluZyB3aGF0IHRoZSB2ZWN0b3IgbG9va3MgbGlrZSB3aXRob3V0IHBhcnRpY3VsYXIgZWxlbWVudHMKICAgIApgYGB7cn0KeCA8LSAzOjEyCgp4Wy0zXQp4Wy0oNTo3KV0KeFstc2VxKDIsIDYsIDIpXQp4CmBgYAoKLSBGaW5hbGx5LCB3ZSBjYW4gbW9kaWZ5IHRoZSBjb250ZW50cyBvZiBhIHZlY3RvcjoKCmBgYHtyfQp4WzZdIDwtIDQKeAoKeFszOjVdIDwtIDEKeApgYGAKCioqUmVtZW1iZXIhKioKCiAtICoqU3F1YXJlKiogYnJhY2tldHMgWyBdIGZvciAqKippbmRleGluZyoqKgogLSAqKlBhcmVudGhlc2VzKiogKCkgZm9yIGZ1bmN0aW9uICoqKmFyZ3VtZW50cyoqKgoKIyNCYXNpYyBjb25jZXB0cyBpbiBSIC0gdmVjdG9yIGFyaXRobWV0aWMKCi0gV2hlbiBhcHBseWluZyBhbGwgc3RhbmRhcmQgYXJpdGhtZXRpYyBvcGVyYXRpb25zIHRvIHZlY3RvcnMsCmFwcGxpY2F0aW9uIGlzIGVsZW1lbnQtd2lzZQoKYGBge3J9CnggPC0gMToxMAp5IDwtIHgqMgpgYGAKCmBgYHtyfQp5CmBgYAoKYGBge3J9CnogPC0geF4yCmBgYAoKYGBge3J9CnoKYGBgCgotIEFkZGluZyB0d28gdmVjdG9yczoKCmBgYHtyfQp5ICsgegpgYGAKCi0gSWYgdmVjdG9ycyBhcmUgbm90IHRoZSBzYW1lIGxlbmd0aCwgdGhlIHNob3J0ZXIgb25lIHdpbGwgYmUgcmVjeWNsZWQ6CgpgYGB7cn0KeCArIDE6MgpgYGAKCi0gQnV0IGJlIGNhcmVmdWwgaWYgdGhlIHZlY3RvciBsZW5ndGhzIGFyZW4ndCBmYWN0b3JzIG9mIGVhY2ggb3RoZXI6CgpgYGB7cn0KeCArIDE6MwpgYGAKCi0gU29tZXRpbWVzIFIgd2lsbCBnaXZlIGEgKndhcm5pbmcqIG1lc3NhZ2UuIEl0IGhhcyBwZXJmb3JtZWQgdGhlIGNhbGN1bGF0aW9uIHlvdSBhc2tlZCBpdCB0bywgYnV0IHRoZSByZXN1bHRzIG1heSBiZSB1bmV4cGVjdGVkLiBZb3UgbmVlZCB0byBjaGVjayB0aGUgb3V0cHV0IGNhcmVmdWxseSB0byBtYWtlIHN1cmUgaXQgaXMgd2hhdCB5b3UgcmVhbGx5IHdhbnRlZC4KCiMjQmFzaWMgY29uY2VwdHMgaW4gUiAtIENoYXJhY3RlciB2ZWN0b3JzIGFuZCBuYW1pbmcKCi0gQWxsIHRoZSB2ZWN0b3JzIHdlIGhhdmUgc2VlbiBzbyBmYXIgaGF2ZSBjb250YWluZWQgbnVtYmVycywgYnV0IHdlIGNhbiBhbHNvIHN0b3JlIHRleHQgKC8ic3RyaW5ncyIpIGluIHZlY3RvcgogICAgKyB0aGlzIGlzIGNhbGxlZCBhICoqY2hhcmFjdGVyKiogdmVjdG9yLgoKYGBge3J9CmdlbmUubmFtZXMgPC0gYygiUGF4NiIsICJCZXRhLWFjdGluIiwgIkZveFAyIiwgIkhveDkiKQpnZW5lLm5hbWVzCmBgYAoKLSBXZSBjYW4gbmFtZSBlbGVtZW50cyBvZiB2ZWN0b3JzIHVzaW5nIHRoZSBgbmFtZXMoKWAgZnVuY3Rpb24sIHdoaWNoIGNhbiBiZSB1c2VmdWwgdG8ga2VlcCB0cmFjayBvZiB0aGUgbWVhbmluZyBvZiBvdXIgZGF0YToKCmBgYHtyfQpnZW5lLmV4cHJlc3Npb24gPC0gYygwLCAzLjIsIDEuMiwgLTIpCm5hbWVzKGdlbmUuZXhwcmVzc2lvbikgPC0gZ2VuZS5uYW1lcwpnZW5lLmV4cHJlc3Npb24KCmBgYAoKLSBXZSBjYW4gYWxzbyB1c2UgdGhlIGBuYW1lcygpYCBmdW5jdGlvbiB0byBnZXQgYSB2ZWN0b3Igb2YgdGhlIG5hbWVzIG9mIGFuIG9iamVjdDoKYGBge3J9Cm5hbWVzKGdlbmUuZXhwcmVzc2lvbikKYGBgCgoKIyNFeGVyY2lzZTogQm9keS1NYXNzIEluZGV4Ci0gTGV0J3MgdHJ5IHNvbWUgdmVjdG9yIGFyaXRobWV0aWMuIEhlcmUgYXJlIHRoZSB3ZWlnaHRzIGFuZCBoZWlnaHRzIG9mIGZpdmUgaW5kaXZpZHVhbHMKCnxQZXJzb24gfCBXZWlnaHQgKGtnKSB8IEhlaWdodCAoY20pfAp8LS0tLS0tLXwtLS0tLS0tLS0tLS0tLS0tLS06fC0tLS0tLS0tLS0tLS0tLS0tLS06fAp8KkpvKiAgICAgfCAgICA2NS44ICAgICAgICAgICB8ICAgICAxOTIgICAgICAgICAgfAp8KlNhbSogICAgfCAgICA2Ny45ICAgICAgICAgICB8ICAgICAxNzkgICAgICAgICAgfAp8KkNoYXJsaWUqfCAgICA3NS4zICAgICAgICAgICB8ICAgICAxNjkgICAgICAgICAgfAp8KkZyYW5raWUqfCAgICA2MS45ICAgICAgICAgICB8ICAgICAxNzUgICAgICAgICAgfAp8KkFsZXgqICAgfCAgICA5Mi40ICAgICAgICAgICB8ICAgICAxNzEgICAgICAgICAgfAoKCi0gQ3JlYXRlICp3ZWlnaHQqIGFuZCAqaGVpZ2h0KiB2ZWN0b3JzIHRvIGhvbGQgdGhlIGRhdGEgaW4gZWFjaCBjb2x1bW4gdXNpbmcgdGhlIGBjYCBmdW5jdGlvbi4gQ3JlYXRlIGEgKnBlcnNvbiogdmVjdG9yIGFuZCB1c2UgdGhpcyB2ZWN0b3IgdG8gbmFtZSB0aGUgdmFsdWVzIGluIHRoZSBvdGhlciB0d28gdmVjdG9ycy4KCjEuIFRoZSBib2R5LW1hc3MgaW5kZXggaXMgZ2l2ZW4gYnkgdGhlIGZvcm11bGE6LSAkQk1JID0gKFdlaWdodCkvKEhlaWdodF4yKSQ7IHdoZXJlIEhlaWdodCBpcyBnaXZlbiBpbiAqKiptZXRyZXMqKioKICAgICsgQ3JlYXRlIGEgbmV3IHZlY3RvciB0byByZWNvcmQgdGhpcywgY2FsbGVkIGBibWlgLgoyLiBDcmVhdGUgYSBuZXcgdmVjdG9yIGBibWkuc29ydGVkYCB3aGVyZSB0aGUgYm1pIHZhbHVlcyBhcmUgcHV0IGluIGluY3JlYXNpbmcgbnVtZXJpYyBvcmRlciAoSElOVDogbG9vayB1cCB0aGUgaGVscCBvbiB0aGUgYHNvcnRgIGZ1bmN0aW9uKQozLiBUaGUgaW50ZXJxdWFydGlsZSByYW5nZSAoSVFSKSBvZiBhIHZlY3RvciBpcyBkZWZpbmVkIGFzIHRoZSA3NSUgcGVyY2VudGlsZSBvZiB0aGUgZGF0YSBtaW51cyB0aGUgMjUlIHBlcmNlbnRpbGUuIENhbGN1bGF0ZSB0aGUgSVFSIGZvciBvdXIgYm1pIHZhbHVlcyAKICAgICsgY2hlY2sgeW91ciBhbnN3ZXIgdXNpbmcgdGhlIGBJUVJgIGZ1bmN0aW9uCiAgICAKICAgIApgYGB7cn0KIyMjIFlPVVIgQU5TV0VSIEhFUkUgKHBsZWFzZSkgIyMjCgpgYGAKCgoKCiMjR2V0dGluZyBoZWxwCgotICoqVGhpcyBpcyBwb3NzaWJseSB0aGUgbW9zdCBpbXBvcnRhbnQgc2xpZGUgaW4gdGhlIHdob2xlIGNvdXJzZSE/ISoqCi0gVG8gZ2V0IGhlbHAgb24gYW55IFIgZnVuY3Rpb24sIHR5cGUgKipgP2AqKiBmb2xsb3dlZCBieSB0aGUgZnVuY3Rpb24gbmFtZS4gRm9yIGV4YW1wbGU6CmBgYHtyfQo/c2VxCmBgYAotIFRoaXMgcmV0cmlldmVzIHRoZSBzeW50YXggYW5kIGFyZ3VtZW50cyBmb3IgdGhlIGZ1bmN0aW9uLiBUaGUgaGVscCBwYWdlIHNob3dzIHRoZSBkZWZhdWx0IG9yZGVyIG9mIGFyZ3VtZW50cy4gSXQgYWxzbyB0ZWxscyB5b3Ugd2hpY2ggKnBhY2thZ2UqIGl0IGJlbG9uZ3MgdG8uCi0gVGhlcmUgaXMgdHlwaWNhbGx5IGEgdXNhZ2UgZXhhbXBsZSwgd2hpY2ggeW91IGNhbiB0ZXN0IHVzaW5nIHRoZQpgZXhhbXBsZWAgZnVuY3Rpb246CgpgYGB7cn0KZXhhbXBsZShzZXEpCmBgYAoKLSBJZiB5b3UgY2FuJ3QgcmVtZW1iZXIgdGhlIGV4YWN0IG5hbWUsIHR5cGUgKipgPz9gKiogZm9sbG93ZWQgYnkgeW91ciBndWVzcy4KUiB3aWxsIHJldHVybiBhIGxpc3Qgb2YgcG9zc2liaWxpdGllczoKCmBgYHtyfQo/P21lYW4KYGBgCgotIFRoZSAqKlBhY2thZ2VzKiogdGFiIGluIHRoZSBsb3dlci1yaWdodCBwYW5lbCBvZiBSU3R1ZGlvIHdpbGwgaGVscCB5b3UgbG9jYXRlIHRoZSBoZWxwIHBhZ2VzIGZvciBhIHBhcnRpY3VsYXIgcGFja2FnZSBhbmQgaXRzIGZ1bmN0aW9ucwogICAgKyBPZnRlbiB0aGVyZSB3aWxsIGJlIGEgdXNlci1ndWlkZSBvciAnKnZpZ25ldHRlKicgdG9vCgojIyBSIHBhY2thZ2VzCgotIFIgY29tZXMgcmVhZHkgbG9hZGVkIHdpdGggdmFyaW91cyBsaWJyYXJpZXMgb2YgZnVuY3Rpb25zIGNhbGxlZAoqKnBhY2thZ2VzKiouIEZvciBleGFtcGxlOiB0aGUgZnVuY3Rpb24gKipgc3VtKClgKiogaXMgaW4gdGhlICoqYmFzZSoqIHBhY2thZ2UgYW5kCioqYHNkKClgKiosIHdoaWNoIGNhbGN1bGF0ZXMgdGhlIHN0YW5kYXJkIGRldmlhdGlvbiBvZiBhIHZlY3RvciwgaXMgaW4gdGhlCioqYHN0YXRzYCoqIHBhY2thZ2UKLSBUaGVyZSBhcmUgMTAwMHMgb2YgYWRkaXRpb25hbCBwYWNrYWdlcyBwcm92aWRlZCBieSB0aGlyZCBwYXJ0aWVzLAphbmQgdGhlIHBhY2thZ2VzIGNhbiBiZSBmb3VuZCBpbiBudW1lcm91cyBzZXJ2ZXIgbG9jYXRpb25zIG9uIHRoZQp3ZWIgY2FsbGVkICoqcmVwb3NpdG9yaWVzKioKLSBUaGUgdHdvIHJlcG9zaXRvcmllcyB5b3Ugd2lsbCBjb21lIGFjcm9zcyB0aGUgbW9zdCBhcmU6CiAgICArICoqVGhlIENvbXByZWhlbnNpdmUgUiBBcmNoaXZlIE5ldHdvcmsgKENSQU4pKioKICAgICAgICArIFVzZSBtZXRhY3JhbiBzZWFyY2ggdG8gZmluZCBmdW5jdGlvbmFsaXR5IHlvdSBuZWVkOiBodHRwOi8vd3d3LnItcGtnLm9yZy8KICAgICAgICArIE9yIGxvb2sgZm9yIHBhY2thZ2VzIGJ5IHRoZW1lOiBodHRwOi8vY3Jhbi5yLXByb2plY3Qub3JnL3dlYi92aWV3cy8KICAgICsgKipCaW9jb25kdWN0b3IqKiBzcGVjaWFsaXNlZCBpbiBnZW5vbWljczogaHR0cDovL3d3dy5iaW9jb25kdWN0b3Iub3JnL3BhY2thZ2VzL3JlbGVhc2UvYmlvYy8KICAgICsgKipodHRwcy8vZ2l0aHViLmNvbSoqIGNhbiBhbHNvIGhvc3QgUiBwYWNrYWdlcywgYW5kIGhvc3RzIHRoZSBkZXZlbG9wbWVudCB2ZXJzaW9uIG9mIG1hbnkgcGFja2FnZXMKLSBCb3R0b21saW5lOiAqKiphbHdheXMqKiogZmlyc3QgbG9vayBpZiB0aGVyZSBpcyBhbHJlYWR5IGFuIFIgcGFja2FnZSB0aGF0IGRvZXMgd2hhdCB5b3Ugd2FudCBiZWZvcmUgdHJ5aW5nIHRvIGltcGxlbWVudCBpdCB5b3Vyc2VsZgogICAgCiMjIEluc3RhbGxpbmcgcGFja2FnZXMgICAgCiAgICAKLSBDUkFOIHBhY2thZ2VzIGNhbiBiZSBpbnN0YWxsZWQgdXNpbmcgKipgaW5zdGFsbC5wYWNrYWdlcygpYCoqCgogICAgKyBvciBjbGlja2luZyBvbiB0aGUgKlBhY2thZ2VzKiB0YWIgaW4gUlN0dWRpbwoKYGBge3IgZXZhbD1GQUxTRX0KaW5zdGFsbC5wYWNrYWdlcyhuYW1lLm9mLm15LnBhY2thZ2UpCmBgYAoKCi0gU2V0IHRoZSAqQmlvY29uZHVjdG9yKiBwYWNrYWdlIGRvd25sb2FkIHRvb2wgYnkgdHlwaW5nOgpgYGB7ciBldmFsPUZBTFNFfQpzb3VyY2UoImh0dHA6Ly9iaW9jb25kdWN0b3Iub3JnL2Jpb2NMaXRlLlIiKQpgYGAKCi0gKkJpb2NvbmR1Y3RvciogcGFja2FnZXMgYXJlIHRoZW4gaW5zdGFsbGVkIHdpdGggdGhlIGBiaW9jTGl0ZSgpYCBmdW5jdGlvbjoKYGBge3IgZXZhbD1GQUxTRX0KYmlvY0xpdGUoIlBhY2thZ2VOYW1lIikKYGBgCgotIGdncGxvdDIgaXMgYSBjb21tb25seSB1c2VkIGdyYXBoaWNzIHBhY2thZ2U6CiAgICArIGluIFJTdHVkaW8sIGdvIHRvICoqVG9vbHMqKiDihpIgKipJbnN0YWxsIFBhY2thZ2VzKiouLi4gYW5kIHR5cGUgdGhlIHBhY2thZ2UgbmFtZQogICAgKyBvciB1c2UgYGluc3RhbGwucGFja2FnZXMoKWAgZnVuY3Rpb24gdG8gaW5zdGFsbCBpdDoKICAKYGBge3IgZXZhbD1GQUxTRX0KaW5zdGFsbC5wYWNrYWdlcygiZ2dwbG90MiIpCmBgYAogICAKLSBgREVTZXEyYCBpcyBhIEJpb2NvbmR1Y3RvciBwYWNrYWdlIChodHRwOi8vd3d3LmJpb2NvbmR1Y3Rvci5vcmcpIGZvciB0aGUgYW5hbHlzaXMgb2YgUk5BLXNlcSBkYXRhOgoKYGBge3IgZXZhbD1GQUxTRX0Kc291cmNlKCJodHRwOi8vd3d3LmJpb2NvbmR1Y3Rvci5vcmcvYmlvY0xpdGUuUiIpCmJpb2NMaXRlKCJERVNlcTIiKQpgYGAKCiMjRXhhbXBsZTogTG9hZCBwYWNrYWdlcyBnZ3Bsb3QyIGFuZCBERVNlcTIKCi0gUiBuZWVkcyB0byBiZSB0b2xkIHRvIHVzZSB0aGUgbmV3IGZ1bmN0aW9ucyBmcm9tIHRoZSBpbnN0YWxsZWQgcGFja2FnZXMuIFVzZSAqKmBsaWJyYXJ5KC4uLilgKiogZnVuY3Rpb24gdG8gbG9hZCB0aGUgbmV3bHkgaW5zdGFsbGVkIGZlYXR1cmVzOgoKYGBge3IgZXZhbD1GQUxTRX0KIApsaWJyYXJ5KGdncGxvdDIpICMgbG9hZHMgZ2dwbG90IGZ1bmN0aW9ucwpsaWJyYXJ5KERFU2VxMikgICAjIGxvYWRzIERFU2VxIGZ1bmN0aW9ucwpsaWJyYXJ5KCkgICAgICAgICMgTGlzdHMgYWxsIHRoZSBwYWNrYWdlcyAKICAgICAgICAgICAgICAgICAjIHlvdSd2ZSBnb3QgaW5zdGFsbGVkIApgYGAKCg==