diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 0000000..e69de29 diff --git a/404.html b/404.html new file mode 100644 index 0000000..a91bbfe --- /dev/null +++ b/404.html @@ -0,0 +1,120 @@ + + + + + + + + Lab note for UMD BIOI611 + + + + + + + + + + + + + +
+ + +
+ +
+
+
    +
  • +
  • +
  • +
+
+
+
+
+ + +

404

+ +

Page not found

+ + +
+
+ +
+
+ +
+ +
+ +
+ + + + Bix4UMD/BIOI611_lab + + + + + +
+ + + + + + + + + diff --git a/FASTQ_PHRED.ipynb b/FASTQ_PHRED.ipynb new file mode 100644 index 0000000..7232382 --- /dev/null +++ b/FASTQ_PHRED.ipynb @@ -0,0 +1,127 @@ +{ + "cells": [ + { + "cell_type": "raw", + "metadata": {}, + "source": [ + "---\n", + "title: \"PRED Score in Bioinformatics\"\n", + "format: \n", + " pptx:\n", + " reference-doc: template_UMD.pptx\n", + "editor: visual\n", + "---" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## What is PHRED Scores\n", + "\n", + "A Phred score is a measure of the probability that a base call in a DNA sequencing read is incorrect. It is a logarithmic scale, meaning that a small change in the Phred score represents a large change in the probability of an error.\n", + "\n", + "$$Q = -10 \\cdot \\log_{10}(P)$$\n", + "\n", + "Where:\n", + "\n", + "- Q is the PHRED score.\n", + "\n", + "- P is the probability that the base was called incorrectly.\n", + "\n", + "For example:\n", + "\n", + "- **Q = 20**: This corresponds to a 1 in 100 probability of an incorrect base call, or an accuracy of 99%.\n", + "\n", + "- **Q = 30**: This corresponds to a 1 in 1000 probability of an incorrect base call, or an accuracy of 99.9%.\n", + "\n", + "- **Q = 40**: This corresponds to a 1 in 10,000 probability of an incorrect base call, or an accuracy of 99.99%.\n", + "\n", + "```{r}\n", + "# Print the header\n", + "cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"Phred\", \"Prob of\"))\n", + "cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"score\", \"Incorrect call\"))\n", + "\n", + "# Loop through Phred scores from 0 to 41\n", + "for (phred in 0:41) {\n", + " cat(sprintf(\"%-5d\\t\\t%0.5f\\n\", phred, 10^(phred / -10)))\n", + "}\n", + "```\n", + "\n", + "## What is ASCII \n", + "\n", + "ASCII (American Standard Code for Information Interchange) is used to represent characters in computers. We can represent Phred scores using ASCII characters. The advantage is that the quality information can be esisly stored in text based FASTQ file.\n", + "\n", + "Not all [ASCII characters](https://www.columbia.edu/kermit/ascii.html) are printable. The first printable ASCII character is `!` and the decimal code for the character for `!` is 33. \n", + "\n", + "\n", + "```{r}\n", + "# Store output in a vector to fit on a slide\n", + "output <- c(sprintf(\"%-8s %-8s\", \"Character\", \"ASCII #\"))\n", + "\n", + "# Loop through ASCII values from 33 to 89\n", + "for (i in 33:89) {\n", + " output <- c(output, sprintf(\"%-8s %-8d\", intToUtf8(i), i))\n", + "}\n", + "\n", + "# Print the output in a single block (e.g., to fit on a slide)\n", + "cat(paste(output, collapse = \"\\n\"))\n", + "```\n", + "## Phred scores in FASTQ file \n", + "\n", + "In a FASTQ file, Phred scores are represented as ASCII characters. These characters are converted back to numeric values (PHRED scores) based on the encoding scheme used:\n", + "\n", + "1. **PHRED+33 Encoding (Sanger/Illumina 1.8+)**:\n", + "\n", + " - The ASCII character for a quality score Q is calculated as:\n", + "\n", + " ASCII character=chr(Q+33)\n", + "\n", + " - For example:\n", + "\n", + " - A PHRED score of 30 is encoded as `chr(30 + 33) = chr(63)`, which corresponds to the ASCII character `?`.\n", + "\n", + "2. **PHRED+64 Encoding (Illumina 1.3-1.7)**:\n", + "\n", + " - The ASCII character for a quality score QQQ is calculated as: \n", + " \n", + " ASCII character=chr(Q+64)\n", + "\n", + " - For example:\n", + "\n", + " - A PHRED score of 30 is encoded as `chr(30 + 64) = chr(94)`, which corresponds to the ASCII character `^`.\n", + "\n", + "\n", + "```{r}\n", + "# Print the header\n", + "cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t\\t%-10s\\n\", \"Phred\", \"Prob. of\", \"ASCII\", \"ASCII\"))\n", + "cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t%-10s\\n\", \"score\", \"Error\", \"Phred+33\", \"Phred+64\"))\n", + "\n", + "# Loop through Phred scores from 0 to 41\n", + "for (phred in 0:41) {\n", + " # Calculate the probability of error\n", + " prob_error <- 10^(phred / -10)\n", + "\n", + " # Convert Phred scores to ASCII characters\n", + " ascii_phred33 <- intToUtf8(phred + 33)\n", + " ascii_phred64 <- intToUtf8(phred + 64)\n", + "\n", + " # Print the results in a formatted table\n", + " cat(sprintf(\"%-5d\\t\\t%0.5f\\t\\t%-6s\\t\\t%-10s\\n\", \n", + " phred, prob_error, \n", + " ascii_phred33, ascii_phred64))\n", + "}\n", + "```\n" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + } + }, + "nbformat": 4, + "nbformat_minor": 4 +} \ No newline at end of file diff --git a/FASTQ_PHRED/index.html b/FASTQ_PHRED/index.html new file mode 100644 index 0000000..4a16ef4 --- /dev/null +++ b/FASTQ_PHRED/index.html @@ -0,0 +1,224 @@ + + + + + + + + PRED Score in Bioinformatics - Lab note for UMD BIOI611 + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+
+
+ +

What is PHRED Scores

+

A Phred score is a measure of the probability that a base call in a DNA sequencing read is incorrect. It is a logarithmic scale, meaning that a small change in the Phred score represents a large change in the probability of an error.

+

$$Q = -10 \cdot \log_{10}(P)$$

+

Where:

+
    +
  • +

    Q is the PHRED score.

    +
  • +
  • +

    P is the probability that the base was called incorrectly.

    +
  • +
+

For example:

+
    +
  • +

    Q = 20: This corresponds to a 1 in 100 probability of an incorrect base call, or an accuracy of 99%.

    +
  • +
  • +

    Q = 30: This corresponds to a 1 in 1000 probability of an incorrect base call, or an accuracy of 99.9%.

    +
  • +
  • +

    Q = 40: This corresponds to a 1 in 10,000 probability of an incorrect base call, or an accuracy of 99.99%.

    +
  • +
+
# Print the header
+cat(sprintf("%-5s\t\t%-10s\n", "Phred", "Prob of"))
+cat(sprintf("%-5s\t\t%-10s\n", "score", "Incorrect call"))
+
+# Loop through Phred scores from 0 to 41
+for (phred in 0:41) {
+  cat(sprintf("%-5d\t\t%0.5f\n", phred, 10^(phred / -10)))
+}
+
+

What is ASCII

+

ASCII (American Standard Code for Information Interchange) is used to represent characters in computers. We can represent Phred scores using ASCII characters. The advantage is that the quality information can be esisly stored in text based FASTQ file.

+

Not all ASCII characters are printable. The first printable ASCII character is ! and the decimal code for the character for ! is 33.

+
# Store output in a vector to fit on a slide
+output <- c(sprintf("%-8s  %-8s", "Character", "ASCII #"))
+
+# Loop through ASCII values from 33 to 89
+for (i in 33:89) {
+  output <- c(output, sprintf("%-8s  %-8d", intToUtf8(i), i))
+}
+
+# Print the output in a single block (e.g., to fit on a slide)
+cat(paste(output, collapse = "\n"))
+
+

Phred scores in FASTQ file

+

In a FASTQ file, Phred scores are represented as ASCII characters. These characters are converted back to numeric values (PHRED scores) based on the encoding scheme used:

+
    +
  1. +

    PHRED+33 Encoding (Sanger/Illumina 1.8+):

    +
      +
    • +

      The ASCII character for a quality score Q is calculated as:

      +

      ASCII character=chr(Q+33)

      +
    • +
    • +

      For example:

      +
        +
      • A PHRED score of 30 is encoded as chr(30 + 33) = chr(63), which corresponds to the ASCII character ?.
      • +
      +
    • +
    +
  2. +
  3. +

    PHRED+64 Encoding (Illumina 1.3-1.7):

    +
      +
    • +

      The ASCII character for a quality score QQQ is calculated as:

      +

      ASCII character=chr(Q+64)

      +
    • +
    • +

      For example:

      +
        +
      • A PHRED score of 30 is encoded as chr(30 + 64) = chr(94), which corresponds to the ASCII character ^.
      • +
      +
    • +
    +
  4. +
+
# Print the header
+cat(sprintf("%-5s\t\t%-10s\t%-6s\t\t%-10s\n", "Phred", "Prob. of", "ASCII", "ASCII"))
+cat(sprintf("%-5s\t\t%-10s\t%-6s\t%-10s\n", "score", "Error", "Phred+33", "Phred+64"))
+
+# Loop through Phred scores from 0 to 41
+for (phred in 0:41) {
+  # Calculate the probability of error
+  prob_error <- 10^(phred / -10)
+
+  # Convert Phred scores to ASCII characters
+  ascii_phred33 <- intToUtf8(phred + 33)
+  ascii_phred64 <- intToUtf8(phred + 64)
+
+  # Print the results in a formatted table
+  cat(sprintf("%-5d\t\t%0.5f\t\t%-6s\t\t%-10s\n", 
+              phred, prob_error, 
+              ascii_phred33, ascii_phred64))
+}
+
+ +
+
+ +
+
+ +
+ +
+ +
+ + + + Bix4UMD/BIOI611_lab + + + + + +
+ + + + + + + + + diff --git a/Phred_FQ.ipynb b/Phred_FQ.ipynb new file mode 100644 index 0000000..f75b23b --- /dev/null +++ b/Phred_FQ.ipynb @@ -0,0 +1,348 @@ +{ + "nbformat": 4, + "nbformat_minor": 0, + "metadata": { + "colab": { + "provenance": [] + }, + "kernelspec": { + "name": "ir", + "display_name": "R" + }, + "language_info": { + "name": "R" + } + }, + "cells": [ + { + "cell_type": "markdown", + "source": [ + "## What is PHRED Scores\n", + "\n", + "A Phred score is a measure of the probability that a base call in a DNA sequencing read is incorrect. It is a logarithmic scale, meaning that a small change in the Phred score represents a large change in the probability of an error.\n" + ], + "metadata": { + "id": "F78EdRn_o-mR" + } + }, + { + "cell_type": "markdown", + "source": [ + "$$Q = -10 \\cdot \\log_{10}(P)$$\n", + "\n", + "Where:\n", + "\n", + "- Q is the PHRED score.\n", + "\n", + "- P is the probability that the base was called incorrectly." + ], + "metadata": { + "id": "pqf1OtUbpWM0" + } + }, + { + "cell_type": "markdown", + "source": [ + "For example:\n", + "\n", + "- **Q = 20**: This corresponds to a 1 in 100 probability of an incorrect base call, or an accuracy of 99%.\n", + "\n", + "- **Q = 30**: This corresponds to a 1 in 1000 probability of an incorrect base call, or an accuracy of 99.9%.\n", + "\n", + "- **Q = 40**: This corresponds to a 1 in 10,000 probability of an incorrect base call, or an accuracy of 99.99%." + ], + "metadata": { + "id": "OWLE6XVPshDB" + } + }, + { + "cell_type": "code", + "source": [ + "# Print the header\n", + "cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"Phred\", \"Prob of\"))\n", + "cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"score\", \"Incorrect call\"))\n", + "\n", + "# Loop through Phred scores from 0 to 41\n", + "for (phred in 0:41) {\n", + " cat(sprintf(\"%-5d\\t\\t%0.5f\\n\", phred, 10^(phred / -10)))\n", + "}" + ], + "metadata": { + "colab": { + "base_uri": "https://localhost:8080/" + }, + "id": "Rw848AdJpYKb", + "outputId": "f209f482-2687-4f8b-aca3-0f68997b0fef" + }, + "execution_count": 1, + "outputs": [ + { + "output_type": "stream", + "name": "stdout", + "text": [ + "Phred\t\tProb of \n", + "score\t\tIncorrect call\n", + "0 \t\t1.00000\n", + "1 \t\t0.79433\n", + "2 \t\t0.63096\n", + "3 \t\t0.50119\n", + "4 \t\t0.39811\n", + "5 \t\t0.31623\n", + "6 \t\t0.25119\n", + "7 \t\t0.19953\n", + "8 \t\t0.15849\n", + "9 \t\t0.12589\n", + "10 \t\t0.10000\n", + "11 \t\t0.07943\n", + "12 \t\t0.06310\n", + "13 \t\t0.05012\n", + "14 \t\t0.03981\n", + "15 \t\t0.03162\n", + "16 \t\t0.02512\n", + "17 \t\t0.01995\n", + "18 \t\t0.01585\n", + "19 \t\t0.01259\n", + "20 \t\t0.01000\n", + "21 \t\t0.00794\n", + "22 \t\t0.00631\n", + "23 \t\t0.00501\n", + "24 \t\t0.00398\n", + "25 \t\t0.00316\n", + "26 \t\t0.00251\n", + "27 \t\t0.00200\n", + "28 \t\t0.00158\n", + "29 \t\t0.00126\n", + "30 \t\t0.00100\n", + "31 \t\t0.00079\n", + "32 \t\t0.00063\n", + "33 \t\t0.00050\n", + "34 \t\t0.00040\n", + "35 \t\t0.00032\n", + "36 \t\t0.00025\n", + "37 \t\t0.00020\n", + "38 \t\t0.00016\n", + "39 \t\t0.00013\n", + "40 \t\t0.00010\n", + "41 \t\t0.00008\n" + ] + } + ] + }, + { + "cell_type": "markdown", + "source": [ + "## What is ASCII\n", + "\n", + "ASCII (American Standard Code for Information Interchange) is used to represent characters in computers. We can represent Phred scores using ASCII characters. The advantage is that the quality information can be esisly stored in text based FASTQ file.\n", + "\n", + "Not all [ASCII characters](https://www.columbia.edu/kermit/ascii.html) are printable. The first printable ASCII character is `!` and the decimal code for the character for `!` is 33.\n" + ], + "metadata": { + "id": "unXSCohlsn0C" + } + }, + { + "cell_type": "code", + "source": [ + "# Store output in a vector to fit on a slide\n", + "output <- c(sprintf(\"%-8s %-8s\", \"Character\", \"ASCII #\"))\n", + "\n", + "# Loop through ASCII values from 33 to 89\n", + "for (i in 33:89) {\n", + " output <- c(output, sprintf(\"%-8s %-8d\", intToUtf8(i), i))\n", + "}\n", + "\n", + "# Print the output in a single block (e.g., to fit on a slide)\n", + "cat(paste(output, collapse = \"\\n\"))" + ], + "metadata": { + "colab": { + "base_uri": "https://localhost:8080/" + }, + "id": "9QWGQ5S7stE8", + "outputId": "d9c043df-e4f6-409b-ca2c-0c02f29c76a5" + }, + "execution_count": 2, + "outputs": [ + { + "output_type": "stream", + "name": "stdout", + "text": [ + "Character ASCII # \n", + "! 33 \n", + "\" 34 \n", + "# 35 \n", + "$ 36 \n", + "% 37 \n", + "& 38 \n", + "' 39 \n", + "( 40 \n", + ") 41 \n", + "* 42 \n", + "+ 43 \n", + ", 44 \n", + "- 45 \n", + ". 46 \n", + "/ 47 \n", + "0 48 \n", + "1 49 \n", + "2 50 \n", + "3 51 \n", + "4 52 \n", + "5 53 \n", + "6 54 \n", + "7 55 \n", + "8 56 \n", + "9 57 \n", + ": 58 \n", + "; 59 \n", + "< 60 \n", + "= 61 \n", + "> 62 \n", + "? 63 \n", + "@ 64 \n", + "A 65 \n", + "B 66 \n", + "C 67 \n", + "D 68 \n", + "E 69 \n", + "F 70 \n", + "G 71 \n", + "H 72 \n", + "I 73 \n", + "J 74 \n", + "K 75 \n", + "L 76 \n", + "M 77 \n", + "N 78 \n", + "O 79 \n", + "P 80 \n", + "Q 81 \n", + "R 82 \n", + "S 83 \n", + "T 84 \n", + "U 85 \n", + "V 86 \n", + "W 87 \n", + "X 88 \n", + "Y 89 " + ] + } + ] + }, + { + "cell_type": "markdown", + "source": [ + "## Phred scores in FASTQ file\n", + "\n", + "In a FASTQ file, Phred scores are represented as ASCII characters. These characters are converted back to numeric values (PHRED scores) based on the encoding scheme used:\n", + "\n", + "1. **PHRED+33 Encoding (Sanger/Illumina 1.8+)**:\n", + "\n", + " - The ASCII character for a quality score Q is calculated as:\n", + "\n", + " ASCII character=chr(Q+33)\n", + "\n", + " - For example:\n", + "\n", + " - A PHRED score of 30 is encoded as `chr(30 + 33) = chr(63)`, which corresponds to the ASCII character `?`.\n", + "\n", + "2. **PHRED+64 Encoding (Illumina 1.3-1.7)**:\n", + "\n", + " - The ASCII character for a quality score QQQ is calculated as:\n", + " \n", + " ASCII character=chr(Q+64)\n", + "\n", + " - For example:\n", + "\n", + " - A PHRED score of 30 is encoded as `chr(30 + 64) = chr(94)`, which corresponds to the ASCII character `^`." + ], + "metadata": { + "id": "6yVLFfLqsyMS" + } + }, + { + "cell_type": "code", + "source": [ + "# Print the header\n", + "cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t\\t%-10s\\n\", \"Phred\", \"Prob. of\", \"ASCII\", \"ASCII\"))\n", + "cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t%-10s\\n\", \"score\", \"Error\", \"Phred+33\", \"Phred+64\"))\n", + "\n", + "# Loop through Phred scores from 0 to 41\n", + "for (phred in 0:41) {\n", + " # Calculate the probability of error\n", + " prob_error <- 10^(phred / -10)\n", + "\n", + " # Convert Phred scores to ASCII characters\n", + " ascii_phred33 <- intToUtf8(phred + 33)\n", + " ascii_phred64 <- intToUtf8(phred + 64)\n", + "\n", + " # Print the results in a formatted table\n", + " cat(sprintf(\"%-5d\\t\\t%0.5f\\t\\t%-6s\\t\\t%-10s\\n\",\n", + " phred, prob_error,\n", + " ascii_phred33, ascii_phred64))\n", + "}" + ], + "metadata": { + "colab": { + "base_uri": "https://localhost:8080/" + }, + "id": "jsss59RTs51r", + "outputId": "06e6473a-c4f3-4100-92f5-efb5176803e7" + }, + "execution_count": 3, + "outputs": [ + { + "output_type": "stream", + "name": "stdout", + "text": [ + "Phred\t\tProb. of \tASCII \t\tASCII \n", + "score\t\tError \tPhred+33\tPhred+64 \n", + "0 \t\t1.00000\t\t! \t\t@ \n", + "1 \t\t0.79433\t\t\" \t\tA \n", + "2 \t\t0.63096\t\t# \t\tB \n", + "3 \t\t0.50119\t\t$ \t\tC \n", + "4 \t\t0.39811\t\t% \t\tD \n", + "5 \t\t0.31623\t\t& \t\tE \n", + "6 \t\t0.25119\t\t' \t\tF \n", + "7 \t\t0.19953\t\t( \t\tG \n", + "8 \t\t0.15849\t\t) \t\tH \n", + "9 \t\t0.12589\t\t* \t\tI \n", + "10 \t\t0.10000\t\t+ \t\tJ \n", + "11 \t\t0.07943\t\t, \t\tK \n", + "12 \t\t0.06310\t\t- \t\tL \n", + "13 \t\t0.05012\t\t. \t\tM \n", + "14 \t\t0.03981\t\t/ \t\tN \n", + "15 \t\t0.03162\t\t0 \t\tO \n", + "16 \t\t0.02512\t\t1 \t\tP \n", + "17 \t\t0.01995\t\t2 \t\tQ \n", + "18 \t\t0.01585\t\t3 \t\tR \n", + "19 \t\t0.01259\t\t4 \t\tS \n", + "20 \t\t0.01000\t\t5 \t\tT \n", + "21 \t\t0.00794\t\t6 \t\tU \n", + "22 \t\t0.00631\t\t7 \t\tV \n", + "23 \t\t0.00501\t\t8 \t\tW \n", + "24 \t\t0.00398\t\t9 \t\tX \n", + "25 \t\t0.00316\t\t: \t\tY \n", + "26 \t\t0.00251\t\t; \t\tZ \n", + "27 \t\t0.00200\t\t< \t\t[ \n", + "28 \t\t0.00158\t\t= \t\t\\ \n", + "29 \t\t0.00126\t\t> \t\t] \n", + "30 \t\t0.00100\t\t? \t\t^ \n", + "31 \t\t0.00079\t\t@ \t\t_ \n", + "32 \t\t0.00063\t\tA \t\t` \n", + "33 \t\t0.00050\t\tB \t\ta \n", + "34 \t\t0.00040\t\tC \t\tb \n", + "35 \t\t0.00032\t\tD \t\tc \n", + "36 \t\t0.00025\t\tE \t\td \n", + "37 \t\t0.00020\t\tF \t\te \n", + "38 \t\t0.00016\t\tG \t\tf \n", + "39 \t\t0.00013\t\tH \t\tg \n", + "40 \t\t0.00010\t\tI \t\th \n", + "41 \t\t0.00008\t\tJ \t\ti \n" + ] + } + ] + } + ] +} \ No newline at end of file diff --git a/Phred_FQ/index.html b/Phred_FQ/index.html new file mode 100644 index 0000000..70ec11c --- /dev/null +++ b/Phred_FQ/index.html @@ -0,0 +1,373 @@ + + + + + + + + Phred FQ - Lab note for UMD BIOI611 + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+
+
+ +

What is PHRED Scores

+

A Phred score is a measure of the probability that a base call in a DNA sequencing read is incorrect. It is a logarithmic scale, meaning that a small change in the Phred score represents a large change in the probability of an error.

+

$$Q = -10 \cdot \log_{10}(P)$$

+

Where:

+
    +
  • +

    Q is the PHRED score.

    +
  • +
  • +

    P is the probability that the base was called incorrectly.

    +
  • +
+

For example:

+
    +
  • +

    Q = 20: This corresponds to a 1 in 100 probability of an incorrect base call, or an accuracy of 99%.

    +
  • +
  • +

    Q = 30: This corresponds to a 1 in 1000 probability of an incorrect base call, or an accuracy of 99.9%.

    +
  • +
  • +

    Q = 40: This corresponds to a 1 in 10,000 probability of an incorrect base call, or an accuracy of 99.99%.

    +
  • +
+
# Print the header
+cat(sprintf("%-5s\t\t%-10s\n", "Phred", "Prob of"))
+cat(sprintf("%-5s\t\t%-10s\n", "score", "Incorrect call"))
+
+# Loop through Phred scores from 0 to 41
+for (phred in 0:41) {
+  cat(sprintf("%-5d\t\t%0.5f\n", phred, 10^(phred / -10)))
+}
+
+
Phred       Prob of   
+score       Incorrect call
+0           1.00000
+1           0.79433
+2           0.63096
+3           0.50119
+4           0.39811
+5           0.31623
+6           0.25119
+7           0.19953
+8           0.15849
+9           0.12589
+10          0.10000
+11          0.07943
+12          0.06310
+13          0.05012
+14          0.03981
+15          0.03162
+16          0.02512
+17          0.01995
+18          0.01585
+19          0.01259
+20          0.01000
+21          0.00794
+22          0.00631
+23          0.00501
+24          0.00398
+25          0.00316
+26          0.00251
+27          0.00200
+28          0.00158
+29          0.00126
+30          0.00100
+31          0.00079
+32          0.00063
+33          0.00050
+34          0.00040
+35          0.00032
+36          0.00025
+37          0.00020
+38          0.00016
+39          0.00013
+40          0.00010
+41          0.00008
+
+

What is ASCII

+

ASCII (American Standard Code for Information Interchange) is used to represent characters in computers. We can represent Phred scores using ASCII characters. The advantage is that the quality information can be esisly stored in text based FASTQ file.

+

Not all ASCII characters are printable. The first printable ASCII character is ! and the decimal code for the character for ! is 33.

+
# Store output in a vector to fit on a slide
+output <- c(sprintf("%-8s  %-8s", "Character", "ASCII #"))
+
+# Loop through ASCII values from 33 to 89
+for (i in 33:89) {
+  output <- c(output, sprintf("%-8s  %-8d", intToUtf8(i), i))
+}
+
+# Print the output in a single block (e.g., to fit on a slide)
+cat(paste(output, collapse = "\n"))
+
+
Character  ASCII # 
+!         33      
+"         34      
+#         35      
+$         36      
+%         37      
+&         38      
+'         39      
+(         40      
+)         41      
+*         42      
++         43      
+,         44      
+-         45      
+.         46      
+/         47      
+0         48      
+1         49      
+2         50      
+3         51      
+4         52      
+5         53      
+6         54      
+7         55      
+8         56      
+9         57      
+:         58      
+;         59      
+<         60      
+=         61      
+>         62      
+?         63      
+@         64      
+A         65      
+B         66      
+C         67      
+D         68      
+E         69      
+F         70      
+G         71      
+H         72      
+I         73      
+J         74      
+K         75      
+L         76      
+M         77      
+N         78      
+O         79      
+P         80      
+Q         81      
+R         82      
+S         83      
+T         84      
+U         85      
+V         86      
+W         87      
+X         88      
+Y         89
+
+

Phred scores in FASTQ file

+

In a FASTQ file, Phred scores are represented as ASCII characters. These characters are converted back to numeric values (PHRED scores) based on the encoding scheme used:

+
    +
  1. +

    PHRED+33 Encoding (Sanger/Illumina 1.8+):

    +
      +
    • +

      The ASCII character for a quality score Q is calculated as:

      +

      ASCII character=chr(Q+33)

      +
    • +
    • +

      For example:

      +
        +
      • A PHRED score of 30 is encoded as chr(30 + 33) = chr(63), which corresponds to the ASCII character ?.
      • +
      +
    • +
    +
  2. +
  3. +

    PHRED+64 Encoding (Illumina 1.3-1.7):

    +
      +
    • +

      The ASCII character for a quality score QQQ is calculated as:

      +

      ASCII character=chr(Q+64)

      +
    • +
    • +

      For example:

      +
        +
      • A PHRED score of 30 is encoded as chr(30 + 64) = chr(94), which corresponds to the ASCII character ^.
      • +
      +
    • +
    +
  4. +
+
# Print the header
+cat(sprintf("%-5s\t\t%-10s\t%-6s\t\t%-10s\n", "Phred", "Prob. of", "ASCII", "ASCII"))
+cat(sprintf("%-5s\t\t%-10s\t%-6s\t%-10s\n", "score", "Error", "Phred+33", "Phred+64"))
+
+# Loop through Phred scores from 0 to 41
+for (phred in 0:41) {
+  # Calculate the probability of error
+  prob_error <- 10^(phred / -10)
+
+  # Convert Phred scores to ASCII characters
+  ascii_phred33 <- intToUtf8(phred + 33)
+  ascii_phred64 <- intToUtf8(phred + 64)
+
+  # Print the results in a formatted table
+  cat(sprintf("%-5d\t\t%0.5f\t\t%-6s\t\t%-10s\n",
+              phred, prob_error,
+              ascii_phred33, ascii_phred64))
+}
+
+
Phred       Prob. of    ASCII       ASCII     
+score       Error       Phred+33    Phred+64  
+0           1.00000     !           @         
+1           0.79433     "           A         
+2           0.63096     #           B         
+3           0.50119     $           C         
+4           0.39811     %           D         
+5           0.31623     &           E         
+6           0.25119     '           F         
+7           0.19953     (           G         
+8           0.15849     )           H         
+9           0.12589     *           I         
+10          0.10000     +           J         
+11          0.07943     ,           K         
+12          0.06310     -           L         
+13          0.05012     .           M         
+14          0.03981     /           N         
+15          0.03162     0           O         
+16          0.02512     1           P         
+17          0.01995     2           Q         
+18          0.01585     3           R         
+19          0.01259     4           S         
+20          0.01000     5           T         
+21          0.00794     6           U         
+22          0.00631     7           V         
+23          0.00501     8           W         
+24          0.00398     9           X         
+25          0.00316     :           Y         
+26          0.00251     ;           Z         
+27          0.00200     <           [         
+28          0.00158     =           \         
+29          0.00126     >           ]         
+30          0.00100     ?           ^         
+31          0.00079     @           _         
+32          0.00063     A           `         
+33          0.00050     B           a         
+34          0.00040     C           b         
+35          0.00032     D           c         
+36          0.00025     E           d         
+37          0.00020     F           e         
+38          0.00016     G           f         
+39          0.00013     H           g         
+40          0.00010     I           h         
+41          0.00008     J           i
+
+ +
+
+ +
+
+ +
+ +
+ +
+ + + + Bix4UMD/BIOI611_lab + + + + + +
+ + + + + + + + + diff --git a/basic_linux.ipynb b/basic_linux.ipynb new file mode 100644 index 0000000..9f8a3e6 --- /dev/null +++ b/basic_linux.ipynb @@ -0,0 +1,2191 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "id": "dddb9b84-f2b0-4ebc-9aeb-b54289078ab5", + "metadata": {}, + "source": [ + "# Linux for Bioinformatics\n", + "\n", + "## Navigating in Linux file system\n" + ] + }, + { + "cell_type": "markdown", + "id": "2985e938-f07c-4a2a-846c-646d1f177846", + "metadata": {}, + "source": [ + "You are in your home directory after you log into the system and are directed to the shell command prompt. This section will show you hot to explore Linux file system using shell commands.\n" + ] + }, + { + "cell_type": "markdown", + "id": "99fde8f2-5467-4a12-83b3-1cefca934432", + "metadata": {}, + "source": [ + "### Path " + ] + }, + { + "cell_type": "markdown", + "id": "5a0985e0-7b7d-4cde-958b-9f1da3543604", + "metadata": {}, + "source": [ + "To understand Linux file system, you can image it as a tree structure. \n" + ] + }, + { + "attachments": { + "9aa63990-e065-4ee7-aee6-c0e56c67cc38.png": { + "image/png": "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97bUh91y033CcnOv5aZOuK7m9dGv/2RhS53w3KTfa/RaJ+RojRxt6Rw6oRNbyvO+r+XUPkTEMxHxTX5y07elK9B5Q7d8HPjIJzW/W7416YSdYYvf1gkdOG8Hjv75rfVht9h0n7DYvPBiUydcU49eI/3zt7G1Tnhu0vF9e60TMrRvhrb293VCJ7aW6X1ez5n7sHsgeTs/brd88u69L+/FG598Hy+/f/PCX8zsM7y/W7fMl67c/PvTvctPozryP25d4nO1+1IzN686UTd/1a4Nh9CHI8tN9wkLzlOfCXTCs1O16/T/Pc8hdMJzk+em8/RMJ3x9fZ68HMKf1QmdOIScn/U17t2HiHghf6BQLjn9SuAMAssPCmr5/9TMReZJv+rEGd59f2QU2GwfdgtO94nxHXd8moBOnCbk3x+awGY74bnp0KK82uvVidUonWgjAjqxkTfSy1hF4Px9WH6SdUS8EhGfRcSdiHi4yihOsiWBJRNLNq5HxOVuP/38pCXmSb+vE1uK7pTXclB92C033SemRGkzJ9UJz06bCfNKL+SgOuG5aaXUbPs0OrHt99erO7+ATpzfzN/YrsBB9eGkPdfoH2sAAAKrSURBVJTfJ0CAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBI4I/AWQvN8vtdCrCAAAAABJRU5ErkJggg==" + } + }, + "cell_type": "markdown", + "id": "cb623d2a-0e9b-41ad-96b6-402e17e8c132", + "metadata": {}, + "source": [ + "![image.png](attachment:9aa63990-e065-4ee7-aee6-c0e56c67cc38.png)" + ] + }, + { + "cell_type": "markdown", + "id": "df593733-05df-4678-95a7-e418054ed82f", + "metadata": {}, + "source": [ + "In Linux, a path is a unique location of a file or a directory in the file system.\n", + "\n", + "For convenience, Linux file system is usually thought of in a tree structure. On a standard Linux system you will find the layout generally follows the scheme presented below.\n" + ] + }, + { + "cell_type": "markdown", + "id": "b61efff0-99b2-451c-a0cd-38820ecc6df1", + "metadata": {}, + "source": [ + "The tree of the file system starts at the trunk or slash, indicated by a forward slash (`/`). This directory, containing all underlying directories and files, is also called the root directory or “the root” of the file system. " + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "id": "6dfd5787-6087-49af-9169-9129219f5b7d", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "/home/xie186\n" + ] + } + ], + "source": [ + "%%bash\n", + "## In your account, you will see a folder\n", + "## with you account ID as the name\n", + "cd ~\n", + "echo $HOME" + ] + }, + { + "cell_type": "markdown", + "id": "f3ca486c", + "metadata": {}, + "source": [ + "### Relative and absolute path\n", + "\n", + "\n", + "* __Absolute path__\n", + "\n", + "An absolute path is defined as the location of a file or directory from the root directory(/). An absolute path starts from the `root` of the tree (`/`).\n", + "\n", + "Here are some examples: \n", + "```\n", + "/home/xie186\n", + "/home/xie186/.bashrc\n", + "```\n", + "\n", + "* __Relative path__\n", + "\n", + "Relative path is a path related to the present working directory: \n", + "`data/sample1/` and `../doc/`. \n", + "\n", + "If you want to get the __absolute path__ based on __relative path__, you can use `readlink` with parameter `-f`: \n", + "\n", + "```{sh}\n", + "pwd\n", + "readlink -f ../\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "afd3b573", + "metadata": {}, + "source": [ + "\n", + "Once we enter into a Linux file system, we need to 1) know where we are; 2) how to get where we want; 3) how to know what files or directories we have in a particular path. \n", + "\n", + "### Check where you are using command `pwd`\n", + "\n", + "In order to know where we are, we need to use `pwd` command. The command `pwd` is short for “print name of current/working directory”. It will return the full path of current directory.\n", + "\n", + "Command pwd is almost always used by itself. This means you only need to type `pwd` and press ENTER \n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "4a0ebae1", + "metadata": {}, + "outputs": [], + "source": [ + "%%bash\n", + "pwd" + ] + }, + { + "cell_type": "markdown", + "id": "4c4f603d", + "metadata": {}, + "source": [ + "### Listing the contents using command `ls`\n", + "\n", + "After you know where you are, then you want to know what you have in that \n", + "directory, we can use command `ls` to list directory contents \n", + "\n", + "Its syntax is:\n", + "\n", + "```\n", + "ls [option]... [file]...\n", + "\n", + "```\n", + "\n", + "`ls` with no option will list files and directories in bare format. Bare format means the detailed information (type, size, modified date and time, permissions and links etc) won’t be viewed. When you use `ls` by itself, it will list files and directories in the current directory. \n" + ] + }, + { + "cell_type": "markdown", + "id": "bb89e6ea", + "metadata": {}, + "source": [ + "```\n", + "ls ~/\n", + "ls -a \n", + "ls -ld\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "802cab01", + "metadata": {}, + "source": [ + "Linux command options can be combined without a space between them and with a single - (dash).\n", + "\n", + "The following command is a faster way to use the l and a options and gives the same output as the Linux command shown above." + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "id": "d7c45180", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "-rw-r--r--. 1 xie186 zt-bioi611 1067 Aug 22 22:27 /home/xie186/.bashrc\r\n" + ] + } + ], + "source": [ + "ls -lt ~/.bashrc" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "5f1dcd01", + "metadata": {}, + "outputs": [], + "source": [] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "a1fc536d", + "metadata": {}, + "outputs": [], + "source": [] + }, + { + "cell_type": "markdown", + "id": "e4419915", + "metadata": {}, + "source": [ + "### Change directory using command `cd`" + ] + }, + { + "cell_type": "markdown", + "id": "85bc33ab", + "metadata": {}, + "source": [ + "Unlike `pwd`, when you use `cd` you usually need to provide the path (either absolute or relative path) which we want to enter. \n", + " \n", + "If you didn’t provide any path information, you will change to home directory by default." + ] + }, + { + "cell_type": "markdown", + "id": "9d20437e", + "metadata": {}, + "source": [ + "| Path | Shortcuts | Description |\n", + "|-----------------|-----------|-------------------------------------------------------------|\n", + "| Single dot | . | The current folder |\n", + "| Double dots | .. | The folder above the current folder |\n", + "| Tilde character | ~ | Home directory (normally the directory:/home/my_login_name) |\n", + "| Dash | - | Your last working directory |" + ] + }, + { + "cell_type": "markdown", + "id": "5c03b156", + "metadata": {}, + "source": [ + "Here are some examples:\n", + "\n", + "```\n", + "cd ~\n", + "pwd\n", + "ls\n", + "ls ../\n", + "## \n", + "pwd\n", + "cd ../\n", + "pwd\n", + "cd ./\n", + "pwd\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "317e6bd7", + "metadata": {}, + "source": [ + "Each directory has two entries in it at the start, with names `.` (a link to itself) and `..` (a link to its parent directory). The exception, of course, is the root directory, where the `..` directory also refers to the root directory.\n", + "\n" + ] + }, + { + "cell_type": "markdown", + "id": "99c7e1e1", + "metadata": {}, + "source": [ + "Sometimes you go to a new directory and do something, then you remember that you need to go to the previous working direcotry. To get back instantly, use a dash.\n", + "\n" + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "id": "e59e4871", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "/home/xie186/BIOI611_lab/docs\n", + "/home/xie186\n", + "/home/xie186/BIOI611_lab/docs\n", + "/home/xie186/BIOI611_lab/docs\n" + ] + } + ], + "source": [ + "%%bash \n", + "\n", + "# This is our current directory\n", + "pwd\n", + "\n", + "# Let us go our home diretory\n", + "cd ~\n", + "\n", + "# Check where we are\n", + "pwd\n", + "\n", + "# Let us go to your previous working directory\n", + "cd -\n", + "# Check where we are now\n", + "pwd" + ] + }, + { + "cell_type": "markdown", + "id": "542089fa", + "metadata": {}, + "source": [ + "## Manipulations of files and directories" + ] + }, + { + "cell_type": "markdown", + "id": "f3ce6793", + "metadata": {}, + "source": [ + "In Linux, manipulations of files and directories are the most frequent work. In this section, you will learn how to copy, rename, remove, and create files and directories.\n", + "\n" + ] + }, + { + "cell_type": "markdown", + "id": "0bcc7ba3", + "metadata": {}, + "source": [ + "### Command line `cp`" + ] + }, + { + "cell_type": "markdown", + "id": "da21c521", + "metadata": {}, + "source": [ + "In Linux, command `cp` can help you copy files and directories into a target directory.\n" + ] + }, + { + "cell_type": "markdown", + "id": "df67c06c", + "metadata": {}, + "source": [ + "### Command line `mv` " + ] + }, + { + "cell_type": "markdown", + "id": "930fa36d", + "metadata": {}, + "source": [ + "Move files/folders and rename file/folders using `mv`:\n", + "\n", + "```\n", + "# move file from one location to another\n", + "mv file1 target_direcotry/\n", + "# rename\n", + "mv file1 file2 \n", + "mv file1 file2 file3 target_direcotry/\n", + "\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "bfe746fd", + "metadata": {}, + "source": [ + "### Command `mkdir`" + ] + }, + { + "cell_type": "markdown", + "id": "308cdbd3", + "metadata": {}, + "source": [ + "The syntax is shown as below:\n", + "\n", + "```\n", + "mkdir [OPTION ...] DIRECTORY ...\n", + "```\n", + "\n", + "\n", + "Multiple directories can be specified when calling `mkdir`\n", + "\n", + "```\n", + "mkdir directory1 directory2\n", + "mkdir -p foo/bar/baz\n", + "```\n" + ] + }, + { + "cell_type": "markdown", + "id": "ca395019", + "metadata": {}, + "source": [ + "How to defining complex directory trees with one command: \n", + " \n", + "\n", + "```\n", + "mkdir -p project/{software,results,doc/{html,info,pdf},scripts}\n", + "\n", + "```\n", + "\n", + "Then you can view the directory using `tree`. \n" + ] + }, + { + "cell_type": "markdown", + "id": "6efec9bb", + "metadata": {}, + "source": [ + "### Command `rm`\n", + "\n", + "You can use rm to remove both files and directories.\n", + "\n", + "```\n", + "## You can remove one file. \n", + "rm file1 \n", + "## `rm` can remove multiple files simutaneously\n", + "rm file2 file3 \n", + "```\n", + "\n", + "You can also use 'rm' to remove a folder. If a folder is empty, you can remove it using rm with `-r`.\n", + "\n", + "```\n", + "rm -r FOLDER\n", + "```\n", + "\n", + "If a folder is not empty, you can remove it using rm with `-r` and `-f`.\n", + "\n", + "\n", + "```\n", + "mkdir test_folder\n", + "rm -r test_folder\n", + "```\n" + ] + }, + { + "cell_type": "markdown", + "id": "2690b292", + "metadata": {}, + "source": [ + "## View text files in Linux" + ] + }, + { + "cell_type": "markdown", + "id": "205f8710", + "metadata": {}, + "source": [ + "### Commands `cat`, `more` and `less`" + ] + }, + { + "cell_type": "markdown", + "id": "e3447be7", + "metadata": {}, + "source": [ + "The command cat is short for concatenate files and print on the standard output.\n", + "\n", + "The syntax is shown as below:\n", + "\n", + "```\n", + "cat [OPTION]... [FILE]...\n", + "```\n", + "\n", + "For small text file, cat can be used to view the files on the standard output." + ] + }, + { + "cell_type": "markdown", + "id": "2648bb17", + "metadata": {}, + "source": [ + "The command more is old utility. When the text passed to it is too large to fit on one screen, it pages it. You can scroll down but not up.\n", + "\n", + "The syntaxt of `more` is shown below:\n", + "\n", + "```\n", + "more [options] file [...]\n", + "```\n" + ] + }, + { + "cell_type": "markdown", + "id": "efcba3b2", + "metadata": {}, + "source": [ + "The command less was written by a man who was fed up with more’s inability to scroll backwards through a file. He turned less into an open source project and over time, various individuals added new features to it. less is massive now. That’s why some small embedded systems have more but not less. For comparison, less’s source is over 27000 lines long. more implementations are generally only a little over 2000 lines long.\n" + ] + }, + { + "cell_type": "markdown", + "id": "ec43cdc4", + "metadata": {}, + "source": [ + "The syntaxt of less is shown below:\n", + "\n", + "```\n", + "less [options] file [...]\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "3e36fc04", + "metadata": {}, + "source": [ + "### Command `head` and `tail`" + ] + }, + { + "cell_type": "markdown", + "id": "4e413b5a", + "metadata": {}, + "source": [ + "\n", + "The command `head` is used to output the first part of files. By default, it outputs the first 10 lines of the file. \n", + "\n", + "```\n", + "head [OPTION]... [FILE]...\n", + "```\n", + "\n", + "Here is an exmaple of printing the first 5 files of the file: \n", + "\n", + "```\n", + "head -n 5 code_perl/variable_assign.pl\n", + "```\n", + "\n", + "In fact, the letter n does not even need to be used at all. Just the hyphen and the integer (with no intervening space) are sufficient to tell head how many lines to return. Thus, the following would produce the same result as the above commands:\n", + "\n", + "```\n", + "head -5 target_file.txt\n", + "```\n", + "\n", + "The command `tail` is used to output the last part of files. By default, it prints the last 10 lines of the file to standard output.\n", + "\n", + "The syntax is shown below:\n", + "\n", + "```\n", + "tail [OPTION]... [FILE]...\n", + "```\n", + "\n", + "Here is an exmaple of printing the last 5 files of the file: \n", + "\n", + "```{sh}\n", + "tail -5 target_file.txt\n", + "```\n", + "\n", + "To view lines from a specific point in a file, you can use `-n +NUMBER` with the `tail` command. For example, here is an example of viewing the file from the 2nd line of the line. \n", + "\n", + "```{sh}\n", + "tail -n +2 target_file.txt\n", + "```\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "541078cd", + "metadata": {}, + "outputs": [], + "source": [] + }, + { + "cell_type": "markdown", + "id": "6c25ec85", + "metadata": {}, + "source": [ + "##\tAuto-completion\n", + "\n", + "In most Shell environment, programmable completion feature will also improve your speed of typing. It permits typing a partial name of command or a partial file (or directory), then pressing `TAB` key to auto-complete the command. If there are more than one possible completions, then TAB will list all of them. \n", + "\n", + "A handy autocomplete feature also exists. Type one or more letters,\tpress the Tab key twice, and then a list of functions\tstarting with these letters appears. For example: type `so`, press the `Tab` key twice,\tand then you get the list as: \n", + "\n", + "```\n", + "soelim sort sotruss soundstretch source \n", + "```\n", + "\n", + "Demonstration of programmable completion feature.\n" + ] + }, + { + "cell_type": "markdown", + "id": "c2c0ab7d", + "metadata": {}, + "source": [ + "## File permissions" + ] + }, + { + "cell_type": "markdown", + "id": "c98faeff", + "metadata": {}, + "source": [ + "In Linux, file permissions are a vital aspect of system security and resource management. This is particularly important in bioinformatics, where large datasets and scripts are often shared across teams. Permissions determine who can read, write, or execute a file, ensuring that critical data is not accidentally modified or deleted.\n", + "\n", + "**Three Permission Categories**:\n", + "\n", + "* User (u): The owner of the file.\n", + "* Group (g): A group of users who share access to the file.\n", + "* Other (o): All other users on the system.\n", + "\n", + "**Permission Types** :\n", + "\n", + "* Read (r): Ability to view the contents of a file.\n", + "* Write (w): Ability to modify or delete the file.\n", + "* Execute (x): Ability to run the file as a program (for scripts or executables)." + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "id": "9cfe49c9", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "xie186 : zt-bioi611 zt-bioi611_mgr\n", + "animako : zt-bioi611\n", + "eunal : zt-bioi611\n", + "gstewar1 : zt-bioi611\n", + "mjames17 : zt-bioi611\n", + "mjeakle : zt-bioi611\n", + "nmilza : zt-bioi611\n", + "rahooper : zt-bioi611\n" + ] + } + ], + "source": [ + "%%bash\n", + "groups $USER animako eunal gstewar1 mjames17 mjeakle nmilza rahooper" + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "id": "5ef5fcf5", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "total 0\n", + "-rw-r--r--. 1 xie186 zt-bioi611 0 Sep 8 22:52 test.txt\n" + ] + } + ], + "source": [ + "%%bash\n", + "mkdir -p ~/test_permission/\n", + "touch ~/test_permission/test.txt\n", + "ls -l ~/test_permission/\n", + "rm -rf ~/test_permission/" + ] + }, + { + "cell_type": "markdown", + "id": "88cd47bb", + "metadata": {}, + "source": [ + "Here, the first character represents the type of file (e.g., `-` for a regular file or `d` for a directory), followed by three groups of three characters, each representing the permissions for the `user`, `group`, and `others`, respectively. \n", + "\n", + "Examples:\n", + "\n", + "`-rwxr-xr--`: The `owner` has `read`, `write`, and `execute` permissions. The group has `read` and `execute` permissions, while others can only read the file.\n", + "`drwxr-x---`: A directory where the owner can read, write, and access (execute). The group can only read and access, while others have no permissions." + ] + }, + { + "cell_type": "markdown", + "id": "90fe3e93", + "metadata": {}, + "source": [ + "Modify file permissions using the `chmod` command. Permissions can be set in two ways:\n", + " \n", + "Symbolic Mode:\n", + "\n", + "In symbolic mode, you modify permissions by referencing the categories (user, group, other) and specifying whether you're adding (+), removing (-), or setting (=) permissions.\n", + "\n", + "```\n", + "# Add execute permission for the user:\n", + "chmod u+x filename\n", + "# Remove write permission for the group:\n", + "chmod g-w filename\n", + "# Set read-only permission for others:\n", + "chmod o=r filename\n", + "```\n", + "\n", + "Symbolic mode is intuitive and flexible, especially when you want to make precise adjustments to permissions without affecting other categories. This is useful for common file-sharing tasks in bioinformatics where you need to tweak access for specific collaborators.\n", + "\n", + "Numeric Mode (Octal representation):\n", + "`\n", + "In numeric mode, file permissions are set using a three-digit number. Each digit represents the permissions for `user`, `group`, and `other`, respectively. The digits are calculated by adding the values of the `read`, `write`, and `execute` permissions:\n", + "\n", + "* Read (r) = 4\n", + "* Write (w) = 2\n", + "* Execute (x) = 1\n", + "\n", + "\n", + "Example Permission Breakdown:\n", + "\n", + "Read (r), Write (w), and Execute (x) for user = 7\n", + "\n", + "Read (r) and Execute (x) for group = 5\n", + "\n", + "Read (r) only for others = 4\n", + "\n", + "```\n", + "chmod 754 filename\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "36ef299e", + "metadata": {}, + "source": [ + "An example to help you understand `executable`: " + ] + }, + { + "cell_type": "code", + "execution_count": 25, + "id": "b98505fb", + "metadata": {}, + "outputs": [], + "source": [ + "%%bash\n", + "printf '#!/user/bin/python\\nprint(\"Hello, Welcome to Course BIOI611!\")' > ~/test.py" + ] + }, + { + "cell_type": "code", + "execution_count": 26, + "id": "fe0fca15", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "-rw-r--r--. 1 xie186 zt-bioi611 61 Sep 8 23:06 /home/xie186/test.py\n", + "Hello, Welcome to Course BIOI611!\n" + ] + } + ], + "source": [ + "%%bash\n", + "ls -l ~/test.py\n", + "python ~/test.py" + ] + }, + { + "cell_type": "markdown", + "id": "7096b943", + "metadata": {}, + "source": [ + "Error message below will be thrown out if you consider `~/test.py` as a program: \n", + "```\n", + "bash: line 1: /home/xie186/test.py: No such file or directory\n", + "```" + ] + }, + { + "cell_type": "code", + "execution_count": 27, + "id": "d574ded2", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "-rwxr--r--. 1 xie186 zt-bioi611 61 Sep 8 23:06 /home/xie186/test.py\n", + "Hello, Welcome to Course BIOI611!\n" + ] + } + ], + "source": [ + "%%bash\n", + "chmod u+x ~/test.py\n", + "ls -l ~/test.py\n", + "python ~/test.py\n", + "rm ~/test.py" + ] + }, + { + "cell_type": "markdown", + "id": "bda8db0b", + "metadata": {}, + "source": [ + "## Disk Usage of Files and Directories" + ] + }, + { + "cell_type": "markdown", + "id": "99e94cf5", + "metadata": {}, + "source": [ + "The Linux `du` (short for Disk Usage) is a standard Unix/Linux command, used to check the information of disk usage of files and directories on a machine. The du command has many parameter options that can be used to get the results in many formats. The `du` command also displays the files and directory sizes in a recursively manner." + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "id": "ab66ffe4", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "2.5G\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref\n" + ] + } + ], + "source": [ + "%%bash\n", + "du -h ~/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "id": "bdfb720e", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "2.9M\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbList.fromGTF.out.tab\n", + "7.5K\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/Log.out\n", + "936M\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/SA\n", + "1.5G\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/SAindex\n", + "3.0M\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/transcriptInfo.tab\n", + "2.3M\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbList.out.tab\n", + "1.5M\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/geneInfo.tab\n", + "1.0K\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/genomeParameters.txt\n", + "512\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrLength.txt\n", + "512\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrNameLength.txt\n", + "512\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrStart.txt\n", + "7.6M\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/exonGeTrInfo.tab\n", + "3.1M\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/exonInfo.tab\n", + "2.8M\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbInfo.txt\n", + "512\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrName.txt\n", + "119M\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/Genome\n", + "2.5G\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref\n" + ] + } + ], + "source": [ + "%%bash\n", + "du -ah ~/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref" + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "id": "c95ee1f3", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "19G\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/raw_data\n", + "0\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/raw_data_smart_seq\n", + "1.5K\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_data.sub\n", + "575K\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq-7478223-xie186.err\n", + "0\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq-7478223-xie186.out\n", + "8.5K\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq.sub\n", + "2.5K\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s2_star.sub\n", + "34G\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_align\n", + "2.5G\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref\n", + "512\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/test.sub\n", + "512\t/home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/test.txt\n", + "55G\ttotal\n" + ] + } + ], + "source": [ + "%%bash\n", + "du -csh /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/*" + ] + }, + { + "cell_type": "markdown", + "id": "e3562378", + "metadata": {}, + "source": [ + "## Symbolic link " + ] + }, + { + "cell_type": "markdown", + "id": "1aa45809", + "metadata": {}, + "source": [ + "Symbolic link, similar to shortcuts, can point to another file/folder. \n", + "\n", + "```\n", + "ln -s \n", + "ls -l \n", + "unlink \n", + "\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "32f54f5a", + "metadata": {}, + "source": [ + "## File Management and Data Handling" + ] + }, + { + "cell_type": "markdown", + "id": "4f950a72", + "metadata": {}, + "source": [ + "### Compressing and decompressing files (gzip, gunzip, tar).\n" + ] + }, + { + "cell_type": "markdown", + "id": "a7bc3568", + "metadata": {}, + "source": [ + "Compress one file: \n" + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "id": "536a5853", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "52K\ttest.txt\n", + "4.0K\ttest.txt.gz\n", + "test.txt\n" + ] + } + ], + "source": [ + "%%bash \n", + "perl -e 'for($i=0; $i<10000; ++$i){ print \"test\\n\";}' > test.txt \n", + "du -h test.txt\n", + "gzip test.txt\n", + "du -h test.txt.gz\n", + "gunzip test.txt\n", + "ls test.txt\n", + "rm test.txt" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "d70f9015", + "metadata": {}, + "outputs": [], + "source": [ + "Compress multiple files: " + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "id": "bb3660f9", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "52K\ttest1.txt\n", + "52K\ttest2.txt\n", + "test1.txt\n", + "test2.txt\n", + "4.0K\ttest.tar.gz\n", + "test1.txt\n", + "test2.txt\n" + ] + } + ], + "source": [ + "%%bash \n", + "perl -e 'for($i=0; $i<10000; ++$i){ print \"test\\n\";}' > test1.txt \n", + "perl -e 'for($i=0; $i<10000; ++$i){ print \"test\\n\";}' > test2.txt\n", + "du -h test1.txt test2.txt\n", + "tar zcvf test.tar.gz test1.txt test2.txt\n", + "du -sh test.tar.gz\n", + "ls test1.txt test2.txt" + ] + }, + { + "cell_type": "markdown", + "id": "23c2c457", + "metadata": {}, + "source": [ + "`z`: This option tells tar to compress the archive using gzip. The resulting archive will have a .gz extension to indicate that it has been compressed with the gzip utility.\n", + "\n", + "`c`: This option stands for create. It instructs tar to create a new archive.\n", + "\n", + "`v`: This stands for verbose. When used, tar will display detailed information about the files being added to the archive, such as their names.\n", + "\n", + "`f`: This stands for file. It tells tar that the next argument (test.tar.gz) is the name of the archive file to create." + ] + }, + { + "cell_type": "code", + "execution_count": 22, + "id": "e748ea9b", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "-rw-r--r-- xie186/zt-bioi611 50000 2024-08-25 21:52 test1.txt\n", + "-rw-r--r-- xie186/zt-bioi611 50000 2024-08-25 21:52 test2.txt\n" + ] + } + ], + "source": [ + "%%bash\n", + "tar tvf test.tar.gz\n", + "rm test.tar.gz test1.txt test2.txt" + ] + }, + { + "cell_type": "markdown", + "id": "ecebe759", + "metadata": {}, + "source": [ + "`t`: List the contents of archive.tar.\n", + "\n", + "`v`: Display additional details about each file (like file permissions, size, and modification date).\n", + "\n", + "`f`: Specifies that archive.tar is the archive file to operate on." + ] + }, + { + "cell_type": "markdown", + "id": "317094a5", + "metadata": {}, + "source": [ + "To uncompress a `tar.gz` file, use `tar zxvf`:\n", + "\n", + "```\n", + "tar zxvf test.tar.gz\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "dd69c449", + "metadata": {}, + "source": [ + "### Transferring files within the network\n", + "\n" + ] + }, + { + "cell_type": "markdown", + "id": "6aaa9b55", + "metadata": {}, + "source": [ + "Basic Syntax of `scp`:\n", + "\n", + "```\n", + "scp [options] source destination\n", + "\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "00afa73d", + "metadata": {}, + "source": [ + "Copy a Local File to a Remote Server\n", + "\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "44a081ed", + "metadata": {}, + "outputs": [], + "source": [ + "```\n", + "scp file.txt username@remote_host:/path/to/destination/\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "1587c830", + "metadata": {}, + "source": [ + "Alternative command is `rsync`. " + ] + }, + { + "cell_type": "markdown", + "id": "bfa46acf", + "metadata": {}, + "source": [ + "## File searching, filtering, and text processing" + ] + }, + { + "cell_type": "markdown", + "id": "9958abda", + "metadata": {}, + "source": [ + "### Command `find` \n", + "\n", + "The `find` command is designed for comprehensive file and directory sesarches. \n", + "\n", + "```\n", + "find [path] [options] [expression]\n", + "```\n" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "id": "d572f74b", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep3.fastq.gz\n", + "/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep3.fastq.gz\n", + "/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep1.fastq.gz\n", + "/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep1.fastq.gz\n", + "/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep2.fastq.gz\n", + "/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep2.fastq.gz\n" + ] + } + ], + "source": [ + "%%bash\n", + "find /home/xie186/scratch/bioi611/bulk_RNAseq -name \"*.fastq.gz\"" + ] + }, + { + "cell_type": "markdown", + "id": "993ece56", + "metadata": {}, + "source": [ + "### Text data counts `wc`" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "id": "acd73a87", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "6\n" + ] + } + ], + "source": [ + "%%bash\n", + "find /home/xie186/scratch/bioi611/bulk_RNAseq -name \"*.fastq.gz\" |wc -l " + ] + }, + { + "cell_type": "markdown", + "id": "8db86508", + "metadata": {}, + "source": [ + "### Pipe `|`\n", + "\n" + ] + }, + { + "cell_type": "markdown", + "id": "0bf35cef", + "metadata": {}, + "source": [ + "In Linux and Unix-based systems, the pipe (`|`) is used in the command line to redirect the output of one command as the input to another command. This allows you to chain commands together and perform more complex tasks in a single line." + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "id": "7e09fad4", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "7\n" + ] + } + ], + "source": [ + "%%bash\n", + "grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa |wc -l " + ] + }, + { + "cell_type": "markdown", + "id": "50ae1e87", + "metadata": {}, + "source": [ + "### Column filering" + ] + }, + { + "cell_type": "markdown", + "id": "58e4a8f1", + "metadata": {}, + "source": [ + "Command `cut` can be used to print selected parts of lines from each FILE to standard output." + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "id": "d37d9969", + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "--2024-08-25 21:08:03-- https://ncbi.nlm.nih.gov/geo/download/?type=rnaseq_counts&acc=GSE102537&format=file&file=GSE102537_raw_counts_GRCh38.p13_NCBI.tsv.gz\n", + "Resolving ncbi.nlm.nih.gov (ncbi.nlm.nih.gov)... 2607:f220:41e:4290::110, 130.14.29.110\n", + "Connecting to ncbi.nlm.nih.gov (ncbi.nlm.nih.gov)|2607:f220:41e:4290::110|:443... connected.\n", + "HTTP request sent, awaiting response... 200 OK\n", + "Length: 349584 (341K) [application/octet-stream]\n", + "Saving to: ‘GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz’\n", + "\n", + " 0K .......... .......... .......... .......... .......... 14% 6.66M 0s\n", + " 50K .......... .......... .......... .......... .......... 29% 16.9M 0s\n", + " 100K .......... .......... .......... .......... .......... 43% 27.5M 0s\n", + " 150K .......... .......... .......... .......... .......... 58% 10.1M 0s\n", + " 200K .......... .......... .......... .......... .......... 73% 17.2M 0s\n", + " 250K .......... .......... .......... .......... .......... 87% 37.6M 0s\n", + " 300K .......... .......... .......... .......... . 100% 10.5M=0.02s\n", + "\n", + "2024-08-25 21:08:04 (13.4 MB/s) - ‘GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz’ saved [349584/349584]\n", + "\n" + ] + } + ], + "source": [ + "%%bash\n", + "wget -O GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz \"https://ncbi.nlm.nih.gov/geo/download/?type=rnaseq_counts&acc=GSE102537&format=file&file=GSE102537_raw_counts_GRCh38.p13_NCBI.tsv.gz\"" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "id": "25a5bc06", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "GeneID\tGSM2740270\tGSM2740272\tGSM2740273\tGSM2740274\tGSM2740275\n", + "100287102\t9\t17\t14\t14\t19\n", + "653635\t336\t470\t467\t310\t370\n", + "102466751\t8\t56\t46\t31\t31\n", + "107985730\t0\t2\t2\t3\t3\n", + "100302278\t0\t1\t0\t0\t2\n", + "645520\t0\t3\t8\t4\t7\n", + "79501\t0\t2\t2\t1\t4\n", + "100996442\t16\t25\t34\t20\t28\n", + "729737\t19\t39\t33\t22\t26\n" + ] + } + ], + "source": [ + "%%bash\n", + "zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |head " + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "id": "b72f2ad3", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "GeneID\tGSM2740270\tGSM2740272\n", + "100287102\t9\t17\n", + "653635\t336\t470\n", + "102466751\t8\t56\n", + "107985730\t0\t2\n", + "100302278\t0\t1\n", + "645520\t0\t3\n", + "79501\t0\t2\n", + "100996442\t16\t25\n", + "729737\t19\t39\n" + ] + } + ], + "source": [ + "%%bash\n", + "zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |cut -f1,2,3 |head " + ] + }, + { + "cell_type": "markdown", + "id": "713a8b8b", + "metadata": {}, + "source": [ + "### Row filtering" + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "id": "3c1b1b8d", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + ">I dna:chromosome chromosome:WBcel235:I:1:15072434:1 REF\n", + ">II dna:chromosome chromosome:WBcel235:II:1:15279421:1 REF\n", + ">III dna:chromosome chromosome:WBcel235:III:1:13783801:1 REF\n", + ">IV dna:chromosome chromosome:WBcel235:IV:1:17493829:1 REF\n", + ">V dna:chromosome chromosome:WBcel235:V:1:20924180:1 REF\n", + ">X dna:chromosome chromosome:WBcel235:X:1:17718942:1 REF\n", + ">MtDNA dna:chromosome chromosome:WBcel235:MtDNA:1:13794:1 REF\n" + ] + } + ], + "source": [ + "%%bash\n", + "grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa " + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "id": "a6932d5c", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "39377\n", + "8773\n", + "3820\n" + ] + } + ], + "source": [ + "%%bash\n", + "zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |wc -l \n", + "zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |awk '$2>500' |wc -l \n", + "zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |awk '$2>500 && $3>500' |wc -l " + ] + }, + { + "cell_type": "markdown", + "id": "9af01c42", + "metadata": {}, + "source": [ + "### Text processing\n" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "id": "ac7e5033", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "I\n", + "II\n", + "III\n", + "IV\n", + "V\n", + "X\n", + "MtDNA\n" + ] + } + ], + "source": [ + "%%bash\n", + "grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa |sed 's/>//' |sed 's/ .*//'" + ] + }, + { + "cell_type": "markdown", + "id": "503b300f", + "metadata": {}, + "source": [ + "### Regular Expressions" + ] + }, + { + "cell_type": "markdown", + "id": "be9cd962", + "metadata": {}, + "source": [ + "Regular expressions are sequences of characters that define search patterns. They are commonly used for string matching, searching, and text processing.\n", + "\n", + "Regex is used in text editors, programming languages, command-line tools (like`grep` and `sed`), and many bioinformatics tools to search, replace, or extract data from text.\n", + "\n", + "* Metacharacters: Special characters that have specific meanings in regex syntax.\n", + "`.` (dot): Matches any single character except a newline.\n", + "Example: `A.G` matches \"AAG\", \"ATG\", \"ACG\", etc.\n", + "\n", + "`^`: Matches the start of a line.\n", + "Example: `^A` matches any line starting with \"A\".\n", + "\n", + "`$`: Matches the end of a line.\n", + "Example: `end$` matches any line ending with \"end\".\n", + "\n", + "`*`: Matches 0 or more occurrences of the preceding character.\n", + "Example: `ca*t` matches \"ct\", \"cat\", \"caat\", \"caaat\", etc.\n", + "\n", + "`+`: Matches 1 or more occurrences of the preceding character.\n", + "Example: `ca+t` matches \"cat\", \"caat\", \"caaat\", etc.\n", + "\n", + "`?`: Matches 0 or 1 occurrence of the preceding character.\n", + "Example: `colou?r` matches both \"color\" and \"colour\".\n", + "\n", + "`[]`: Matches any one of the characters inside the brackets.\n", + "Example: `[aeiou]` matches any vowel.\n", + "\n", + "`|`: Alternation (OR) operator.\n", + "Example: `cat|dog` matches either \"cat\" or \"dog\".\n", + "\n", + "\n" + ] + }, + { + "cell_type": "markdown", + "id": "83faf120", + "metadata": {}, + "source": [ + "* Character Classes: Represents a set of characters.\n", + "\n", + "`\\d`: Matches any digit (equivalent to [0-9]).\n", + "\n", + "`\\w`: Matches any word character (alphanumeric or underscore).\n", + "\n", + "`\\s`: Matches any whitespace character (spaces, tabs, etc.).\n", + "\n", + "`\\D`: Matches any non-digit character.\n", + "\n", + "`\\W`: Matches any non-word character.\n", + "\n", + "`\\S`: Matches any non-whitespace character." + ] + }, + { + "cell_type": "markdown", + "id": "4d25caa2", + "metadata": {}, + "source": [ + "* Quantifiers: Specify the number of occurrences to match\n", + "\n", + "`{n}`: Matches exactly n occurrences.\n", + "Example: A{3} matches \"AAA\".\n", + "\n", + "`{n,}`: Matches n or more occurrences.\n", + "Example: T{2,} matches \"TT\", \"TTT\", \"TTTT\", etc.\n", + "\n", + "`{n,m}`: Matches between n and m occurrences.\n", + "Example: G{1,3} matches \"G\", \"GG\", or \"GGG\".\n", + "\n", + "\n" + ] + }, + { + "cell_type": "markdown", + "id": "2b7121b6", + "metadata": {}, + "source": [ + "### An example of the command line used " + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "id": "113ed79a", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + " 22 rRNA\n", + " 100 antisense_RNA\n", + " 129 snRNA\n", + " 194 lincRNA\n", + " 261 miRNA\n", + " 346 snoRNA\n", + " 634 tRNA\n", + " 2128 pseudogene\n", + " 7764 ncRNA\n", + " 15363 piRNA\n", + " 19985 protein_coding\n" + ] + } + ], + "source": [ + "%%bash\n", + "grep -v '#' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.111.gtf \\\n", + " |awk '$3==\"gene\"' \\\n", + " |sed 's/.*gene_biotype \"//' \\\n", + " |sed 's/\";//'|sort |uniq -c \\\n", + " | sort -k1,1n" + ] + }, + { + "cell_type": "markdown", + "id": "d983a05b", + "metadata": {}, + "source": [ + "## Environment variables " + ] + }, + { + "cell_type": "markdown", + "id": "d356cc28", + "metadata": {}, + "source": [ + "Environment variables are dynamic values that affect the behavior of processes and programs in Linux. They are commonly used to store configuration data and are essential in bioinformatics workflows for defining paths to software, libraries, and datasets.\n" + ] + }, + { + "cell_type": "markdown", + "id": "5e4e9340", + "metadata": {}, + "source": [ + "### Commonly Used Environment Variables:\n", + "\n", + "* `PATH`:\n", + "\n", + "The `PATH` variable specifies directories where the system looks for executable files when a command is run." + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "id": "c64abba7", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/texlive/bin/x86_64-linux:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/imagemagick/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/graphviz/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/ghostscript/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/ffmpeg/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/mpi-nocuda/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/nompi-nocuda/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/linux-rhel8-x86_64/gcc-rh8-8.5.0/gcc-11.3.0-oedkmii7vhd6rbnqm6xufmg7d3jx4w6l/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/linux-rhel8-zen2/gcc-11.3.0/py-jupyter-1.0.0-trwwgzwljql55mhmaygcuxb3nvaevjsu/bin:/software/acigs-utilities/bin:/home/xie186/miniforge3/bin:/home/xie186/miniforge3/condabin:/home/xie186/SHELL.bioi611/software/STAR_2.7.11b/Linux_x86_64_static:/home/xie186/.local/bin:/home/xie186/bin:/software/acigs-utilities/bin:/usr/share/Modules/bin:/usr/lib/heimdal/bin:/usr/local/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/opt/symas/bin:/opt/dell/srvadmin/bin\n" + ] + } + ], + "source": [ + "%%bash\n", + "echo $PATH" + ] + }, + { + "cell_type": "markdown", + "id": "b2938c4b", + "metadata": {}, + "source": [ + "* `HOME`:\n", + "\n", + "The `HOME` variable stores the path to the user’s home directory." + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "id": "7718c865", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "/home/xie186\n" + ] + } + ], + "source": [ + "%%bash\n", + "echo $HOME" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "id": "a4349d14", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "/bin/bash\n" + ] + } + ], + "source": [ + "%%bash\n", + "echo $SHELL" + ] + }, + { + "cell_type": "markdown", + "id": "80810722", + "metadata": {}, + "source": [ + "### Setting Environment Variables:\n" + ] + }, + { + "cell_type": "markdown", + "id": "557edc67", + "metadata": {}, + "source": [ + "Temporarily setting a variable (valid only for the current shell session):\n", + "```\n", + "export PATH=value:PATH\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "f21538b4", + "metadata": {}, + "source": [ + "Permanently setting a variable:\n", + "\n", + "To make the environment variable persistent across sessions,\n", + "it needs to be added to configuration files like `.bashrc` or `.bash_profile`.\n", + "Example: Add the following line to `.bashrc`:\n" + ] + }, + { + "cell_type": "markdown", + "id": "4dca811f", + "metadata": {}, + "source": [ + "## Software installation " + ] + }, + { + "cell_type": "markdown", + "id": "c73952e2", + "metadata": {}, + "source": [ + "### Installation via Conda\n", + "\n", + "Conda is a popular package management system, especially in bioinformatics,\n", + "due to its ability to create isolated environments. This is crucial when working with tools that have conflicting dependencies.\n", + "\n", + "1. Install `conda/miniforge` \n", + "\n", + "Go to: https://github.com/conda-forge/miniforge/releases\n", + "Download the corresponding installtion file" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "id": "a0d65a15", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "x86_64\n" + ] + } + ], + "source": [ + "%%bash\n", + "uname -m" + ] + }, + { + "cell_type": "markdown", + "id": "23de5da0", + "metadata": {}, + "source": [ + "```\n", + "wget https://github.com/conda-forge/miniforge/releases/download/24.7.1-0/Mambaforge-24.7.1-0-Linux-x86_64.sh\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "958cfc47", + "metadata": {}, + "source": [ + "\n", + "2. Create conda environment and install software\n", + "```\n", + "conda create -n bioi611\n", + "conda activate bioi611\n", + "conda install bioconda::fastqc==0.11.8\n", + "```\n", + "\n", + "### Installation via Source Code (Manual Compilation)\n", + "\n", + "```\n", + "git clone https://github.com/lh3/bwa.git\n", + "cd bwa; make\n", + "./bwa index ref.fa\n", + "```\n", + "\n", + "### Using Container for Bioinformatics Tools\n", + "\n", + "https://hub.docker.com/r/biocontainers/bwa/\n", + "\n", + "```\n", + "module load singularity\n", + "singularity build bwa_v0.7.17_cv1.sif docker://biocontainers/bwa:v0.7.17_cv1\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "e5d13edd", + "metadata": {}, + "source": [ + "## Text editor in Linux\n" + ] + }, + { + "cell_type": "markdown", + "id": "02b99114", + "metadata": {}, + "source": [ + "\n", + "In Linux, we sometimes need to create or edit a text file like writing a new perl script. So we need to use text editor. \n", + "\n", + "As a newbie, someone would prefer a basic, GUI-based text editor with menus and traditional CUA key bindings. Here we recommend [Sublime](https://www.sublimetext.com/), [ATOM](https://atom.io) and [Notepad++](https://notepad-plus-plus.org/). \n", + "\n", + "But GUI-based text editor is not always available in Linux. \n", + "\n", + "A powerful screen text editor `vi` (pronounced “vee-eye”) is available on nearly all Linux system. We highly recommend `vi` as a text editor, because something we’ll have to edit a text file on a system without a friendlier text editor. Once we get familiar with `vi`, we’ll find that it’s very fast and powerful. \n", + "\n", + "But remember, it’s OK if you think this part is too difficult at the beginning. You can use either `Sublime`, `ATOM` or `Notepad++`. If you are connecting to a Linux system without `Sublime`, `ATOM` and `Notepad++`, you can write the file in a local computer and then upload the file onto Linux system. \n", + "\n", + "### Basic `vi` skills\n", + "\n", + "As `vi` uses a lot of combination of keystrokes, it may be not easy for newbies to remember all the combinations in one fell swoop. Considering this, we’ll first introduce the basic skills someone needs to know to use `vi`. We need to first understand how three modes of `vi` work and then try to remember a few basic `vi` commonds. Then we can use these skills to write Perl or R scripts in the following chaptors for Perl and R (Figure \\@ref(fig:workingModeVi)). \n", + "\n", + "Three modes of `vi`:\n", + "\n", + "![image.png](attachment:image.png)\n", + "\n", + "### Create new text file with `vi`\n", + "\n", + "```{sh}\n", + "mkdir test_vi ## generate a new folder\n", + "cd test_vi ## go into the new folder\n", + "echo \"Using \\`ls\\` we don't expect files in this folder.\"\n", + "ls \n", + "echo \"No file displayed!\"\n", + "```\n", + "\n", + "Using the code above, we made a new directory named `test_vi`. We didn't see any file. \n", + "\n", + "If we type `vi test.py`, an empty file and screen are created into which you may enter text because the file does not exist((Figure \\@ref(fig:ViNewFile))).\n", + "\n", + "\n", + "```\n", + "vi test.py\n", + "```\n", + "\n", + "A screentshot of the `vi test.py`.\n", + "\n", + "![image](https://github.com/user-attachments/assets/b131eb16-373a-4e68-b773-e5d3daa9f443)\n", + "\n", + "Now if you are in `vi mode`. To go to `Input mode`, you can type `i`, 'a' or 'o' (Figure \\@ref(fig:ViInpuMode)). \n", + "\n", + "A screentshot of the `vi test.py`.\n", + "\n", + "![image](https://github.com/user-attachments/assets/c5340078-a488-4451-9ddf-b29091801304)\n", + "\n", + "Now you can type the content (codes or other information) (\\@ref(fig:ViInpuType)).\n", + "\n", + "\n", + "Once you are done typing. You need to go to `Command mode`(Figure \\@ref(fig:workingModeVi)) if you want to save and exit the file. To do this, you need to press `ESC` button on the keyboard. \n", + "\n", + "\n", + "Now we just wrote a Perl script. We can run this script. \n", + "\n", + "\n", + "```{sh}\n", + "\n", + "python test.py\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "8b2623b7", + "metadata": {}, + "source": [ + "## High-Performance Computing (HPC) for Bioinformatics" + ] + }, + { + "cell_type": "markdown", + "id": "7be3b008", + "metadata": {}, + "source": [ + "HPC resources enable bioinformatics analyses that require significant computational power and memory.\n" + ] + }, + { + "cell_type": "markdown", + "id": "9c66725a", + "metadata": {}, + "source": [ + "### Basics of HPC clusters and job schedulers (SLURM).\n" + ] + }, + { + "cell_type": "markdown", + "id": "26e1d56f", + "metadata": {}, + "source": [ + "An example of an job file (`s1_star.sh`): " + ] + }, + { + "cell_type": "markdown", + "id": "0a0394f6", + "metadata": {}, + "source": [ + "```\n", + "#!/bin/bash\n", + "#SBATCH --partition=standard\n", + "#SBATCH -t 40:00:00\n", + "#SBATCH -n 1\n", + "#SBATCH -c 20\n", + "#SBATCH --job-name=s1_star_aln\n", + "#SBATCH --mail-type=FAIL,BEGIN,END\n", + "#SBATCH --error=%x-%J-%u.err\n", + "#SBATCH --output=%x-%J-%u.out\n", + "conda activate bioi611\n", + "mkdir -p STAR_align/\n", + "STAR --genomeDir STAR_ref \\\n", + " --outSAMtype BAM SortedByCoordinate \\\n", + " --twopassMode Basic \\\n", + " --quantMode TranscriptomeSAM GeneCounts \\\n", + " --readFilesCommand zcat \\\n", + " --outFileNamePrefix STAR_align/N2_day1_rep1. \\\n", + " --runThreadN 20 \\\n", + " --readFilesIn raw_data/N2_day1_rep1.fastq.gz\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "ee945a81", + "metadata": {}, + "source": [ + "To submit this job, run:\n", + "\n", + "```\n", + "sbatch s1_star.sh\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "ce1ea6c5", + "metadata": {}, + "source": [ + "### Check quota infomation " + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "id": "87d59bb6", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "# Group quotas\n", + " Group name Space used Space quota % quota used\n", + " zt-bioi611 285.811 MB 4.000 TB 0.01%\n", + " zt-bioi611_mgr 98.163 GB unlimited 0\n", + " total 98.449 GB unlimited 0\n", + "# User quotas\n", + " User name Space used Space quota % quota used % of GrpTotal\n", + " xie186 98.449 GB unlimited 0 100.00%\n" + ] + } + ], + "source": [ + "%%bash\n", + "scratch_quota\n", + "# shell_quota" + ] + }, + { + "cell_type": "markdown", + "id": "563371bc", + "metadata": {}, + "source": [ + "### View information about Slurm nodes and partitions." + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "id": "9b990289", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "PARTITION AVAIL TIMELIMIT NODES STATE NODELIST\n", + "debug up 15:00 1 maint compute-b8-60\n", + "debug up 15:00 1 drng compute-b8-57\n", + "debug up 15:00 1 mix compute-b8-59\n", + "debug up 15:00 1 alloc compute-b8-58\n", + "scavenger up 14-00:00:0 1 inval compute-b8-48\n", + "scavenger up 14-00:00:0 4 drain$ compute-b8-[53-56]\n", + "scavenger up 14-00:00:0 84 maint compute-a7-[5,9,14-16,28,49],compute-a8-[2-4,8-9,15,18,22,24,29,37,44,51],compute-b5-[4,16,26,29-30,33,44,51-52],compute-b6-[7,12,21,28-29,32,34,43-46,50-51,59],compute-b7-[12-13,19-22,25,27,29,31,35,37,39,42,45-46,49-50,54,56-59],compute-b8-[16,19,21,23-24,29,32,35-37,39-45,60]\n", + "scavenger up 14-00:00:0 2 drain* compute-a7-[13,43]\n", + "scavenger up 14-00:00:0 13 drng compute-a8-[7,14],compute-b7-[14-15,18,38,43-44],compute-b8-[2,20,51,57],gpu-b9-5\n", + "scavenger up 14-00:00:0 2 drain compute-a7-8,gpu-b10-5\n", + "scavenger up 14-00:00:0 182 mix bigmem-a9-[1-2,4-5],compute-a5-[3-11],compute-a7-[2-3,6-7,10,12,17-19,21-22,30,38-40,45-46,48,54-56,60],compute-a8-[5-6,10-12,16-17,19-21,25,28,31-35,39,41,45,47,50,52,54,57-59],compute-b5-[1-3,5-8,11,13-15,17-25,27-28,31-32,34-43,45-50,53-55,57-58],compute-b6-[1-5,14-15,17-20,22-24,35-36,48-49,52,54],compute-b7-[1,7-8,16-17,23-24,26,28,30,32-34,36,40-41,47-48,51-52,55,60],compute-b8-[1,15,17-18,22,25-27,30-31,33,46-47,49-50,59],gpu-b9-[1-4,6-7],gpu-b10-[1-3,6-7],gpu-b11-[1-6]\n", + "scavenger up 14-00:00:0 93 alloc bigmem-a9-[3,6],compute-a7-[1,4,11,20,23-27,29,31-37,41-42,44,47,50-53,57-59],compute-a8-[1,13,23,26-27,30,36,38,40,42-43,46,48-49,53,55-56,60],compute-b5-[9-10,12,56,59-60],compute-b6-[6,8-11,13,16,27,30-31,58,60],compute-b7-[2-6,9-11,53],compute-b8-[3-14,28,34,38,52,58],gpu-b10-4\n", + "scavenger up 14-00:00:0 14 idle compute-b6-[25-26,33,37-42,47,53,55-57]\n", + "standard* up 7-00:00:00 1 inval compute-b8-48\n", + "standard* up 7-00:00:00 4 drain$ compute-b8-[53-56]\n", + "standard* up 7-00:00:00 82 maint compute-a7-[5,9,14-16,28,49],compute-a8-[2-4,8-9,15,18,22,24,29,37,44,51],compute-b5-[4,16,26,29-30,33,44,51-52],compute-b6-[7,12,21,28-29,32,34,43-46,50-51],compute-b7-[12-13,19-22,25,27,29,31,35,37,39,42,45-46,49-50,54,56-59],compute-b8-[16,19,21,23-24,29,32,35-37,39-45]\n", + "standard* up 7-00:00:00 2 drain* compute-a7-[13,43]\n", + "standard* up 7-00:00:00 11 drng compute-a8-[7,14],compute-b7-[14-15,18,38,43-44],compute-b8-[2,20,51]\n", + "standard* up 7-00:00:00 1 drain compute-a7-8\n", + "standard* up 7-00:00:00 159 mix compute-a5-[3-11],compute-a7-[2-3,6-7,10,12,17-19,21-22,30,38-40,45-46,48,54-56,60],compute-a8-[5-6,10-12,16-17,19-21,25,28,31-35,39,41,45,47,50,52,54,57-59],compute-b5-[1-3,5-8,11,13-15,17-25,27-28,31-32,34-43,45-50,53-55,57-58],compute-b6-[1-5,14-15,17-20,22-24,35-36,48-49,52],compute-b7-[1,7-8,16-17,23-24,26,28,30,32-34,36,40-41,47-48,51-52,55,60],compute-b8-[1,15,17-18,22,25-27,30-31,33,46-47,49-50]\n", + "standard* up 7-00:00:00 87 alloc compute-a7-[1,4,11,20,23-27,29,31-37,41-42,44,47,50-53,57-59],compute-a8-[1,13,23,26-27,30,36,38,40,42-43,46,48-49,53,55-56,60],compute-b5-[9-10,12,56,59-60],compute-b6-[6,8-11,13,16,27,30-31],compute-b7-[2-6,9-11,53],compute-b8-[3-14,28,34,38,52]\n", + "standard* up 7-00:00:00 10 idle compute-b6-[25-26,33,37-42,47]\n", + "serial up 14-00:00:0 1 maint compute-b6-59\n", + "serial up 14-00:00:0 1 mix compute-b6-54\n", + "serial up 14-00:00:0 2 alloc compute-b6-[58,60]\n", + "serial up 14-00:00:0 4 idle compute-b6-[53,55-57]\n", + "gpu up 7-00:00:00 1 down$ gpu-a6-3\n", + "gpu up 7-00:00:00 1 drng gpu-b9-5\n", + "gpu up 7-00:00:00 1 drain gpu-b10-5\n", + "gpu up 7-00:00:00 19 mix gpu-a6-[6,8],gpu-b9-[1-4,6-7],gpu-b10-[1-3,6-7],gpu-b11-[1-6]\n", + "gpu up 7-00:00:00 1 alloc gpu-b10-4\n", + "gpu up 7-00:00:00 6 idle gpu-a5-1,gpu-a6-[2,4-5,7,9]\n", + "bigmem up 7-00:00:00 4 mix bigmem-a9-[1-2,4-5]\n", + "bigmem up 7-00:00:00 2 alloc bigmem-a9-[3,6]\n" + ] + } + ], + "source": [ + "%%bash\n", + "sinfo" + ] + }, + { + "cell_type": "markdown", + "id": "4b73e982", + "metadata": {}, + "source": [ + "### Check partitial information " + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "id": "bd696174", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "PartitionName=standard\n", + " AllowGroups=ALL AllowAccounts=ALL AllowQos=ALL\n", + " AllocNodes=ALL Default=YES QoS=N/A\n", + " DefaultTime=00:15:00 DisableRootJobs=NO ExclusiveUser=NO GraceTime=0 Hidden=NO\n", + " MaxNodes=UNLIMITED MaxTime=7-00:00:00 MinNodes=0 LLN=NO MaxCPUsPerNode=UNLIMITED MaxCPUsPerSocket=UNLIMITED\n", + " Nodes=compute-a5-[3-11],compute-a7-[1-60],compute-a8-[1-60],compute-b5-[1-60],compute-b6-[1-52],compute-b7-[1-60],compute-b8-[1-56]\n", + " PriorityJobFactor=1 PriorityTier=1 RootOnly=NO ReqResv=NO OverSubscribe=YES:4\n", + " OverTimeLimit=NONE PreemptMode=REQUEUE\n", + " State=UP TotalCPUs=45696 TotalNodes=357 SelectTypeParameters=NONE\n", + " JobDefaults=(null)\n", + " DefMemPerNode=UNLIMITED MaxMemPerNode=UNLIMITED\n", + " TRES=cpu=45696,mem=178500G,node=357,billing=45696\n", + " TRESBillingWeights=CPU=1.0,Mem=0.25G\n", + "\n" + ] + } + ], + "source": [ + "%%bash\n", + "scontrol show partition standard" + ] + }, + { + "cell_type": "markdown", + "id": "a09e4e29", + "metadata": {}, + "source": [ + "### Display node config information " + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "id": "8a688c12", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "NodeName=compute-a5-3 Arch=x86_64 CoresPerSocket=64 \n", + " CPUAlloc=71 CPUEfctv=128 CPUTot=128 CPULoad=68.89\n", + " AvailableFeatures=rhel8,amd,epyc_7702,ib\n", + " ActiveFeatures=rhel8,amd,epyc_7702,ib\n", + " Gres=(null)\n", + " NodeAddr=compute-a5-3 NodeHostName=compute-a5-3 Version=23.11.9\n", + " OS=Linux 4.18.0-553.5.1.el8_10.x86_64 #1 SMP Tue May 21 03:13:04 EDT 2024 \n", + " RealMemory=512000 AllocMem=296960 FreeMem=326630 Sockets=2 Boards=1\n", + " State=MIXED ThreadsPerCore=1 TmpDisk=300000 Weight=1 Owner=N/A MCS_label=N/A\n", + " Partitions=scavenger,standard \n", + " BootTime=2024-08-08T18:32:48 SlurmdStartTime=2024-08-12T17:43:23\n", + " LastBusyTime=2024-08-12T17:43:19 ResumeAfterTime=None\n", + " CfgTRES=cpu=128,mem=500G,billing=128\n", + " AllocTRES=cpu=71,mem=290G\n", + " CapWatts=n/a\n", + " CurrentWatts=630 AveWatts=294\n", + " ExtSensorsJoules=n/a ExtSensorsWatts=0 ExtSensorsTemp=n/a\n", + "\n" + ] + } + ], + "source": [ + "%%bash\n", + "scontrol show node compute-a5-3" + ] + }, + { + "cell_type": "markdown", + "id": "a7578661", + "metadata": {}, + "source": [ + "\n", + "CPU Details:\n", + "* Total CPUs: 128\n", + "* Allocated CPUs: 71\n", + "\n", + "Memory:\n", + "* Total Memory: 500 GB\n", + "* Allocated Memory: 290 GB\n", + "* Free Memory: ~319 GB\n" + ] + }, + { + "cell_type": "markdown", + "id": "a2b958ac", + "metadata": {}, + "source": [ + "### View information about jobs located in the Slurm scheduling queue." + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "id": "3f97969e", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + " JOBID PARTITION NAME USER ST TIME NODES NODELIST(REASON)\n", + " 7563417 standard sys/dash xie186 R 48:15 1 compute-a5-5\n" + ] + } + ], + "source": [ + "%%bash\n", + "squeue -u $USER" + ] + }, + { + "cell_type": "markdown", + "id": "8a79dece", + "metadata": {}, + "source": [ + "### Cancel a job " + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "d90f3c74", + "metadata": {}, + "outputs": [], + "source": [ + "%%bash\n", + "scancel " + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.10.10" + } + }, + "nbformat": 4, + "nbformat_minor": 5 +} diff --git a/basic_linux/index.html b/basic_linux/index.html new file mode 100644 index 0000000..212e526 --- /dev/null +++ b/basic_linux/index.html @@ -0,0 +1,1069 @@ + + + + + + + + Basic Linux - Lab note for UMD BIOI611 + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+
+
+ +

Linux for Bioinformatics

+ +

You are in your home directory after you log into the system and are directed to the shell command prompt. This section will show you hot to explore Linux file system using shell commands.

+

Path

+

To understand Linux file system, you can image it as a tree structure.

+

image.png

+

In Linux, a path is a unique location of a file or a directory in the file system.

+

For convenience, Linux file system is usually thought of in a tree structure. On a standard Linux system you will find the layout generally follows the scheme presented below.

+

The tree of the file system starts at the trunk or slash, indicated by a forward slash (/). This directory, containing all underlying directories and files, is also called the root directory or “the root” of the file system.

+
%%bash
+## In your account, you will see a folder
+## with you account ID as the name
+cd ~
+echo $HOME
+
+
/home/xie186
+
+

Relative and absolute path

+
    +
  • Absolute path
  • +
+

An absolute path is defined as the location of a file or directory from the root directory(/). An absolute path starts from the root of the tree (/).

+

Here are some examples:

+
/home/xie186
+/home/xie186/.bashrc
+
+
    +
  • Relative path
  • +
+

Relative path is a path related to the present working directory: +data/sample1/ and ../doc/.

+

If you want to get the absolute path based on relative path, you can use readlink with parameter -f:

+
pwd
+readlink -f ../
+
+

Once we enter into a Linux file system, we need to 1) know where we are; 2) how to get where we want; 3) how to know what files or directories we have in a particular path.

+

Check where you are using command pwd

+

In order to know where we are, we need to use pwd command. The command pwd is short for “print name of current/working directory”. It will return the full path of current directory.

+

Command pwd is almost always used by itself. This means you only need to type pwd and press ENTER

+
%%bash
+pwd
+
+

Listing the contents using command ls

+

After you know where you are, then you want to know what you have in that +directory, we can use command ls to list directory contents

+

Its syntax is:

+
ls [option]... [file]...
+
+
+

ls with no option will list files and directories in bare format. Bare format means the detailed information (type, size, modified date and time, permissions and links etc) won’t be viewed. When you use ls by itself, it will list files and directories in the current directory.

+
ls ~/
+ls -a 
+ls -ld
+
+

Linux command options can be combined without a space between them and with a single - (dash).

+

The following command is a faster way to use the l and a options and gives the same output as the Linux command shown above.

+
ls -lt ~/.bashrc
+
+
-rw-r--r--. 1 xie186 zt-bioi611 1067 Aug 22 22:27 /home/xie186/.bashrc
+
+

+
+

+
+

Change directory using command cd

+

Unlike pwd, when you use cd you usually need to provide the path (either absolute or relative path) which we want to enter.

+

If you didn’t provide any path information, you will change to home directory by default.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PathShortcutsDescription
Single dot.The current folder
Double dots..The folder above the current folder
Tilde character~Home directory (normally the directory:/home/my_login_name)
Dash-Your last working directory
+

Here are some examples:

+
cd ~
+pwd
+ls
+ls ../
+## 
+pwd
+cd ../
+pwd
+cd ./
+pwd
+
+

Each directory has two entries in it at the start, with names . (a link to itself) and .. (a link to its parent directory). The exception, of course, is the root directory, where the .. directory also refers to the root directory.

+

Sometimes you go to a new directory and do something, then you remember that you need to go to the previous working direcotry. To get back instantly, use a dash.

+
%%bash 
+
+# This is our current directory
+pwd
+
+# Let us go our home diretory
+cd ~
+
+# Check where we are
+pwd
+
+# Let us go to your previous working directory
+cd -
+# Check where we are now
+pwd
+
+
/home/xie186/BIOI611_lab/docs
+/home/xie186
+/home/xie186/BIOI611_lab/docs
+/home/xie186/BIOI611_lab/docs
+
+

Manipulations of files and directories

+

In Linux, manipulations of files and directories are the most frequent work. In this section, you will learn how to copy, rename, remove, and create files and directories.

+

Command line cp

+

In Linux, command cp can help you copy files and directories into a target directory.

+

Command line mv

+

Move files/folders and rename file/folders using mv:

+
# move file from one location to another
+mv file1 target_direcotry/
+# rename
+mv file1 file2 
+mv file1 file2 file3 target_direcotry/
+
+
+

Command mkdir

+

The syntax is shown as below:

+
mkdir [OPTION ...] DIRECTORY ...
+
+

Multiple directories can be specified when calling mkdir

+
mkdir directory1 directory2
+mkdir -p foo/bar/baz
+
+

How to defining complex directory trees with one command:

+
mkdir -p project/{software,results,doc/{html,info,pdf},scripts}
+
+
+

Then you can view the directory using tree.

+

Command rm

+

You can use rm to remove both files and directories.

+
## You can remove one file. 
+rm file1 
+## `rm` can remove multiple files simutaneously
+rm file2 file3 
+
+

You can also use 'rm' to remove a folder. If a folder is empty, you can remove it using rm with -r.

+
rm -r FOLDER
+
+

If a folder is not empty, you can remove it using rm with -r and -f.

+
mkdir test_folder
+rm -r test_folder
+
+

View text files in Linux

+

Commands cat, more and less

+

The command cat is short for concatenate files and print on the standard output.

+

The syntax is shown as below:

+
cat [OPTION]... [FILE]...
+
+

For small text file, cat can be used to view the files on the standard output.

+

The command more is old utility. When the text passed to it is too large to fit on one screen, it pages it. You can scroll down but not up.

+

The syntaxt of more is shown below:

+
more [options] file [...]
+
+

The command less was written by a man who was fed up with more’s inability to scroll backwards through a file. He turned less into an open source project and over time, various individuals added new features to it. less is massive now. That’s why some small embedded systems have more but not less. For comparison, less’s source is over 27000 lines long. more implementations are generally only a little over 2000 lines long.

+

The syntaxt of less is shown below:

+
less [options] file [...]
+
+

Command head and tail

+

The command head is used to output the first part of files. By default, it outputs the first 10 lines of the file.

+
head [OPTION]... [FILE]...
+
+

Here is an exmaple of printing the first 5 files of the file:

+
head -n 5 code_perl/variable_assign.pl
+
+

In fact, the letter n does not even need to be used at all. Just the hyphen and the integer (with no intervening space) are sufficient to tell head how many lines to return. Thus, the following would produce the same result as the above commands:

+
head -5 target_file.txt
+
+

The command tail is used to output the last part of files. By default, it prints the last 10 lines of the file to standard output.

+

The syntax is shown below:

+
tail [OPTION]... [FILE]...
+
+

Here is an exmaple of printing the last 5 files of the file:

+
tail -5 target_file.txt
+
+

To view lines from a specific point in a file, you can use -n +NUMBER with the tail command. For example, here is an example of viewing the file from the 2nd line of the line.

+
tail -n +2 target_file.txt
+
+

+
+

Auto-completion

+

In most Shell environment, programmable completion feature will also improve your speed of typing. It permits typing a partial name of command or a partial file (or directory), then pressing TAB key to auto-complete the command. If there are more than one possible completions, then TAB will list all of them.

+

A handy autocomplete feature also exists. Type one or more letters, press the Tab key twice, and then a list of functions starting with these letters appears. For example: type so, press the Tab key twice, and then you get the list as:

+
soelim        sort          sotruss       soundstretch  source        
+
+

Demonstration of programmable completion feature.

+

File permissions

+

In Linux, file permissions are a vital aspect of system security and resource management. This is particularly important in bioinformatics, where large datasets and scripts are often shared across teams. Permissions determine who can read, write, or execute a file, ensuring that critical data is not accidentally modified or deleted.

+

Three Permission Categories:

+
    +
  • User (u): The owner of the file.
  • +
  • Group (g): A group of users who share access to the file.
  • +
  • Other (o): All other users on the system.
  • +
+

Permission Types :

+
    +
  • Read (r): Ability to view the contents of a file.
  • +
  • Write (w): Ability to modify or delete the file.
  • +
  • Execute (x): Ability to run the file as a program (for scripts or executables).
  • +
+
%%bash
+groups $USER animako eunal gstewar1 mjames17 mjeakle nmilza rahooper
+
+
xie186 : zt-bioi611 zt-bioi611_mgr
+animako : zt-bioi611
+eunal : zt-bioi611
+gstewar1 : zt-bioi611
+mjames17 : zt-bioi611
+mjeakle : zt-bioi611
+nmilza : zt-bioi611
+rahooper : zt-bioi611
+
+
%%bash
+mkdir -p ~/test_permission/
+touch ~/test_permission/test.txt
+ls -l ~/test_permission/
+rm -rf ~/test_permission/
+
+
total 0
+-rw-r--r--. 1 xie186 zt-bioi611 0 Sep  8 22:52 test.txt
+
+

Here, the first character represents the type of file (e.g., - for a regular file or d for a directory), followed by three groups of three characters, each representing the permissions for the user, group, and others, respectively.

+

Examples:

+

-rwxr-xr--: The owner has read, write, and execute permissions. The group has read and execute permissions, while others can only read the file. +drwxr-x---: A directory where the owner can read, write, and access (execute). The group can only read and access, while others have no permissions.

+

Modify file permissions using the chmod command. Permissions can be set in two ways:

+

Symbolic Mode:

+

In symbolic mode, you modify permissions by referencing the categories (user, group, other) and specifying whether you're adding (+), removing (-), or setting (=) permissions.

+
# Add execute permission for the user:
+chmod u+x filename
+# Remove write permission for the group:
+chmod g-w filename
+# Set read-only permission for others:
+chmod o=r filename
+
+

Symbolic mode is intuitive and flexible, especially when you want to make precise adjustments to permissions without affecting other categories. This is useful for common file-sharing tasks in bioinformatics where you need to tweak access for specific collaborators.

+

Numeric Mode (Octal representation): +In numeric mode, file permissions are set using a three-digit number. Each digit represents the permissions foruser,group, andother, respectively. The digits are calculated by adding the values of theread,write, andexecute` permissions:

+
    +
  • Read (r) = 4
  • +
  • Write (w) = 2
  • +
  • Execute (x) = 1
  • +
+

Example Permission Breakdown:

+

Read (r), Write (w), and Execute (x) for user = 7

+

Read (r) and Execute (x) for group = 5

+

Read (r) only for others = 4

+
chmod 754 filename
+
+

An example to help you understand executable:

+
%%bash
+printf '#!/user/bin/python\nprint("Hello, Welcome to Course BIOI611!")' > ~/test.py
+
+
%%bash
+ls -l ~/test.py
+python ~/test.py
+
+
-rw-r--r--. 1 xie186 zt-bioi611 61 Sep  8 23:06 /home/xie186/test.py
+Hello, Welcome to Course BIOI611!
+
+

Error message below will be thrown out if you consider ~/test.py as a program:

+
bash: line 1: /home/xie186/test.py: No such file or directory
+
+
%%bash
+chmod u+x ~/test.py
+ls -l ~/test.py
+python ~/test.py
+rm ~/test.py
+
+
-rwxr--r--. 1 xie186 zt-bioi611 61 Sep  8 23:06 /home/xie186/test.py
+Hello, Welcome to Course BIOI611!
+
+

Disk Usage of Files and Directories

+

The Linux du (short for Disk Usage) is a standard Unix/Linux command, used to check the information of disk usage of files and directories on a machine. The du command has many parameter options that can be used to get the results in many formats. The du command also displays the files and directory sizes in a recursively manner.

+
%%bash
+du -h ~/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref
+
+
2.5G    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref
+
+
%%bash
+du -ah ~/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref
+
+
2.9M    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbList.fromGTF.out.tab
+7.5K    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/Log.out
+936M    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/SA
+1.5G    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/SAindex
+3.0M    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/transcriptInfo.tab
+2.3M    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbList.out.tab
+1.5M    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/geneInfo.tab
+1.0K    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/genomeParameters.txt
+512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrLength.txt
+512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrNameLength.txt
+512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrStart.txt
+7.6M    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/exonGeTrInfo.tab
+3.1M    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/exonInfo.tab
+2.8M    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbInfo.txt
+512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrName.txt
+119M    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/Genome
+2.5G    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref
+
+
%%bash
+du -csh /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/*
+
+
19G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/raw_data
+0   /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/raw_data_smart_seq
+1.5K    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_data.sub
+575K    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq-7478223-xie186.err
+0   /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq-7478223-xie186.out
+8.5K    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq.sub
+2.5K    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s2_star.sub
+34G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_align
+2.5G    /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref
+512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/test.sub
+512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/test.txt
+55G total
+
+ +

Symbolic link, similar to shortcuts, can point to another file/folder.

+
ln -s <path_to_files/folder_to_be_linked> <symlink_to_be_created>
+ls -l <symlink>
+unlink <symlink>
+
+
+

File Management and Data Handling

+

Compressing and decompressing files (gzip, gunzip, tar).

+

Compress one file:

+
%%bash 
+perl -e 'for($i=0; $i<10000; ++$i){ print "test\n";}' > test.txt 
+du -h test.txt
+gzip test.txt
+du -h test.txt.gz
+gunzip test.txt
+ls test.txt
+rm test.txt
+
+
52K test.txt
+4.0K    test.txt.gz
+test.txt
+
+
Compress multiple files: 
+
+
%%bash 
+perl -e 'for($i=0; $i<10000; ++$i){ print "test\n";}' > test1.txt 
+perl -e 'for($i=0; $i<10000; ++$i){ print "test\n";}' > test2.txt
+du -h test1.txt test2.txt
+tar zcvf test.tar.gz test1.txt test2.txt
+du -sh test.tar.gz
+ls test1.txt test2.txt
+
+
52K test1.txt
+52K test2.txt
+test1.txt
+test2.txt
+4.0K    test.tar.gz
+test1.txt
+test2.txt
+
+

z: This option tells tar to compress the archive using gzip. The resulting archive will have a .gz extension to indicate that it has been compressed with the gzip utility.

+

c: This option stands for create. It instructs tar to create a new archive.

+

v: This stands for verbose. When used, tar will display detailed information about the files being added to the archive, such as their names.

+

f: This stands for file. It tells tar that the next argument (test.tar.gz) is the name of the archive file to create.

+
%%bash
+tar tvf test.tar.gz
+rm test.tar.gz test1.txt test2.txt
+
+
-rw-r--r-- xie186/zt-bioi611 50000 2024-08-25 21:52 test1.txt
+-rw-r--r-- xie186/zt-bioi611 50000 2024-08-25 21:52 test2.txt
+
+

t: List the contents of archive.tar.

+

v: Display additional details about each file (like file permissions, size, and modification date).

+

f: Specifies that archive.tar is the archive file to operate on.

+

To uncompress a tar.gz file, use tar zxvf:

+
tar zxvf test.tar.gz
+
+

Transferring files within the network

+

Basic Syntax of scp:

+
scp [options] source destination
+
+
+

Copy a Local File to a Remote Server

+
+

scp file.txt username@remote_host:/path/to/destination/

+
+

Alternative command is rsync.

+

File searching, filtering, and text processing

+

Command find

+

The find command is designed for comprehensive file and directory sesarches.

+
find [path] [options] [expression]
+
+
%%bash
+find /home/xie186/scratch/bioi611/bulk_RNAseq -name "*.fastq.gz"
+
+
/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep3.fastq.gz
+/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep3.fastq.gz
+/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep1.fastq.gz
+/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep1.fastq.gz
+/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep2.fastq.gz
+/home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep2.fastq.gz
+
+

Text data counts wc

+
%%bash
+find /home/xie186/scratch/bioi611/bulk_RNAseq -name "*.fastq.gz" |wc -l 
+
+
6
+
+

Pipe |

+

In Linux and Unix-based systems, the pipe (|) is used in the command line to redirect the output of one command as the input to another command. This allows you to chain commands together and perform more complex tasks in a single line.

+
%%bash
+grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa  |wc -l 
+
+
7
+
+

Column filering

+

Command cut can be used to print selected parts of lines from each FILE to standard output.

+
%%bash
+wget -O GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz "https://ncbi.nlm.nih.gov/geo/download/?type=rnaseq_counts&acc=GSE102537&format=file&file=GSE102537_raw_counts_GRCh38.p13_NCBI.tsv.gz"
+
+
--2024-08-25 21:08:03--  https://ncbi.nlm.nih.gov/geo/download/?type=rnaseq_counts&acc=GSE102537&format=file&file=GSE102537_raw_counts_GRCh38.p13_NCBI.tsv.gz
+Resolving ncbi.nlm.nih.gov (ncbi.nlm.nih.gov)... 2607:f220:41e:4290::110, 130.14.29.110
+Connecting to ncbi.nlm.nih.gov (ncbi.nlm.nih.gov)|2607:f220:41e:4290::110|:443... connected.
+HTTP request sent, awaiting response... 200 OK
+Length: 349584 (341K) [application/octet-stream]
+Saving to: ‘GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz’
+
+     0K .......... .......... .......... .......... .......... 14% 6.66M 0s
+    50K .......... .......... .......... .......... .......... 29% 16.9M 0s
+   100K .......... .......... .......... .......... .......... 43% 27.5M 0s
+   150K .......... .......... .......... .......... .......... 58% 10.1M 0s
+   200K .......... .......... .......... .......... .......... 73% 17.2M 0s
+   250K .......... .......... .......... .......... .......... 87% 37.6M 0s
+   300K .......... .......... .......... .......... .         100% 10.5M=0.02s
+
+2024-08-25 21:08:04 (13.4 MB/s) - ‘GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz’ saved [349584/349584]
+
+
%%bash
+zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |head 
+
+
GeneID  GSM2740270  GSM2740272  GSM2740273  GSM2740274  GSM2740275
+100287102   9   17  14  14  19
+653635  336 470 467 310 370
+102466751   8   56  46  31  31
+107985730   0   2   2   3   3
+100302278   0   1   0   0   2
+645520  0   3   8   4   7
+79501   0   2   2   1   4
+100996442   16  25  34  20  28
+729737  19  39  33  22  26
+
+
%%bash
+zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |cut -f1,2,3 |head 
+
+
GeneID  GSM2740270  GSM2740272
+100287102   9   17
+653635  336 470
+102466751   8   56
+107985730   0   2
+100302278   0   1
+645520  0   3
+79501   0   2
+100996442   16  25
+729737  19  39
+
+

Row filtering

+
%%bash
+grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa 
+
+
>I dna:chromosome chromosome:WBcel235:I:1:15072434:1 REF
+>II dna:chromosome chromosome:WBcel235:II:1:15279421:1 REF
+>III dna:chromosome chromosome:WBcel235:III:1:13783801:1 REF
+>IV dna:chromosome chromosome:WBcel235:IV:1:17493829:1 REF
+>V dna:chromosome chromosome:WBcel235:V:1:20924180:1 REF
+>X dna:chromosome chromosome:WBcel235:X:1:17718942:1 REF
+>MtDNA dna:chromosome chromosome:WBcel235:MtDNA:1:13794:1 REF
+
+
%%bash
+zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |wc -l 
+zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |awk '$2>500' |wc -l 
+zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |awk '$2>500 && $3>500' |wc -l 
+
+
39377
+8773
+3820
+
+

Text processing

+
%%bash
+grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa |sed 's/>//' |sed 's/ .*//'
+
+
I
+II
+III
+IV
+V
+X
+MtDNA
+
+

Regular Expressions

+

Regular expressions are sequences of characters that define search patterns. They are commonly used for string matching, searching, and text processing.

+

Regex is used in text editors, programming languages, command-line tools (likegrep and sed), and many bioinformatics tools to search, replace, or extract data from text.

+
    +
  • Metacharacters: Special characters that have specific meanings in regex syntax. +. (dot): Matches any single character except a newline. +Example: A.G matches "AAG", "ATG", "ACG", etc.
  • +
+

^: Matches the start of a line. +Example: ^A matches any line starting with "A".

+

$: Matches the end of a line. +Example: end$ matches any line ending with "end".

+

*: Matches 0 or more occurrences of the preceding character. +Example: ca*t matches "ct", "cat", "caat", "caaat", etc.

+

+: Matches 1 or more occurrences of the preceding character. +Example: ca+t matches "cat", "caat", "caaat", etc.

+

?: Matches 0 or 1 occurrence of the preceding character. +Example: colou?r matches both "color" and "colour".

+

[]: Matches any one of the characters inside the brackets. +Example: [aeiou] matches any vowel.

+

|: Alternation (OR) operator. +Example: cat|dog matches either "cat" or "dog".

+
    +
  • Character Classes: Represents a set of characters.
  • +
+

\d: Matches any digit (equivalent to [0-9]).

+

\w: Matches any word character (alphanumeric or underscore).

+

\s: Matches any whitespace character (spaces, tabs, etc.).

+

\D: Matches any non-digit character.

+

\W: Matches any non-word character.

+

\S: Matches any non-whitespace character.

+
    +
  • Quantifiers: Specify the number of occurrences to match
  • +
+

{n}: Matches exactly n occurrences. +Example: A{3} matches "AAA".

+

{n,}: Matches n or more occurrences. +Example: T{2,} matches "TT", "TTT", "TTTT", etc.

+

{n,m}: Matches between n and m occurrences. +Example: G{1,3} matches "G", "GG", or "GGG".

+

An example of the command line used

+
%%bash
+grep -v '#' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.111.gtf \
+       |awk '$3=="gene"' \
+       |sed 's/.*gene_biotype "//' \
+       |sed 's/";//'|sort |uniq -c \
+       | sort -k1,1n
+
+
     22 rRNA
+    100 antisense_RNA
+    129 snRNA
+    194 lincRNA
+    261 miRNA
+    346 snoRNA
+    634 tRNA
+   2128 pseudogene
+   7764 ncRNA
+  15363 piRNA
+  19985 protein_coding
+
+

Environment variables

+

Environment variables are dynamic values that affect the behavior of processes and programs in Linux. They are commonly used to store configuration data and are essential in bioinformatics workflows for defining paths to software, libraries, and datasets.

+

Commonly Used Environment Variables:

+
    +
  • PATH:
  • +
+

The PATH variable specifies directories where the system looks for executable files when a command is run.

+
%%bash
+echo $PATH
+
+
/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/texlive/bin/x86_64-linux:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/imagemagick/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/graphviz/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/ghostscript/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/ffmpeg/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/mpi-nocuda/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/nompi-nocuda/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/linux-rhel8-x86_64/gcc-rh8-8.5.0/gcc-11.3.0-oedkmii7vhd6rbnqm6xufmg7d3jx4w6l/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/linux-rhel8-zen2/gcc-11.3.0/py-jupyter-1.0.0-trwwgzwljql55mhmaygcuxb3nvaevjsu/bin:/software/acigs-utilities/bin:/home/xie186/miniforge3/bin:/home/xie186/miniforge3/condabin:/home/xie186/SHELL.bioi611/software/STAR_2.7.11b/Linux_x86_64_static:/home/xie186/.local/bin:/home/xie186/bin:/software/acigs-utilities/bin:/usr/share/Modules/bin:/usr/lib/heimdal/bin:/usr/local/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/opt/symas/bin:/opt/dell/srvadmin/bin
+
+
    +
  • HOME:
  • +
+

The HOME variable stores the path to the user’s home directory.

+
%%bash
+echo $HOME
+
+
/home/xie186
+
+
%%bash
+echo $SHELL
+
+
/bin/bash
+
+

Setting Environment Variables:

+

Temporarily setting a variable (valid only for the current shell session):

+
export PATH=value:PATH
+
+

Permanently setting a variable:

+

To make the environment variable persistent across sessions, +it needs to be added to configuration files like .bashrc or .bash_profile. +Example: Add the following line to .bashrc:

+

Software installation

+

Installation via Conda

+

Conda is a popular package management system, especially in bioinformatics, +due to its ability to create isolated environments. This is crucial when working with tools that have conflicting dependencies.

+
    +
  1. Install conda/miniforge
  2. +
+

Go to: https://github.com/conda-forge/miniforge/releases +Download the corresponding installtion file

+
%%bash
+uname -m
+
+
x86_64
+
+
wget https://github.com/conda-forge/miniforge/releases/download/24.7.1-0/Mambaforge-24.7.1-0-Linux-x86_64.sh
+
+
    +
  1. Create conda environment and install software
  2. +
+
conda create -n bioi611
+conda activate bioi611
+conda install bioconda::fastqc==0.11.8
+
+

Installation via Source Code (Manual Compilation)

+
git clone https://github.com/lh3/bwa.git
+cd bwa; make
+./bwa index ref.fa
+
+

Using Container for Bioinformatics Tools

+

https://hub.docker.com/r/biocontainers/bwa/

+
module load singularity
+singularity build bwa_v0.7.17_cv1.sif  docker://biocontainers/bwa:v0.7.17_cv1
+
+

Text editor in Linux

+

In Linux, we sometimes need to create or edit a text file like writing a new perl script. So we need to use text editor.

+

As a newbie, someone would prefer a basic, GUI-based text editor with menus and traditional CUA key bindings. Here we recommend Sublime, ATOM and Notepad++.

+

But GUI-based text editor is not always available in Linux.

+

A powerful screen text editor vi (pronounced “vee-eye”) is available on nearly all Linux system. We highly recommend vi as a text editor, because something we’ll have to edit a text file on a system without a friendlier text editor. Once we get familiar with vi, we’ll find that it’s very fast and powerful.

+

But remember, it’s OK if you think this part is too difficult at the beginning. You can use either Sublime, ATOM or Notepad++. If you are connecting to a Linux system without Sublime, ATOM and Notepad++, you can write the file in a local computer and then upload the file onto Linux system.

+

Basic vi skills

+

As vi uses a lot of combination of keystrokes, it may be not easy for newbies to remember all the combinations in one fell swoop. Considering this, we’ll first introduce the basic skills someone needs to know to use vi. We need to first understand how three modes of vi work and then try to remember a few basic vi commonds. Then we can use these skills to write Perl or R scripts in the following chaptors for Perl and R (Figure \@ref(fig:workingModeVi)).

+

Three modes of vi:

+

image.png

+

Create new text file with vi

+
mkdir test_vi  ## generate a new folder
+cd test_vi     ## go into the new folder
+echo "Using \`ls\` we don't expect files in this folder."
+ls 
+echo "No file displayed!"
+
+

Using the code above, we made a new directory named test_vi. We didn't see any file.

+

If we type vi test.py, an empty file and screen are created into which you may enter text because the file does not exist((Figure \@ref(fig:ViNewFile))).

+
vi test.py
+
+

A screentshot of the vi test.py.

+

image

+

Now if you are in vi mode. To go to Input mode, you can type i, 'a' or 'o' (Figure \@ref(fig:ViInpuMode)).

+

A screentshot of the vi test.py.

+

image

+

Now you can type the content (codes or other information) (\@ref(fig:ViInpuType)).

+

Once you are done typing. You need to go to Command mode(Figure \@ref(fig:workingModeVi)) if you want to save and exit the file. To do this, you need to press ESC button on the keyboard.

+

Now we just wrote a Perl script. We can run this script.

+

+python test.py
+
+

High-Performance Computing (HPC) for Bioinformatics

+

HPC resources enable bioinformatics analyses that require significant computational power and memory.

+

Basics of HPC clusters and job schedulers (SLURM).

+

An example of an job file (s1_star.sh):

+
#!/bin/bash
+#SBATCH --partition=standard
+#SBATCH -t 40:00:00
+#SBATCH -n 1
+#SBATCH -c 20
+#SBATCH --job-name=s1_star_aln
+#SBATCH --mail-type=FAIL,BEGIN,END
+#SBATCH --error=%x-%J-%u.err
+#SBATCH --output=%x-%J-%u.out
+conda activate bioi611
+mkdir -p STAR_align/
+STAR --genomeDir STAR_ref \
+    --outSAMtype BAM SortedByCoordinate \
+    --twopassMode Basic \
+    --quantMode TranscriptomeSAM GeneCounts \
+    --readFilesCommand zcat \
+    --outFileNamePrefix STAR_align/N2_day1_rep1. \
+    --runThreadN 20 \
+    --readFilesIn raw_data/N2_day1_rep1.fastq.gz
+
+

To submit this job, run:

+
sbatch s1_star.sh
+
+

Check quota infomation

+
%%bash
+scratch_quota
+# shell_quota
+
+
# Group quotas
+          Group name     Space used    Space quota   % quota used
+          zt-bioi611     285.811 MB       4.000 TB          0.01%
+      zt-bioi611_mgr      98.163 GB      unlimited              0
+               total      98.449 GB      unlimited              0
+# User quotas
+           User name     Space used    Space quota   % quota used  % of GrpTotal
+              xie186      98.449 GB      unlimited              0        100.00%
+
+

View information about Slurm nodes and partitions.

+
%%bash
+sinfo
+
+
PARTITION AVAIL  TIMELIMIT  NODES  STATE NODELIST
+debug        up      15:00      1  maint compute-b8-60
+debug        up      15:00      1   drng compute-b8-57
+debug        up      15:00      1    mix compute-b8-59
+debug        up      15:00      1  alloc compute-b8-58
+scavenger    up 14-00:00:0      1  inval compute-b8-48
+scavenger    up 14-00:00:0      4 drain$ compute-b8-[53-56]
+scavenger    up 14-00:00:0     84  maint compute-a7-[5,9,14-16,28,49],compute-a8-[2-4,8-9,15,18,22,24,29,37,44,51],compute-b5-[4,16,26,29-30,33,44,51-52],compute-b6-[7,12,21,28-29,32,34,43-46,50-51,59],compute-b7-[12-13,19-22,25,27,29,31,35,37,39,42,45-46,49-50,54,56-59],compute-b8-[16,19,21,23-24,29,32,35-37,39-45,60]
+scavenger    up 14-00:00:0      2 drain* compute-a7-[13,43]
+scavenger    up 14-00:00:0     13   drng compute-a8-[7,14],compute-b7-[14-15,18,38,43-44],compute-b8-[2,20,51,57],gpu-b9-5
+scavenger    up 14-00:00:0      2  drain compute-a7-8,gpu-b10-5
+scavenger    up 14-00:00:0    182    mix bigmem-a9-[1-2,4-5],compute-a5-[3-11],compute-a7-[2-3,6-7,10,12,17-19,21-22,30,38-40,45-46,48,54-56,60],compute-a8-[5-6,10-12,16-17,19-21,25,28,31-35,39,41,45,47,50,52,54,57-59],compute-b5-[1-3,5-8,11,13-15,17-25,27-28,31-32,34-43,45-50,53-55,57-58],compute-b6-[1-5,14-15,17-20,22-24,35-36,48-49,52,54],compute-b7-[1,7-8,16-17,23-24,26,28,30,32-34,36,40-41,47-48,51-52,55,60],compute-b8-[1,15,17-18,22,25-27,30-31,33,46-47,49-50,59],gpu-b9-[1-4,6-7],gpu-b10-[1-3,6-7],gpu-b11-[1-6]
+scavenger    up 14-00:00:0     93  alloc bigmem-a9-[3,6],compute-a7-[1,4,11,20,23-27,29,31-37,41-42,44,47,50-53,57-59],compute-a8-[1,13,23,26-27,30,36,38,40,42-43,46,48-49,53,55-56,60],compute-b5-[9-10,12,56,59-60],compute-b6-[6,8-11,13,16,27,30-31,58,60],compute-b7-[2-6,9-11,53],compute-b8-[3-14,28,34,38,52,58],gpu-b10-4
+scavenger    up 14-00:00:0     14   idle compute-b6-[25-26,33,37-42,47,53,55-57]
+standard*    up 7-00:00:00      1  inval compute-b8-48
+standard*    up 7-00:00:00      4 drain$ compute-b8-[53-56]
+standard*    up 7-00:00:00     82  maint compute-a7-[5,9,14-16,28,49],compute-a8-[2-4,8-9,15,18,22,24,29,37,44,51],compute-b5-[4,16,26,29-30,33,44,51-52],compute-b6-[7,12,21,28-29,32,34,43-46,50-51],compute-b7-[12-13,19-22,25,27,29,31,35,37,39,42,45-46,49-50,54,56-59],compute-b8-[16,19,21,23-24,29,32,35-37,39-45]
+standard*    up 7-00:00:00      2 drain* compute-a7-[13,43]
+standard*    up 7-00:00:00     11   drng compute-a8-[7,14],compute-b7-[14-15,18,38,43-44],compute-b8-[2,20,51]
+standard*    up 7-00:00:00      1  drain compute-a7-8
+standard*    up 7-00:00:00    159    mix compute-a5-[3-11],compute-a7-[2-3,6-7,10,12,17-19,21-22,30,38-40,45-46,48,54-56,60],compute-a8-[5-6,10-12,16-17,19-21,25,28,31-35,39,41,45,47,50,52,54,57-59],compute-b5-[1-3,5-8,11,13-15,17-25,27-28,31-32,34-43,45-50,53-55,57-58],compute-b6-[1-5,14-15,17-20,22-24,35-36,48-49,52],compute-b7-[1,7-8,16-17,23-24,26,28,30,32-34,36,40-41,47-48,51-52,55,60],compute-b8-[1,15,17-18,22,25-27,30-31,33,46-47,49-50]
+standard*    up 7-00:00:00     87  alloc compute-a7-[1,4,11,20,23-27,29,31-37,41-42,44,47,50-53,57-59],compute-a8-[1,13,23,26-27,30,36,38,40,42-43,46,48-49,53,55-56,60],compute-b5-[9-10,12,56,59-60],compute-b6-[6,8-11,13,16,27,30-31],compute-b7-[2-6,9-11,53],compute-b8-[3-14,28,34,38,52]
+standard*    up 7-00:00:00     10   idle compute-b6-[25-26,33,37-42,47]
+serial       up 14-00:00:0      1  maint compute-b6-59
+serial       up 14-00:00:0      1    mix compute-b6-54
+serial       up 14-00:00:0      2  alloc compute-b6-[58,60]
+serial       up 14-00:00:0      4   idle compute-b6-[53,55-57]
+gpu          up 7-00:00:00      1  down$ gpu-a6-3
+gpu          up 7-00:00:00      1   drng gpu-b9-5
+gpu          up 7-00:00:00      1  drain gpu-b10-5
+gpu          up 7-00:00:00     19    mix gpu-a6-[6,8],gpu-b9-[1-4,6-7],gpu-b10-[1-3,6-7],gpu-b11-[1-6]
+gpu          up 7-00:00:00      1  alloc gpu-b10-4
+gpu          up 7-00:00:00      6   idle gpu-a5-1,gpu-a6-[2,4-5,7,9]
+bigmem       up 7-00:00:00      4    mix bigmem-a9-[1-2,4-5]
+bigmem       up 7-00:00:00      2  alloc bigmem-a9-[3,6]
+
+

Check partitial information

+
%%bash
+scontrol show partition standard
+
+
PartitionName=standard
+   AllowGroups=ALL AllowAccounts=ALL AllowQos=ALL
+   AllocNodes=ALL Default=YES QoS=N/A
+   DefaultTime=00:15:00 DisableRootJobs=NO ExclusiveUser=NO GraceTime=0 Hidden=NO
+   MaxNodes=UNLIMITED MaxTime=7-00:00:00 MinNodes=0 LLN=NO MaxCPUsPerNode=UNLIMITED MaxCPUsPerSocket=UNLIMITED
+   Nodes=compute-a5-[3-11],compute-a7-[1-60],compute-a8-[1-60],compute-b5-[1-60],compute-b6-[1-52],compute-b7-[1-60],compute-b8-[1-56]
+   PriorityJobFactor=1 PriorityTier=1 RootOnly=NO ReqResv=NO OverSubscribe=YES:4
+   OverTimeLimit=NONE PreemptMode=REQUEUE
+   State=UP TotalCPUs=45696 TotalNodes=357 SelectTypeParameters=NONE
+   JobDefaults=(null)
+   DefMemPerNode=UNLIMITED MaxMemPerNode=UNLIMITED
+   TRES=cpu=45696,mem=178500G,node=357,billing=45696
+   TRESBillingWeights=CPU=1.0,Mem=0.25G
+
+

Display node config information

+
%%bash
+scontrol show node compute-a5-3
+
+
NodeName=compute-a5-3 Arch=x86_64 CoresPerSocket=64 
+   CPUAlloc=71 CPUEfctv=128 CPUTot=128 CPULoad=68.89
+   AvailableFeatures=rhel8,amd,epyc_7702,ib
+   ActiveFeatures=rhel8,amd,epyc_7702,ib
+   Gres=(null)
+   NodeAddr=compute-a5-3 NodeHostName=compute-a5-3 Version=23.11.9
+   OS=Linux 4.18.0-553.5.1.el8_10.x86_64 #1 SMP Tue May 21 03:13:04 EDT 2024 
+   RealMemory=512000 AllocMem=296960 FreeMem=326630 Sockets=2 Boards=1
+   State=MIXED ThreadsPerCore=1 TmpDisk=300000 Weight=1 Owner=N/A MCS_label=N/A
+   Partitions=scavenger,standard 
+   BootTime=2024-08-08T18:32:48 SlurmdStartTime=2024-08-12T17:43:23
+   LastBusyTime=2024-08-12T17:43:19 ResumeAfterTime=None
+   CfgTRES=cpu=128,mem=500G,billing=128
+   AllocTRES=cpu=71,mem=290G
+   CapWatts=n/a
+   CurrentWatts=630 AveWatts=294
+   ExtSensorsJoules=n/a ExtSensorsWatts=0 ExtSensorsTemp=n/a
+
+

CPU Details: +* Total CPUs: 128 +* Allocated CPUs: 71

+

Memory: +* Total Memory: 500 GB +* Allocated Memory: 290 GB +* Free Memory: ~319 GB

+

View information about jobs located in the Slurm scheduling queue.

+
%%bash
+squeue -u $USER
+
+
             JOBID PARTITION     NAME     USER ST       TIME  NODES NODELIST(REASON)
+           7563417  standard sys/dash   xie186  R      48:15      1 compute-a5-5
+
+

Cancel a job

+
%%bash
+scancel <JOBID>
+
+ +
+
+ +
+
+ +
+ +
+ +
+ + + + Bix4UMD/BIOI611_lab + + + + + Next » + + +
+ + + + + + + + + diff --git a/basic_linux_files/9aa63990-e065-4ee7-aee6-c0e56c67cc38.png b/basic_linux_files/9aa63990-e065-4ee7-aee6-c0e56c67cc38.png new file mode 100644 index 0000000..a0052c9 Binary files /dev/null and b/basic_linux_files/9aa63990-e065-4ee7-aee6-c0e56c67cc38.png differ diff --git a/bulkRNAseq_lab.ipynb b/bulkRNAseq_lab.ipynb new file mode 100644 index 0000000..994c98f --- /dev/null +++ b/bulkRNAseq_lab.ipynb @@ -0,0 +1,293 @@ +{ + "cells": [ + { + "cell_type": "code", + "execution_count": null, + "id": "9c5f7823", + "metadata": {}, + "outputs": [], + "source": [ + "# @hidden_cell\n", + "import os\n", + "os.chdir('/')" + ] + }, + { + "cell_type": "markdown", + "id": "fae78bdc-2102-4b84-92b6-86966c1cc232", + "metadata": {}, + "source": [ + "## Download reference genome " + ] + }, + { + "cell_type": "markdown", + "id": "13fff280-eecc-4ddc-93a5-d4bf7d7baf46", + "metadata": {}, + "source": [ + "\n", + "To download the reference for this lab, we use [ENSEMBL database](https://useast.ensembl.org/Caenorhabditis_elegans/Info/Index). \n", + "In ENSEMBL database, each species may have different releases of genome build. We use `release-111` in this project. \n", + "\n", + "The genome sequences can be obtained from the link below:\n", + "https://ftp.ensembl.org/pub/release-111/fasta/caenorhabditis_elegans/dna/\n", + "\n", + "The genoe anntation file in gtf format can be obtained here: \n", + "https://ftp.ensembl.org/pub/release-111/gtf/caenorhabditis_elegans/\n" + ] + }, + { + "cell_type": "markdown", + "id": "177be9c6", + "metadata": {}, + "source": [ + "```\n", + "%%bash\n", + "wget -O Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz https://ftp.ensembl.org/pub/release-111/fasta/caenorhabditis_elegans/dna/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz\n", + "gunzip Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "a6a910ba", + "metadata": {}, + "source": [ + "```\n", + "%%bash\n", + "## A *fai file will be generated\n", + "samtools faidx ref/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa \n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "a636c9e5", + "metadata": {}, + "source": [ + "```\n", + "%%bash\n", + "wget -O Caenorhabditis_elegans.WBcel235.111.gtf.gz -nv https://ftp.ensembl.org/pub/release-111/gtf/caenorhabditis_elegans/Caenorhabditis_elegans.WBcel235.111.gtf.gz\n", + "gunzip Caenorhabditis_elegans.WBcel235.111.gtf.gz\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "1d71d18a", + "metadata": {}, + "source": [ + "In this course, the reference files have been downloaded and stored in shared folder for BIOI611:\n", + "/scratch/zt1/project/bioi611/shared/reference/\n", + "\n", + "As you already leart, you can create a symbolic link for you to use in your scratch folder: \n", + "\n" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "id": "59184e9e", + "metadata": {}, + "outputs": [], + "source": [ + "%%bash\n", + "cd /scratch/zt1/project/bioi611/user/$USER\n", + "ln -s /scratch/zt1/project/bioi611/shared/reference/ ." + ] + }, + { + "cell_type": "markdown", + "id": "13b0bad9-a31a-4d0b-9b0c-445a4752f0d1", + "metadata": {}, + "source": [ + "### How many chromsomes there are " + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "id": "4123f560-aceb-4e54-a0ea-b52ce813a83a", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + ">I dna:chromosome chromosome:WBcel235:I:1:15072434:1 REF\n", + ">II dna:chromosome chromosome:WBcel235:II:1:15279421:1 REF\n", + ">III dna:chromosome chromosome:WBcel235:III:1:13783801:1 REF\n", + ">IV dna:chromosome chromosome:WBcel235:IV:1:17493829:1 REF\n", + ">V dna:chromosome chromosome:WBcel235:V:1:20924180:1 REF\n", + ">X dna:chromosome chromosome:WBcel235:X:1:17718942:1 REF\n", + ">MtDNA dna:chromosome chromosome:WBcel235:MtDNA:1:13794:1 REF\n" + ] + } + ], + "source": [ + "%%bash\n", + "cd /scratch/zt1/project/bioi611/user/$USER\n", + "grep '>' reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa" + ] + }, + { + "cell_type": "markdown", + "id": "888e6856-762d-419c-b2a8-5e65c057dc54", + "metadata": {}, + "source": [ + "### How many genes there are " + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "id": "32313747-7131-4cfa-9b4f-1eb1728aa81d", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + " 22 rRNA\n", + " 100 antisense_RNA\n", + " 129 snRNA\n", + " 194 lincRNA\n", + " 261 miRNA\n", + " 346 snoRNA\n", + " 634 tRNA\n", + " 2128 pseudogene\n", + " 7764 ncRNA\n", + " 15363 piRNA\n", + " 19985 protein_coding\n" + ] + } + ], + "source": [ + "%%bash\n", + "cd /scratch/zt1/project/bioi611/user/$USER\n", + "\n", + "grep -v '#' reference/Caenorhabditis_elegans.WBcel235.111.gtf \\\n", + " |awk '$3==\"gene\"' \\\n", + " |sed 's/.*gene_biotype \"//' \\\n", + " |sed 's/\";//'|sort |uniq -c \\\n", + " | sort -k1,1n" + ] + }, + { + "attachments": { + "ffadf6f7-cfd1-4cdd-907e-7d4ac12c2a76.png": { + "image/png": "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" + } + }, + "cell_type": "markdown", + "id": "7a7bde26-6670-4df7-a5f8-6b7f3d2100f7", + "metadata": {}, + "source": [ + "![image.png](attachment:ffadf6f7-cfd1-4cdd-907e-7d4ac12c2a76.png)\n", + "Source: https://useast.ensembl.org/Help/Faq?id=468eudogene\n" + ] + }, + { + "cell_type": "markdown", + "id": "3f1c8a42", + "metadata": {}, + "source": [ + "## Download raw fastq files" + ] + }, + { + "cell_type": "markdown", + "id": "d85fdda7", + "metadata": {}, + "source": [ + "```\n", + "%%bash\n", + "mkdir -p raw_data/ \n", + "curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/002/SRR15694102/SRR15694102.fastq.gz -o raw_data/N2_day7_rep1.fastq.gz\n", + "curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/001/SRR15694101/SRR15694101.fastq.gz -o raw_data/N2_day7_rep2.fastq.gz\n", + "curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/000/SRR15694100/SRR15694100.fastq.gz -o raw_data/N2_day7_rep3.fastq.gz\n", + "curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/099/SRR15694099/SRR15694099.fastq.gz -o raw_data/N2_day1_rep1.fastq.gz\n", + "curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/098/SRR15694098/SRR15694098.fastq.gz -o raw_data/N2_day1_rep2.fastq.gz\n", + "curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/097/SRR15694097/SRR15694097.fastq.gz -o raw_data/N2_day1_rep3.fastq.gz\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "e574da47", + "metadata": {}, + "source": [ + "## Quality control " + ] + }, + { + "cell_type": "markdown", + "id": "c9298b90", + "metadata": {}, + "source": [ + "1. Use FastQC to check the quality of fastq files:" + ] + }, + { + "cell_type": "markdown", + "id": "6951d0e5", + "metadata": {}, + "source": [ + "```\n", + "%%bash\n", + "cd /scratch/zt1/project/bioi611/user/$USER\n", + "sbatch ../../shared/scripts/bulkRNA_s1_fastqc.sub\n", + "```" + ] + }, + { + "cell_type": "markdown", + "id": "3a223f5a", + "metadata": {}, + "source": [ + "2. Use `trim galore` to remove adaptors, low quality bases and low quality reads. " + ] + }, + { + "cell_type": "markdown", + "id": "2f673a41", + "metadata": {}, + "source": [ + "```\n", + "%%bash\n", + "cd /scratch/zt1/project/bioi611/user/$USER\n", + "sbatch ../../shared/scripts/bulkRNA_s2_trim_galore.sub\n", + "```" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "84fb878c", + "metadata": {}, + "outputs": [], + "source": [] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.10.10" + } + }, + "nbformat": 4, + "nbformat_minor": 5 +} diff --git a/bulkRNAseq_lab/index.html b/bulkRNAseq_lab/index.html new file mode 100644 index 0000000..2f6e69c --- /dev/null +++ b/bulkRNAseq_lab/index.html @@ -0,0 +1,233 @@ + + + + + + + + Prepare data - Lab note for UMD BIOI611 + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+
+
+ +
# @hidden_cell
+import os
+os.chdir('/')
+
+

Download reference genome

+

To download the reference for this lab, we use ENSEMBL database. +In ENSEMBL database, each species may have different releases of genome build. We use release-111 in this project.

+

The genome sequences can be obtained from the link below: +https://ftp.ensembl.org/pub/release-111/fasta/caenorhabditis_elegans/dna/

+

The genoe anntation file in gtf format can be obtained here: +https://ftp.ensembl.org/pub/release-111/gtf/caenorhabditis_elegans/

+
%%bash
+wget -O Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz https://ftp.ensembl.org/pub/release-111/fasta/caenorhabditis_elegans/dna/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz
+gunzip Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz
+
+
%%bash
+## A *fai file will be generated
+samtools faidx ref/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa 
+
+
%%bash
+wget -O Caenorhabditis_elegans.WBcel235.111.gtf.gz -nv https://ftp.ensembl.org/pub/release-111/gtf/caenorhabditis_elegans/Caenorhabditis_elegans.WBcel235.111.gtf.gz
+gunzip Caenorhabditis_elegans.WBcel235.111.gtf.gz
+
+

In this course, the reference files have been downloaded and stored in shared folder for BIOI611: +/scratch/zt1/project/bioi611/shared/reference/

+

As you already leart, you can create a symbolic link for you to use in your scratch folder:

+
%%bash
+cd /scratch/zt1/project/bioi611/user/$USER
+ln -s /scratch/zt1/project/bioi611/shared/reference/ .
+
+

How many chromsomes there are

+
%%bash
+cd /scratch/zt1/project/bioi611/user/$USER
+grep '>' reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa
+
+
>I dna:chromosome chromosome:WBcel235:I:1:15072434:1 REF
+>II dna:chromosome chromosome:WBcel235:II:1:15279421:1 REF
+>III dna:chromosome chromosome:WBcel235:III:1:13783801:1 REF
+>IV dna:chromosome chromosome:WBcel235:IV:1:17493829:1 REF
+>V dna:chromosome chromosome:WBcel235:V:1:20924180:1 REF
+>X dna:chromosome chromosome:WBcel235:X:1:17718942:1 REF
+>MtDNA dna:chromosome chromosome:WBcel235:MtDNA:1:13794:1 REF
+
+

How many genes there are

+
%%bash
+cd /scratch/zt1/project/bioi611/user/$USER
+
+grep -v '#' reference/Caenorhabditis_elegans.WBcel235.111.gtf \
+       |awk '$3=="gene"' \
+       |sed 's/.*gene_biotype "//' \
+       |sed 's/";//'|sort |uniq -c \
+       | sort -k1,1n
+
+
     22 rRNA
+    100 antisense_RNA
+    129 snRNA
+    194 lincRNA
+    261 miRNA
+    346 snoRNA
+    634 tRNA
+   2128 pseudogene
+   7764 ncRNA
+  15363 piRNA
+  19985 protein_coding
+
+

image.png +Source: https://useast.ensembl.org/Help/Faq?id=468eudogene

+

Download raw fastq files

+
%%bash
+mkdir -p raw_data/ 
+curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/002/SRR15694102/SRR15694102.fastq.gz -o raw_data/N2_day7_rep1.fastq.gz
+curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/001/SRR15694101/SRR15694101.fastq.gz -o raw_data/N2_day7_rep2.fastq.gz
+curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/000/SRR15694100/SRR15694100.fastq.gz -o raw_data/N2_day7_rep3.fastq.gz
+curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/099/SRR15694099/SRR15694099.fastq.gz -o raw_data/N2_day1_rep1.fastq.gz
+curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/098/SRR15694098/SRR15694098.fastq.gz -o raw_data/N2_day1_rep2.fastq.gz
+curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/097/SRR15694097/SRR15694097.fastq.gz -o raw_data/N2_day1_rep3.fastq.gz
+
+

Quality control

+
    +
  1. Use FastQC to check the quality of fastq files:
  2. +
+
%%bash
+cd /scratch/zt1/project/bioi611/user/$USER
+sbatch ../../shared/scripts/bulkRNA_s1_fastqc.sub
+
+
    +
  1. Use trim galore to remove adaptors, low quality bases and low quality reads.
  2. +
+
%%bash
+cd /scratch/zt1/project/bioi611/user/$USER
+sbatch ../../shared/scripts/bulkRNA_s2_trim_galore.sub
+
+

+
+ +
+
+ +
+
+ +
+ +
+ +
+ + + + Bix4UMD/BIOI611_lab + + + + « Previous + + + Next » + + +
+ + + + + + + + + diff --git a/bulkRNAseq_lab_files/ffadf6f7-cfd1-4cdd-907e-7d4ac12c2a76.png b/bulkRNAseq_lab_files/ffadf6f7-cfd1-4cdd-907e-7d4ac12c2a76.png new file mode 100644 index 0000000..4b6e1ee Binary files /dev/null and b/bulkRNAseq_lab_files/ffadf6f7-cfd1-4cdd-907e-7d4ac12c2a76.png differ diff --git a/css/fonts/Roboto-Slab-Bold.woff b/css/fonts/Roboto-Slab-Bold.woff new file mode 100644 index 0000000..6cb6000 Binary files /dev/null and b/css/fonts/Roboto-Slab-Bold.woff differ diff --git a/css/fonts/Roboto-Slab-Bold.woff2 b/css/fonts/Roboto-Slab-Bold.woff2 new file mode 100644 index 0000000..7059e23 Binary files /dev/null and b/css/fonts/Roboto-Slab-Bold.woff2 differ diff --git a/css/fonts/Roboto-Slab-Regular.woff b/css/fonts/Roboto-Slab-Regular.woff new file mode 100644 index 0000000..f815f63 Binary files /dev/null and b/css/fonts/Roboto-Slab-Regular.woff differ diff --git a/css/fonts/Roboto-Slab-Regular.woff2 b/css/fonts/Roboto-Slab-Regular.woff2 new file mode 100644 index 0000000..f2c76e5 Binary files /dev/null and b/css/fonts/Roboto-Slab-Regular.woff2 differ diff --git a/css/fonts/fontawesome-webfont.eot b/css/fonts/fontawesome-webfont.eot new file mode 100644 index 0000000..e9f60ca Binary files /dev/null and b/css/fonts/fontawesome-webfont.eot differ diff --git a/css/fonts/fontawesome-webfont.svg b/css/fonts/fontawesome-webfont.svg new file mode 100644 index 0000000..855c845 --- /dev/null +++ b/css/fonts/fontawesome-webfont.svg @@ -0,0 +1,2671 @@ + + + + +Created by FontForge 20120731 at Mon Oct 24 17:37:40 2016 + By ,,, +Copyright Dave Gandy 2016. All rights reserved. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/css/fonts/fontawesome-webfont.ttf b/css/fonts/fontawesome-webfont.ttf new file mode 100644 index 0000000..35acda2 Binary files /dev/null and b/css/fonts/fontawesome-webfont.ttf differ diff --git a/css/fonts/fontawesome-webfont.woff b/css/fonts/fontawesome-webfont.woff new file mode 100644 index 0000000..400014a Binary files /dev/null and b/css/fonts/fontawesome-webfont.woff differ diff --git a/css/fonts/fontawesome-webfont.woff2 b/css/fonts/fontawesome-webfont.woff2 new file mode 100644 index 0000000..4d13fc6 Binary files /dev/null and b/css/fonts/fontawesome-webfont.woff2 differ diff --git a/css/fonts/lato-bold-italic.woff b/css/fonts/lato-bold-italic.woff new file mode 100644 index 0000000..88ad05b Binary files /dev/null and b/css/fonts/lato-bold-italic.woff differ diff --git a/css/fonts/lato-bold-italic.woff2 b/css/fonts/lato-bold-italic.woff2 new file mode 100644 index 0000000..c4e3d80 Binary files /dev/null and b/css/fonts/lato-bold-italic.woff2 differ diff --git a/css/fonts/lato-bold.woff b/css/fonts/lato-bold.woff new file mode 100644 index 0000000..c6dff51 Binary files /dev/null and b/css/fonts/lato-bold.woff differ diff --git a/css/fonts/lato-bold.woff2 b/css/fonts/lato-bold.woff2 new file mode 100644 index 0000000..bb19504 Binary files /dev/null and b/css/fonts/lato-bold.woff2 differ diff --git a/css/fonts/lato-normal-italic.woff b/css/fonts/lato-normal-italic.woff new file mode 100644 index 0000000..76114bc Binary files /dev/null and b/css/fonts/lato-normal-italic.woff differ diff --git a/css/fonts/lato-normal-italic.woff2 b/css/fonts/lato-normal-italic.woff2 new file mode 100644 index 0000000..3404f37 Binary files /dev/null and b/css/fonts/lato-normal-italic.woff2 differ diff --git a/css/fonts/lato-normal.woff b/css/fonts/lato-normal.woff new file mode 100644 index 0000000..ae1307f Binary files /dev/null and b/css/fonts/lato-normal.woff differ diff --git a/css/fonts/lato-normal.woff2 b/css/fonts/lato-normal.woff2 new file mode 100644 index 0000000..3bf9843 Binary files /dev/null and b/css/fonts/lato-normal.woff2 differ diff --git a/css/theme.css b/css/theme.css new file mode 100644 index 0000000..ad77300 --- /dev/null +++ b/css/theme.css @@ -0,0 +1,13 @@ +/* + * This file is copied from the upstream ReadTheDocs Sphinx + * theme. To aid upgradability this file should *not* be edited. + * modifications we need should be included in theme_extra.css. + * + * https://github.com/readthedocs/sphinx_rtd_theme + */ + + /* sphinx_rtd_theme version 1.2.0 | MIT license */ +html{box-sizing:border-box}*,:after,:before{box-sizing:inherit}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}[hidden],audio:not([controls]){display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;text-decoration:none}ins,mark{color:#000}mark{background:#ff0;font-style:italic;font-weight:700}.rst-content code,.rst-content tt,code,kbd,pre,samp{font-family:monospace,serif;_font-family:courier new,monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:after,q:before{content:"";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}dl,ol,ul{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure,form{margin:0}label{cursor:pointer}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type=button],input[type=reset],input[type=submit]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}textarea{resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none!important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{body,html,section{background:none!important}*{box-shadow:none!important;text-shadow:none!important;filter:none!important;-ms-filter:none!important}a,a:visited{text-decoration:underline}.ir a:after,a[href^="#"]:after,a[href^="javascript:"]:after{content:""}blockquote,pre{page-break-inside:avoid}thead{display:table-header-group}img,tr{page-break-inside:avoid}img{max-width:100%!important}@page{margin:.5cm}.rst-content .toctree-wrapper>p.caption,h2,h3,p{orphans:3;widows:3}.rst-content .toctree-wrapper>p.caption,h2,h3{page-break-after:avoid}}.btn,.fa:before,.icon:before,.rst-content .admonition,.rst-content .admonition-title:before,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .code-block-caption .headerlink:before,.rst-content .danger,.rst-content .eqno .headerlink:before,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-alert,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before,input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week],select,textarea{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}/*! + * Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome + * License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License) + */@font-face{font-family:FontAwesome;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713);src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix&v=4.7.0) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#fontawesomeregular) format("svg");font-weight:400;font-style:normal}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.33333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.28571em;text-align:center}.fa-ul{padding-left:0;margin-left:2.14286em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.14286em;width:2.14286em;top:.14286em;text-align:center}.fa-li.fa-lg{left:-1.85714em}.fa-border{padding:.2em .25em .15em;border:.08em solid #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa-pull-left.icon,.fa.fa-pull-left,.rst-content .code-block-caption .fa-pull-left.headerlink,.rst-content .eqno .fa-pull-left.headerlink,.rst-content .fa-pull-left.admonition-title,.rst-content code.download span.fa-pull-left:first-child,.rst-content dl dt .fa-pull-left.headerlink,.rst-content h1 .fa-pull-left.headerlink,.rst-content h2 .fa-pull-left.headerlink,.rst-content h3 .fa-pull-left.headerlink,.rst-content h4 .fa-pull-left.headerlink,.rst-content h5 .fa-pull-left.headerlink,.rst-content h6 .fa-pull-left.headerlink,.rst-content p .fa-pull-left.headerlink,.rst-content table>caption .fa-pull-left.headerlink,.rst-content tt.download span.fa-pull-left:first-child,.wy-menu-vertical li.current>a button.fa-pull-left.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-left.toctree-expand,.wy-menu-vertical li button.fa-pull-left.toctree-expand{margin-right:.3em}.fa-pull-right.icon,.fa.fa-pull-right,.rst-content .code-block-caption .fa-pull-right.headerlink,.rst-content .eqno .fa-pull-right.headerlink,.rst-content .fa-pull-right.admonition-title,.rst-content code.download span.fa-pull-right:first-child,.rst-content dl dt .fa-pull-right.headerlink,.rst-content h1 .fa-pull-right.headerlink,.rst-content h2 .fa-pull-right.headerlink,.rst-content h3 .fa-pull-right.headerlink,.rst-content h4 .fa-pull-right.headerlink,.rst-content h5 .fa-pull-right.headerlink,.rst-content h6 .fa-pull-right.headerlink,.rst-content p .fa-pull-right.headerlink,.rst-content table>caption .fa-pull-right.headerlink,.rst-content tt.download span.fa-pull-right:first-child,.wy-menu-vertical li.current>a button.fa-pull-right.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-right.toctree-expand,.wy-menu-vertical li button.fa-pull-right.toctree-expand{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.pull-left.icon,.rst-content .code-block-caption .pull-left.headerlink,.rst-content .eqno .pull-left.headerlink,.rst-content .pull-left.admonition-title,.rst-content code.download span.pull-left:first-child,.rst-content dl dt .pull-left.headerlink,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content p .pull-left.headerlink,.rst-content table>caption .pull-left.headerlink,.rst-content tt.download span.pull-left:first-child,.wy-menu-vertical li.current>a button.pull-left.toctree-expand,.wy-menu-vertical li.on a button.pull-left.toctree-expand,.wy-menu-vertical li button.pull-left.toctree-expand{margin-right:.3em}.fa.pull-right,.pull-right.icon,.rst-content .code-block-caption .pull-right.headerlink,.rst-content .eqno .pull-right.headerlink,.rst-content .pull-right.admonition-title,.rst-content code.download span.pull-right:first-child,.rst-content dl dt .pull-right.headerlink,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content p .pull-right.headerlink,.rst-content table>caption .pull-right.headerlink,.rst-content tt.download span.pull-right:first-child,.wy-menu-vertical li.current>a button.pull-right.toctree-expand,.wy-menu-vertical li.on a button.pull-right.toctree-expand,.wy-menu-vertical li button.pull-right.toctree-expand{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s linear infinite;animation:fa-spin 2s linear infinite}.fa-pulse{-webkit-animation:fa-spin 1s steps(8) infinite;animation:fa-spin 1s steps(8) infinite}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scaleX(-1);-ms-transform:scaleX(-1);transform:scaleX(-1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scaleY(-1);-ms-transform:scaleY(-1);transform:scaleY(-1)}:root .fa-flip-horizontal,:root .fa-flip-vertical,:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:""}.fa-music:before{content:""}.fa-search:before,.icon-search:before{content:""}.fa-envelope-o:before{content:""}.fa-heart:before{content:""}.fa-star:before{content:""}.fa-star-o:before{content:""}.fa-user:before{content:""}.fa-film:before{content:""}.fa-th-large:before{content:""}.fa-th:before{content:""}.fa-th-list:before{content:""}.fa-check:before{content:""}.fa-close:before,.fa-remove:before,.fa-times:before{content:""}.fa-search-plus:before{content:""}.fa-search-minus:before{content:""}.fa-power-off:before{content:""}.fa-signal:before{content:""}.fa-cog:before,.fa-gear:before{content:""}.fa-trash-o:before{content:""}.fa-home:before,.icon-home:before{content:""}.fa-file-o:before{content:""}.fa-clock-o:before{content:""}.fa-road:before{content:""}.fa-download:before,.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{content:""}.fa-arrow-circle-o-down:before{content:""}.fa-arrow-circle-o-up:before{content:""}.fa-inbox:before{content:""}.fa-play-circle-o:before{content:""}.fa-repeat:before,.fa-rotate-right:before{content:""}.fa-refresh:before{content:""}.fa-list-alt:before{content:""}.fa-lock:before{content:""}.fa-flag:before{content:""}.fa-headphones:before{content:""}.fa-volume-off:before{content:""}.fa-volume-down:before{content:""}.fa-volume-up:before{content:""}.fa-qrcode:before{content:""}.fa-barcode:before{content:""}.fa-tag:before{content:""}.fa-tags:before{content:""}.fa-book:before,.icon-book:before{content:""}.fa-bookmark:before{content:""}.fa-print:before{content:""}.fa-camera:before{content:""}.fa-font:before{content:""}.fa-bold:before{content:""}.fa-italic:before{content:""}.fa-text-height:before{content:""}.fa-text-width:before{content:""}.fa-align-left:before{content:""}.fa-align-center:before{content:""}.fa-align-right:before{content:""}.fa-align-justify:before{content:""}.fa-list:before{content:""}.fa-dedent:before,.fa-outdent:before{content:""}.fa-indent:before{content:""}.fa-video-camera:before{content:""}.fa-image:before,.fa-photo:before,.fa-picture-o:before{content:""}.fa-pencil:before{content:""}.fa-map-marker:before{content:""}.fa-adjust:before{content:""}.fa-tint:before{content:""}.fa-edit:before,.fa-pencil-square-o:before{content:""}.fa-share-square-o:before{content:""}.fa-check-square-o:before{content:""}.fa-arrows:before{content:""}.fa-step-backward:before{content:""}.fa-fast-backward:before{content:""}.fa-backward:before{content:""}.fa-play:before{content:""}.fa-pause:before{content:""}.fa-stop:before{content:""}.fa-forward:before{content:""}.fa-fast-forward:before{content:""}.fa-step-forward:before{content:""}.fa-eject:before{content:""}.fa-chevron-left:before{content:""}.fa-chevron-right:before{content:""}.fa-plus-circle:before{content:""}.fa-minus-circle:before{content:""}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}.fa-question-circle:before{content:""}.fa-info-circle:before{content:""}.fa-crosshairs:before{content:""}.fa-times-circle-o:before{content:""}.fa-check-circle-o:before{content:""}.fa-ban:before{content:""}.fa-arrow-left:before{content:""}.fa-arrow-right:before{content:""}.fa-arrow-up:before{content:""}.fa-arrow-down:before{content:""}.fa-mail-forward:before,.fa-share:before{content:""}.fa-expand:before{content:""}.fa-compress:before{content:""}.fa-plus:before{content:""}.fa-minus:before{content:""}.fa-asterisk:before{content:""}.fa-exclamation-circle:before,.rst-content .admonition-title:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before{content:""}.fa-gift:before{content:""}.fa-leaf:before{content:""}.fa-fire:before,.icon-fire:before{content:""}.fa-eye:before{content:""}.fa-eye-slash:before{content:""}.fa-exclamation-triangle:before,.fa-warning:before{content:""}.fa-plane:before{content:""}.fa-calendar:before{content:""}.fa-random:before{content:""}.fa-comment:before{content:""}.fa-magnet:before{content:""}.fa-chevron-up:before{content:""}.fa-chevron-down:before{content:""}.fa-retweet:before{content:""}.fa-shopping-cart:before{content:""}.fa-folder:before{content:""}.fa-folder-open:before{content:""}.fa-arrows-v:before{content:""}.fa-arrows-h:before{content:""}.fa-bar-chart-o:before,.fa-bar-chart:before{content:""}.fa-twitter-square:before{content:""}.fa-facebook-square:before{content:""}.fa-camera-retro:before{content:""}.fa-key:before{content:""}.fa-cogs:before,.fa-gears:before{content:""}.fa-comments:before{content:""}.fa-thumbs-o-up:before{content:""}.fa-thumbs-o-down:before{content:""}.fa-star-half:before{content:""}.fa-heart-o:before{content:""}.fa-sign-out:before{content:""}.fa-linkedin-square:before{content:""}.fa-thumb-tack:before{content:""}.fa-external-link:before{content:""}.fa-sign-in:before{content:""}.fa-trophy:before{content:""}.fa-github-square:before{content:""}.fa-upload:before{content:""}.fa-lemon-o:before{content:""}.fa-phone:before{content:""}.fa-square-o:before{content:""}.fa-bookmark-o:before{content:""}.fa-phone-square:before{content:""}.fa-twitter:before{content:""}.fa-facebook-f:before,.fa-facebook:before{content:""}.fa-github:before,.icon-github:before{content:""}.fa-unlock:before{content:""}.fa-credit-card:before{content:""}.fa-feed:before,.fa-rss:before{content:""}.fa-hdd-o:before{content:""}.fa-bullhorn:before{content:""}.fa-bell:before{content:""}.fa-certificate:before{content:""}.fa-hand-o-right:before{content:""}.fa-hand-o-left:before{content:""}.fa-hand-o-up:before{content:""}.fa-hand-o-down:before{content:""}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}.fa-arrow-circle-up:before{content:""}.fa-arrow-circle-down:before{content:""}.fa-globe:before{content:""}.fa-wrench:before{content:""}.fa-tasks:before{content:""}.fa-filter:before{content:""}.fa-briefcase:before{content:""}.fa-arrows-alt:before{content:""}.fa-group:before,.fa-users:before{content:""}.fa-chain:before,.fa-link:before,.icon-link:before{content:""}.fa-cloud:before{content:""}.fa-flask:before{content:""}.fa-cut:before,.fa-scissors:before{content:""}.fa-copy:before,.fa-files-o:before{content:""}.fa-paperclip:before{content:""}.fa-floppy-o:before,.fa-save:before{content:""}.fa-square:before{content:""}.fa-bars:before,.fa-navicon:before,.fa-reorder:before{content:""}.fa-list-ul:before{content:""}.fa-list-ol:before{content:""}.fa-strikethrough:before{content:""}.fa-underline:before{content:""}.fa-table:before{content:""}.fa-magic:before{content:""}.fa-truck:before{content:""}.fa-pinterest:before{content:""}.fa-pinterest-square:before{content:""}.fa-google-plus-square:before{content:""}.fa-google-plus:before{content:""}.fa-money:before{content:""}.fa-caret-down:before,.icon-caret-down:before,.wy-dropdown .caret:before{content:""}.fa-caret-up:before{content:""}.fa-caret-left:before{content:""}.fa-caret-right:before{content:""}.fa-columns:before{content:""}.fa-sort:before,.fa-unsorted:before{content:""}.fa-sort-desc:before,.fa-sort-down:before{content:""}.fa-sort-asc:before,.fa-sort-up:before{content:""}.fa-envelope:before{content:""}.fa-linkedin:before{content:""}.fa-rotate-left:before,.fa-undo:before{content:""}.fa-gavel:before,.fa-legal:before{content:""}.fa-dashboard:before,.fa-tachometer:before{content:""}.fa-comment-o:before{content:""}.fa-comments-o:before{content:""}.fa-bolt:before,.fa-flash:before{content:""}.fa-sitemap:before{content:""}.fa-umbrella:before{content:""}.fa-clipboard:before,.fa-paste:before{content:""}.fa-lightbulb-o:before{content:""}.fa-exchange:before{content:""}.fa-cloud-download:before{content:""}.fa-cloud-upload:before{content:""}.fa-user-md:before{content:""}.fa-stethoscope:before{content:""}.fa-suitcase:before{content:""}.fa-bell-o:before{content:""}.fa-coffee:before{content:""}.fa-cutlery:before{content:""}.fa-file-text-o:before{content:""}.fa-building-o:before{content:""}.fa-hospital-o:before{content:""}.fa-ambulance:before{content:""}.fa-medkit:before{content:""}.fa-fighter-jet:before{content:""}.fa-beer:before{content:""}.fa-h-square:before{content:""}.fa-plus-square:before{content:""}.fa-angle-double-left:before{content:""}.fa-angle-double-right:before{content:""}.fa-angle-double-up:before{content:""}.fa-angle-double-down:before{content:""}.fa-angle-left:before{content:""}.fa-angle-right:before{content:""}.fa-angle-up:before{content:""}.fa-angle-down:before{content:""}.fa-desktop:before{content:""}.fa-laptop:before{content:""}.fa-tablet:before{content:""}.fa-mobile-phone:before,.fa-mobile:before{content:""}.fa-circle-o:before{content:""}.fa-quote-left:before{content:""}.fa-quote-right:before{content:""}.fa-spinner:before{content:""}.fa-circle:before{content:""}.fa-mail-reply:before,.fa-reply:before{content:""}.fa-github-alt:before{content:""}.fa-folder-o:before{content:""}.fa-folder-open-o:before{content:""}.fa-smile-o:before{content:""}.fa-frown-o:before{content:""}.fa-meh-o:before{content:""}.fa-gamepad:before{content:""}.fa-keyboard-o:before{content:""}.fa-flag-o:before{content:""}.fa-flag-checkered:before{content:""}.fa-terminal:before{content:""}.fa-code:before{content:""}.fa-mail-reply-all:before,.fa-reply-all:before{content:""}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}.fa-location-arrow:before{content:""}.fa-crop:before{content:""}.fa-code-fork:before{content:""}.fa-chain-broken:before,.fa-unlink:before{content:""}.fa-question:before{content:""}.fa-info:before{content:""}.fa-exclamation:before{content:""}.fa-superscript:before{content:""}.fa-subscript:before{content:""}.fa-eraser:before{content:""}.fa-puzzle-piece:before{content:""}.fa-microphone:before{content:""}.fa-microphone-slash:before{content:""}.fa-shield:before{content:""}.fa-calendar-o:before{content:""}.fa-fire-extinguisher:before{content:""}.fa-rocket:before{content:""}.fa-maxcdn:before{content:""}.fa-chevron-circle-left:before{content:""}.fa-chevron-circle-right:before{content:""}.fa-chevron-circle-up:before{content:""}.fa-chevron-circle-down:before{content:""}.fa-html5:before{content:""}.fa-css3:before{content:""}.fa-anchor:before{content:""}.fa-unlock-alt:before{content:""}.fa-bullseye:before{content:""}.fa-ellipsis-h:before{content:""}.fa-ellipsis-v:before{content:""}.fa-rss-square:before{content:""}.fa-play-circle:before{content:""}.fa-ticket:before{content:""}.fa-minus-square:before{content:""}.fa-minus-square-o:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before{content:""}.fa-level-up:before{content:""}.fa-level-down:before{content:""}.fa-check-square:before{content:""}.fa-pencil-square:before{content:""}.fa-external-link-square:before{content:""}.fa-share-square:before{content:""}.fa-compass:before{content:""}.fa-caret-square-o-down:before,.fa-toggle-down:before{content:""}.fa-caret-square-o-up:before,.fa-toggle-up:before{content:""}.fa-caret-square-o-right:before,.fa-toggle-right:before{content:""}.fa-eur:before,.fa-euro:before{content:""}.fa-gbp:before{content:""}.fa-dollar:before,.fa-usd:before{content:""}.fa-inr:before,.fa-rupee:before{content:""}.fa-cny:before,.fa-jpy:before,.fa-rmb:before,.fa-yen:before{content:""}.fa-rouble:before,.fa-rub:before,.fa-ruble:before{content:""}.fa-krw:before,.fa-won:before{content:""}.fa-bitcoin:before,.fa-btc:before{content:""}.fa-file:before{content:""}.fa-file-text:before{content:""}.fa-sort-alpha-asc:before{content:""}.fa-sort-alpha-desc:before{content:""}.fa-sort-amount-asc:before{content:""}.fa-sort-amount-desc:before{content:""}.fa-sort-numeric-asc:before{content:""}.fa-sort-numeric-desc:before{content:""}.fa-thumbs-up:before{content:""}.fa-thumbs-down:before{content:""}.fa-youtube-square:before{content:""}.fa-youtube:before{content:""}.fa-xing:before{content:""}.fa-xing-square:before{content:""}.fa-youtube-play:before{content:""}.fa-dropbox:before{content:""}.fa-stack-overflow:before{content:""}.fa-instagram:before{content:""}.fa-flickr:before{content:""}.fa-adn:before{content:""}.fa-bitbucket:before,.icon-bitbucket:before{content:""}.fa-bitbucket-square:before{content:""}.fa-tumblr:before{content:""}.fa-tumblr-square:before{content:""}.fa-long-arrow-down:before{content:""}.fa-long-arrow-up:before{content:""}.fa-long-arrow-left:before{content:""}.fa-long-arrow-right:before{content:""}.fa-apple:before{content:""}.fa-windows:before{content:""}.fa-android:before{content:""}.fa-linux:before{content:""}.fa-dribbble:before{content:""}.fa-skype:before{content:""}.fa-foursquare:before{content:""}.fa-trello:before{content:""}.fa-female:before{content:""}.fa-male:before{content:""}.fa-gittip:before,.fa-gratipay:before{content:""}.fa-sun-o:before{content:""}.fa-moon-o:before{content:""}.fa-archive:before{content:""}.fa-bug:before{content:""}.fa-vk:before{content:""}.fa-weibo:before{content:""}.fa-renren:before{content:""}.fa-pagelines:before{content:""}.fa-stack-exchange:before{content:""}.fa-arrow-circle-o-right:before{content:""}.fa-arrow-circle-o-left:before{content:""}.fa-caret-square-o-left:before,.fa-toggle-left:before{content:""}.fa-dot-circle-o:before{content:""}.fa-wheelchair:before{content:""}.fa-vimeo-square:before{content:""}.fa-try:before,.fa-turkish-lira:before{content:""}.fa-plus-square-o:before,.wy-menu-vertical li button.toctree-expand:before{content:""}.fa-space-shuttle:before{content:""}.fa-slack:before{content:""}.fa-envelope-square:before{content:""}.fa-wordpress:before{content:""}.fa-openid:before{content:""}.fa-bank:before,.fa-institution:before,.fa-university:before{content:""}.fa-graduation-cap:before,.fa-mortar-board:before{content:""}.fa-yahoo:before{content:""}.fa-google:before{content:""}.fa-reddit:before{content:""}.fa-reddit-square:before{content:""}.fa-stumbleupon-circle:before{content:""}.fa-stumbleupon:before{content:""}.fa-delicious:before{content:""}.fa-digg:before{content:""}.fa-pied-piper-pp:before{content:""}.fa-pied-piper-alt:before{content:""}.fa-drupal:before{content:""}.fa-joomla:before{content:""}.fa-language:before{content:""}.fa-fax:before{content:""}.fa-building:before{content:""}.fa-child:before{content:""}.fa-paw:before{content:""}.fa-spoon:before{content:""}.fa-cube:before{content:""}.fa-cubes:before{content:""}.fa-behance:before{content:""}.fa-behance-square:before{content:""}.fa-steam:before{content:""}.fa-steam-square:before{content:""}.fa-recycle:before{content:""}.fa-automobile:before,.fa-car:before{content:""}.fa-cab:before,.fa-taxi:before{content:""}.fa-tree:before{content:""}.fa-spotify:before{content:""}.fa-deviantart:before{content:""}.fa-soundcloud:before{content:""}.fa-database:before{content:""}.fa-file-pdf-o:before{content:""}.fa-file-word-o:before{content:""}.fa-file-excel-o:before{content:""}.fa-file-powerpoint-o:before{content:""}.fa-file-image-o:before,.fa-file-photo-o:before,.fa-file-picture-o:before{content:""}.fa-file-archive-o:before,.fa-file-zip-o:before{content:""}.fa-file-audio-o:before,.fa-file-sound-o:before{content:""}.fa-file-movie-o:before,.fa-file-video-o:before{content:""}.fa-file-code-o:before{content:""}.fa-vine:before{content:""}.fa-codepen:before{content:""}.fa-jsfiddle:before{content:""}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-ring:before,.fa-life-saver:before,.fa-support:before{content:""}.fa-circle-o-notch:before{content:""}.fa-ra:before,.fa-rebel:before,.fa-resistance:before{content:""}.fa-empire:before,.fa-ge:before{content:""}.fa-git-square:before{content:""}.fa-git:before{content:""}.fa-hacker-news:before,.fa-y-combinator-square:before,.fa-yc-square:before{content:""}.fa-tencent-weibo:before{content:""}.fa-qq:before{content:""}.fa-wechat:before,.fa-weixin:before{content:""}.fa-paper-plane:before,.fa-send:before{content:""}.fa-paper-plane-o:before,.fa-send-o:before{content:""}.fa-history:before{content:""}.fa-circle-thin:before{content:""}.fa-header:before{content:""}.fa-paragraph:before{content:""}.fa-sliders:before{content:""}.fa-share-alt:before{content:""}.fa-share-alt-square:before{content:""}.fa-bomb:before{content:""}.fa-futbol-o:before,.fa-soccer-ball-o:before{content:""}.fa-tty:before{content:""}.fa-binoculars:before{content:""}.fa-plug:before{content:""}.fa-slideshare:before{content:""}.fa-twitch:before{content:""}.fa-yelp:before{content:""}.fa-newspaper-o:before{content:""}.fa-wifi:before{content:""}.fa-calculator:before{content:""}.fa-paypal:before{content:""}.fa-google-wallet:before{content:""}.fa-cc-visa:before{content:""}.fa-cc-mastercard:before{content:""}.fa-cc-discover:before{content:""}.fa-cc-amex:before{content:""}.fa-cc-paypal:before{content:""}.fa-cc-stripe:before{content:""}.fa-bell-slash:before{content:""}.fa-bell-slash-o:before{content:""}.fa-trash:before{content:""}.fa-copyright:before{content:""}.fa-at:before{content:""}.fa-eyedropper:before{content:""}.fa-paint-brush:before{content:""}.fa-birthday-cake:before{content:""}.fa-area-chart:before{content:""}.fa-pie-chart:before{content:""}.fa-line-chart:before{content:""}.fa-lastfm:before{content:""}.fa-lastfm-square:before{content:""}.fa-toggle-off:before{content:""}.fa-toggle-on:before{content:""}.fa-bicycle:before{content:""}.fa-bus:before{content:""}.fa-ioxhost:before{content:""}.fa-angellist:before{content:""}.fa-cc:before{content:""}.fa-ils:before,.fa-shekel:before,.fa-sheqel:before{content:""}.fa-meanpath:before{content:""}.fa-buysellads:before{content:""}.fa-connectdevelop:before{content:""}.fa-dashcube:before{content:""}.fa-forumbee:before{content:""}.fa-leanpub:before{content:""}.fa-sellsy:before{content:""}.fa-shirtsinbulk:before{content:""}.fa-simplybuilt:before{content:""}.fa-skyatlas:before{content:""}.fa-cart-plus:before{content:""}.fa-cart-arrow-down:before{content:""}.fa-diamond:before{content:""}.fa-ship:before{content:""}.fa-user-secret:before{content:""}.fa-motorcycle:before{content:""}.fa-street-view:before{content:""}.fa-heartbeat:before{content:""}.fa-venus:before{content:""}.fa-mars:before{content:""}.fa-mercury:before{content:""}.fa-intersex:before,.fa-transgender:before{content:""}.fa-transgender-alt:before{content:""}.fa-venus-double:before{content:""}.fa-mars-double:before{content:""}.fa-venus-mars:before{content:""}.fa-mars-stroke:before{content:""}.fa-mars-stroke-v:before{content:""}.fa-mars-stroke-h:before{content:""}.fa-neuter:before{content:""}.fa-genderless:before{content:""}.fa-facebook-official:before{content:""}.fa-pinterest-p:before{content:""}.fa-whatsapp:before{content:""}.fa-server:before{content:""}.fa-user-plus:before{content:""}.fa-user-times:before{content:""}.fa-bed:before,.fa-hotel:before{content:""}.fa-viacoin:before{content:""}.fa-train:before{content:""}.fa-subway:before{content:""}.fa-medium:before{content:""}.fa-y-combinator:before,.fa-yc:before{content:""}.fa-optin-monster:before{content:""}.fa-opencart:before{content:""}.fa-expeditedssl:before{content:""}.fa-battery-4:before,.fa-battery-full:before,.fa-battery:before{content:""}.fa-battery-3:before,.fa-battery-three-quarters:before{content:""}.fa-battery-2:before,.fa-battery-half:before{content:""}.fa-battery-1:before,.fa-battery-quarter:before{content:""}.fa-battery-0:before,.fa-battery-empty:before{content:""}.fa-mouse-pointer:before{content:""}.fa-i-cursor:before{content:""}.fa-object-group:before{content:""}.fa-object-ungroup:before{content:""}.fa-sticky-note:before{content:""}.fa-sticky-note-o:before{content:""}.fa-cc-jcb:before{content:""}.fa-cc-diners-club:before{content:""}.fa-clone:before{content:""}.fa-balance-scale:before{content:""}.fa-hourglass-o:before{content:""}.fa-hourglass-1:before,.fa-hourglass-start:before{content:""}.fa-hourglass-2:before,.fa-hourglass-half:before{content:""}.fa-hourglass-3:before,.fa-hourglass-end:before{content:""}.fa-hourglass:before{content:""}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:""}.fa-hand-paper-o:before,.fa-hand-stop-o:before{content:""}.fa-hand-scissors-o:before{content:""}.fa-hand-lizard-o:before{content:""}.fa-hand-spock-o:before{content:""}.fa-hand-pointer-o:before{content:""}.fa-hand-peace-o:before{content:""}.fa-trademark:before{content:""}.fa-registered:before{content:""}.fa-creative-commons:before{content:""}.fa-gg:before{content:""}.fa-gg-circle:before{content:""}.fa-tripadvisor:before{content:""}.fa-odnoklassniki:before{content:""}.fa-odnoklassniki-square:before{content:""}.fa-get-pocket:before{content:""}.fa-wikipedia-w:before{content:""}.fa-safari:before{content:""}.fa-chrome:before{content:""}.fa-firefox:before{content:""}.fa-opera:before{content:""}.fa-internet-explorer:before{content:""}.fa-television:before,.fa-tv:before{content:""}.fa-contao:before{content:""}.fa-500px:before{content:""}.fa-amazon:before{content:""}.fa-calendar-plus-o:before{content:""}.fa-calendar-minus-o:before{content:""}.fa-calendar-times-o:before{content:""}.fa-calendar-check-o:before{content:""}.fa-industry:before{content:""}.fa-map-pin:before{content:""}.fa-map-signs:before{content:""}.fa-map-o:before{content:""}.fa-map:before{content:""}.fa-commenting:before{content:""}.fa-commenting-o:before{content:""}.fa-houzz:before{content:""}.fa-vimeo:before{content:""}.fa-black-tie:before{content:""}.fa-fonticons:before{content:""}.fa-reddit-alien:before{content:""}.fa-edge:before{content:""}.fa-credit-card-alt:before{content:""}.fa-codiepie:before{content:""}.fa-modx:before{content:""}.fa-fort-awesome:before{content:""}.fa-usb:before{content:""}.fa-product-hunt:before{content:""}.fa-mixcloud:before{content:""}.fa-scribd:before{content:""}.fa-pause-circle:before{content:""}.fa-pause-circle-o:before{content:""}.fa-stop-circle:before{content:""}.fa-stop-circle-o:before{content:""}.fa-shopping-bag:before{content:""}.fa-shopping-basket:before{content:""}.fa-hashtag:before{content:""}.fa-bluetooth:before{content:""}.fa-bluetooth-b:before{content:""}.fa-percent:before{content:""}.fa-gitlab:before,.icon-gitlab:before{content:""}.fa-wpbeginner:before{content:""}.fa-wpforms:before{content:""}.fa-envira:before{content:""}.fa-universal-access:before{content:""}.fa-wheelchair-alt:before{content:""}.fa-question-circle-o:before{content:""}.fa-blind:before{content:""}.fa-audio-description:before{content:""}.fa-volume-control-phone:before{content:""}.fa-braille:before{content:""}.fa-assistive-listening-systems:before{content:""}.fa-american-sign-language-interpreting:before,.fa-asl-interpreting:before{content:""}.fa-deaf:before,.fa-deafness:before,.fa-hard-of-hearing:before{content:""}.fa-glide:before{content:""}.fa-glide-g:before{content:""}.fa-sign-language:before,.fa-signing:before{content:""}.fa-low-vision:before{content:""}.fa-viadeo:before{content:""}.fa-viadeo-square:before{content:""}.fa-snapchat:before{content:""}.fa-snapchat-ghost:before{content:""}.fa-snapchat-square:before{content:""}.fa-pied-piper:before{content:""}.fa-first-order:before{content:""}.fa-yoast:before{content:""}.fa-themeisle:before{content:""}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:""}.fa-fa:before,.fa-font-awesome:before{content:""}.fa-handshake-o:before{content:""}.fa-envelope-open:before{content:""}.fa-envelope-open-o:before{content:""}.fa-linode:before{content:""}.fa-address-book:before{content:""}.fa-address-book-o:before{content:""}.fa-address-card:before,.fa-vcard:before{content:""}.fa-address-card-o:before,.fa-vcard-o:before{content:""}.fa-user-circle:before{content:""}.fa-user-circle-o:before{content:""}.fa-user-o:before{content:""}.fa-id-badge:before{content:""}.fa-drivers-license:before,.fa-id-card:before{content:""}.fa-drivers-license-o:before,.fa-id-card-o:before{content:""}.fa-quora:before{content:""}.fa-free-code-camp:before{content:""}.fa-telegram:before{content:""}.fa-thermometer-4:before,.fa-thermometer-full:before,.fa-thermometer:before{content:""}.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:""}.fa-thermometer-2:before,.fa-thermometer-half:before{content:""}.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:""}.fa-thermometer-0:before,.fa-thermometer-empty:before{content:""}.fa-shower:before{content:""}.fa-bath:before,.fa-bathtub:before,.fa-s15:before{content:""}.fa-podcast:before{content:""}.fa-window-maximize:before{content:""}.fa-window-minimize:before{content:""}.fa-window-restore:before{content:""}.fa-times-rectangle:before,.fa-window-close:before{content:""}.fa-times-rectangle-o:before,.fa-window-close-o:before{content:""}.fa-bandcamp:before{content:""}.fa-grav:before{content:""}.fa-etsy:before{content:""}.fa-imdb:before{content:""}.fa-ravelry:before{content:""}.fa-eercast:before{content:""}.fa-microchip:before{content:""}.fa-snowflake-o:before{content:""}.fa-superpowers:before{content:""}.fa-wpexplorer:before{content:""}.fa-meetup:before{content:""}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{font-family:inherit}.fa:before,.icon:before,.rst-content .admonition-title:before,.rst-content .code-block-caption .headerlink:before,.rst-content .eqno .headerlink:before,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before{font-family:FontAwesome;display:inline-block;font-style:normal;font-weight:400;line-height:1;text-decoration:inherit}.rst-content .code-block-caption a .headerlink,.rst-content .eqno a .headerlink,.rst-content a .admonition-title,.rst-content code.download a span:first-child,.rst-content dl dt a .headerlink,.rst-content h1 a .headerlink,.rst-content h2 a .headerlink,.rst-content h3 a .headerlink,.rst-content h4 a .headerlink,.rst-content h5 a .headerlink,.rst-content h6 a .headerlink,.rst-content p.caption a .headerlink,.rst-content p a .headerlink,.rst-content table>caption a .headerlink,.rst-content tt.download a span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li a button.toctree-expand,a .fa,a .icon,a .rst-content .admonition-title,a .rst-content .code-block-caption .headerlink,a .rst-content .eqno .headerlink,a .rst-content code.download span:first-child,a .rst-content dl dt .headerlink,a .rst-content h1 .headerlink,a .rst-content h2 .headerlink,a .rst-content h3 .headerlink,a .rst-content h4 .headerlink,a .rst-content h5 .headerlink,a .rst-content h6 .headerlink,a .rst-content p.caption .headerlink,a .rst-content p .headerlink,a .rst-content table>caption .headerlink,a .rst-content tt.download span:first-child,a .wy-menu-vertical li button.toctree-expand{display:inline-block;text-decoration:inherit}.btn .fa,.btn .icon,.btn .rst-content .admonition-title,.btn .rst-content .code-block-caption .headerlink,.btn .rst-content .eqno .headerlink,.btn .rst-content code.download span:first-child,.btn .rst-content dl dt .headerlink,.btn .rst-content h1 .headerlink,.btn .rst-content h2 .headerlink,.btn .rst-content h3 .headerlink,.btn .rst-content h4 .headerlink,.btn .rst-content h5 .headerlink,.btn .rst-content h6 .headerlink,.btn .rst-content p .headerlink,.btn .rst-content table>caption .headerlink,.btn .rst-content tt.download span:first-child,.btn .wy-menu-vertical li.current>a button.toctree-expand,.btn .wy-menu-vertical li.on a button.toctree-expand,.btn .wy-menu-vertical li button.toctree-expand,.nav .fa,.nav .icon,.nav .rst-content .admonition-title,.nav .rst-content .code-block-caption .headerlink,.nav .rst-content .eqno .headerlink,.nav .rst-content code.download span:first-child,.nav .rst-content dl dt .headerlink,.nav .rst-content h1 .headerlink,.nav .rst-content h2 .headerlink,.nav .rst-content h3 .headerlink,.nav .rst-content h4 .headerlink,.nav .rst-content h5 .headerlink,.nav .rst-content h6 .headerlink,.nav .rst-content p .headerlink,.nav .rst-content table>caption .headerlink,.nav .rst-content tt.download span:first-child,.nav .wy-menu-vertical li.current>a button.toctree-expand,.nav .wy-menu-vertical li.on a button.toctree-expand,.nav .wy-menu-vertical li button.toctree-expand,.rst-content .btn .admonition-title,.rst-content .code-block-caption .btn .headerlink,.rst-content .code-block-caption .nav .headerlink,.rst-content .eqno .btn .headerlink,.rst-content .eqno .nav .headerlink,.rst-content .nav .admonition-title,.rst-content code.download .btn span:first-child,.rst-content code.download .nav span:first-child,.rst-content dl dt .btn .headerlink,.rst-content dl dt .nav .headerlink,.rst-content h1 .btn .headerlink,.rst-content h1 .nav .headerlink,.rst-content h2 .btn .headerlink,.rst-content h2 .nav .headerlink,.rst-content h3 .btn .headerlink,.rst-content h3 .nav .headerlink,.rst-content h4 .btn .headerlink,.rst-content h4 .nav .headerlink,.rst-content h5 .btn .headerlink,.rst-content h5 .nav .headerlink,.rst-content h6 .btn .headerlink,.rst-content h6 .nav .headerlink,.rst-content p .btn .headerlink,.rst-content p .nav .headerlink,.rst-content table>caption .btn .headerlink,.rst-content table>caption .nav .headerlink,.rst-content tt.download .btn span:first-child,.rst-content tt.download .nav span:first-child,.wy-menu-vertical li .btn button.toctree-expand,.wy-menu-vertical li.current>a .btn button.toctree-expand,.wy-menu-vertical li.current>a .nav button.toctree-expand,.wy-menu-vertical li .nav button.toctree-expand,.wy-menu-vertical li.on a .btn button.toctree-expand,.wy-menu-vertical li.on a .nav button.toctree-expand{display:inline}.btn .fa-large.icon,.btn .fa.fa-large,.btn .rst-content .code-block-caption .fa-large.headerlink,.btn .rst-content .eqno .fa-large.headerlink,.btn .rst-content .fa-large.admonition-title,.btn .rst-content code.download span.fa-large:first-child,.btn .rst-content dl dt .fa-large.headerlink,.btn .rst-content h1 .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.btn .rst-content p .fa-large.headerlink,.btn .rst-content table>caption .fa-large.headerlink,.btn .rst-content tt.download span.fa-large:first-child,.btn .wy-menu-vertical li button.fa-large.toctree-expand,.nav .fa-large.icon,.nav .fa.fa-large,.nav .rst-content .code-block-caption .fa-large.headerlink,.nav .rst-content .eqno .fa-large.headerlink,.nav .rst-content .fa-large.admonition-title,.nav .rst-content code.download span.fa-large:first-child,.nav .rst-content dl dt .fa-large.headerlink,.nav .rst-content h1 .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.nav .rst-content p .fa-large.headerlink,.nav .rst-content table>caption .fa-large.headerlink,.nav .rst-content tt.download span.fa-large:first-child,.nav .wy-menu-vertical li button.fa-large.toctree-expand,.rst-content .btn .fa-large.admonition-title,.rst-content .code-block-caption .btn .fa-large.headerlink,.rst-content .code-block-caption .nav .fa-large.headerlink,.rst-content .eqno .btn .fa-large.headerlink,.rst-content .eqno .nav .fa-large.headerlink,.rst-content .nav .fa-large.admonition-title,.rst-content code.download .btn span.fa-large:first-child,.rst-content code.download .nav span.fa-large:first-child,.rst-content dl dt .btn .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.rst-content p .btn .fa-large.headerlink,.rst-content p .nav .fa-large.headerlink,.rst-content table>caption .btn .fa-large.headerlink,.rst-content table>caption .nav .fa-large.headerlink,.rst-content tt.download .btn span.fa-large:first-child,.rst-content tt.download .nav span.fa-large:first-child,.wy-menu-vertical li .btn button.fa-large.toctree-expand,.wy-menu-vertical li .nav button.fa-large.toctree-expand{line-height:.9em}.btn .fa-spin.icon,.btn .fa.fa-spin,.btn .rst-content .code-block-caption .fa-spin.headerlink,.btn .rst-content .eqno .fa-spin.headerlink,.btn .rst-content .fa-spin.admonition-title,.btn .rst-content code.download span.fa-spin:first-child,.btn .rst-content dl dt .fa-spin.headerlink,.btn .rst-content h1 .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.btn .rst-content p .fa-spin.headerlink,.btn .rst-content table>caption .fa-spin.headerlink,.btn .rst-content tt.download span.fa-spin:first-child,.btn .wy-menu-vertical li button.fa-spin.toctree-expand,.nav .fa-spin.icon,.nav .fa.fa-spin,.nav .rst-content .code-block-caption .fa-spin.headerlink,.nav .rst-content .eqno .fa-spin.headerlink,.nav .rst-content .fa-spin.admonition-title,.nav .rst-content code.download span.fa-spin:first-child,.nav .rst-content dl dt .fa-spin.headerlink,.nav .rst-content h1 .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.nav .rst-content p .fa-spin.headerlink,.nav .rst-content table>caption .fa-spin.headerlink,.nav .rst-content tt.download span.fa-spin:first-child,.nav .wy-menu-vertical li button.fa-spin.toctree-expand,.rst-content .btn .fa-spin.admonition-title,.rst-content .code-block-caption .btn .fa-spin.headerlink,.rst-content .code-block-caption .nav .fa-spin.headerlink,.rst-content .eqno .btn .fa-spin.headerlink,.rst-content .eqno .nav .fa-spin.headerlink,.rst-content .nav .fa-spin.admonition-title,.rst-content code.download .btn span.fa-spin:first-child,.rst-content code.download .nav span.fa-spin:first-child,.rst-content dl dt .btn .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.rst-content p .btn .fa-spin.headerlink,.rst-content p .nav .fa-spin.headerlink,.rst-content table>caption .btn .fa-spin.headerlink,.rst-content table>caption .nav .fa-spin.headerlink,.rst-content tt.download .btn span.fa-spin:first-child,.rst-content tt.download .nav span.fa-spin:first-child,.wy-menu-vertical li .btn button.fa-spin.toctree-expand,.wy-menu-vertical li .nav button.fa-spin.toctree-expand{display:inline-block}.btn.fa:before,.btn.icon:before,.rst-content .btn.admonition-title:before,.rst-content .code-block-caption .btn.headerlink:before,.rst-content .eqno .btn.headerlink:before,.rst-content code.download span.btn:first-child:before,.rst-content dl dt .btn.headerlink:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content p .btn.headerlink:before,.rst-content table>caption .btn.headerlink:before,.rst-content tt.download span.btn:first-child:before,.wy-menu-vertical li button.btn.toctree-expand:before{opacity:.5;-webkit-transition:opacity .05s ease-in;-moz-transition:opacity .05s ease-in;transition:opacity .05s ease-in}.btn.fa:hover:before,.btn.icon:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content .code-block-caption .btn.headerlink:hover:before,.rst-content .eqno .btn.headerlink:hover:before,.rst-content code.download span.btn:first-child:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content p .btn.headerlink:hover:before,.rst-content table>caption .btn.headerlink:hover:before,.rst-content tt.download span.btn:first-child:hover:before,.wy-menu-vertical li button.btn.toctree-expand:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .icon:before,.btn-mini .rst-content .admonition-title:before,.btn-mini .rst-content .code-block-caption .headerlink:before,.btn-mini .rst-content .eqno .headerlink:before,.btn-mini .rst-content code.download span:first-child:before,.btn-mini .rst-content dl dt .headerlink:before,.btn-mini .rst-content h1 .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.btn-mini .rst-content p .headerlink:before,.btn-mini .rst-content table>caption .headerlink:before,.btn-mini .rst-content tt.download span:first-child:before,.btn-mini .wy-menu-vertical li button.toctree-expand:before,.rst-content .btn-mini .admonition-title:before,.rst-content .code-block-caption .btn-mini .headerlink:before,.rst-content .eqno .btn-mini .headerlink:before,.rst-content code.download .btn-mini span:first-child:before,.rst-content dl dt .btn-mini .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.rst-content p .btn-mini .headerlink:before,.rst-content table>caption .btn-mini .headerlink:before,.rst-content tt.download .btn-mini span:first-child:before,.wy-menu-vertical li .btn-mini button.toctree-expand:before{font-size:14px;vertical-align:-15%}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.wy-alert{padding:12px;line-height:24px;margin-bottom:24px;background:#e7f2fa}.rst-content .admonition-title,.wy-alert-title{font-weight:700;display:block;color:#fff;background:#6ab0de;padding:6px 12px;margin:-12px -12px 12px}.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.admonition,.rst-content .wy-alert-danger.admonition-todo,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.wy-alert.wy-alert-danger{background:#fdf3f2}.rst-content .danger .admonition-title,.rst-content .danger .wy-alert-title,.rst-content .error .admonition-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.rst-content .wy-alert-danger.admonition .admonition-title,.rst-content .wy-alert-danger.admonition .wy-alert-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.wy-alert.wy-alert-danger .wy-alert-title{background:#f29f97}.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .warning,.rst-content .wy-alert-warning.admonition,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.note,.rst-content .wy-alert-warning.seealso,.rst-content .wy-alert-warning.tip,.wy-alert.wy-alert-warning{background:#ffedcc}.rst-content .admonition-todo .admonition-title,.rst-content .admonition-todo .wy-alert-title,.rst-content .attention .admonition-title,.rst-content .attention .wy-alert-title,.rst-content .caution .admonition-title,.rst-content .caution .wy-alert-title,.rst-content .warning .admonition-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.admonition .admonition-title,.rst-content .wy-alert-warning.admonition .wy-alert-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.wy-alert.wy-alert-warning .wy-alert-title{background:#f0b37e}.rst-content .note,.rst-content .seealso,.rst-content .wy-alert-info.admonition,.rst-content .wy-alert-info.admonition-todo,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.wy-alert.wy-alert-info{background:#e7f2fa}.rst-content .note .admonition-title,.rst-content .note .wy-alert-title,.rst-content .seealso .admonition-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .admonition-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.rst-content .wy-alert-info.admonition .admonition-title,.rst-content .wy-alert-info.admonition .wy-alert-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.wy-alert.wy-alert-info .wy-alert-title{background:#6ab0de}.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.admonition,.rst-content .wy-alert-success.admonition-todo,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.warning,.wy-alert.wy-alert-success{background:#dbfaf4}.rst-content .hint .admonition-title,.rst-content .hint .wy-alert-title,.rst-content .important .admonition-title,.rst-content .important .wy-alert-title,.rst-content .tip .admonition-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .admonition-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.rst-content .wy-alert-success.admonition .admonition-title,.rst-content .wy-alert-success.admonition .wy-alert-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.wy-alert.wy-alert-success .wy-alert-title{background:#1abc9c}.rst-content .wy-alert-neutral.admonition,.rst-content .wy-alert-neutral.admonition-todo,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.wy-alert.wy-alert-neutral{background:#f3f6f6}.rst-content .wy-alert-neutral.admonition-todo .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.rst-content .wy-alert-neutral.admonition .admonition-title,.rst-content .wy-alert-neutral.admonition .wy-alert-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.wy-alert.wy-alert-neutral .wy-alert-title{color:#404040;background:#e1e4e5}.rst-content .wy-alert-neutral.admonition-todo a,.rst-content .wy-alert-neutral.admonition a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.wy-alert.wy-alert-neutral a{color:#2980b9}.rst-content .admonition-todo p:last-child,.rst-content .admonition p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .note p:last-child,.rst-content .seealso p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.wy-alert p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all .3s ease-in;-moz-transition:all .3s ease-in;transition:all .3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27ae60}.wy-tray-container li.wy-tray-item-info{background:#2980b9}.wy-tray-container li.wy-tray-item-warning{background:#e67e22}.wy-tray-container li.wy-tray-item-danger{background:#e74c3c}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width:768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px;color:#fff;border:1px solid rgba(0,0,0,.1);background-color:#27ae60;text-decoration:none;font-weight:400;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 2px -1px hsla(0,0%,100%,.5),inset 0 -2px 0 0 rgba(0,0,0,.1);outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all .1s linear;-moz-transition:all .1s linear;transition:all .1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:inset 0 -1px 0 0 rgba(0,0,0,.05),inset 0 2px 0 0 rgba(0,0,0,.1);padding:8px 12px 6px}.btn:visited{color:#fff}.btn-disabled,.btn-disabled:active,.btn-disabled:focus,.btn-disabled:hover,.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#2980b9!important}.btn-info:hover{background-color:#2e8ece!important}.btn-neutral{background-color:#f3f6f6!important;color:#404040!important}.btn-neutral:hover{background-color:#e5ebeb!important;color:#404040}.btn-neutral:visited{color:#404040!important}.btn-success{background-color:#27ae60!important}.btn-success:hover{background-color:#295!important}.btn-danger{background-color:#e74c3c!important}.btn-danger:hover{background-color:#ea6153!important}.btn-warning{background-color:#e67e22!important}.btn-warning:hover{background-color:#e98b39!important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f!important}.btn-link{background-color:transparent!important;color:#2980b9;box-shadow:none;border-color:transparent!important}.btn-link:active,.btn-link:hover{background-color:transparent!important;color:#409ad5!important;box-shadow:none}.btn-link:visited{color:#9b59b6}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:after,.wy-btn-group:before{display:table;content:""}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-active .wy-dropdown-menu{display:block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:1px solid #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#2980b9;color:#fff}.wy-dropdown-menu>dd.divider{border-top:1px solid #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type=search]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980b9;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;left:auto;text-align:right}.wy-dropdown-arrow:before{content:" ";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned .wy-help-inline,.wy-form-aligned input,.wy-form-aligned label,.wy-form-aligned select,.wy-form-aligned textarea{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{margin:0}fieldset,legend{border:0;padding:0}legend{width:100%;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label,legend{display:block}label{margin:0 0 .3125em;color:#333;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;max-width:1200px;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:after,.wy-control-group:before{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:" *";color:#e74c3c}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full input[type=color],.wy-control-group .wy-form-full input[type=date],.wy-control-group .wy-form-full input[type=datetime-local],.wy-control-group .wy-form-full input[type=datetime],.wy-control-group .wy-form-full input[type=email],.wy-control-group .wy-form-full input[type=month],.wy-control-group .wy-form-full input[type=number],.wy-control-group .wy-form-full input[type=password],.wy-control-group .wy-form-full input[type=search],.wy-control-group .wy-form-full input[type=tel],.wy-control-group .wy-form-full input[type=text],.wy-control-group .wy-form-full input[type=time],.wy-control-group .wy-form-full input[type=url],.wy-control-group .wy-form-full input[type=week],.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves input[type=color],.wy-control-group .wy-form-halves input[type=date],.wy-control-group .wy-form-halves input[type=datetime-local],.wy-control-group .wy-form-halves input[type=datetime],.wy-control-group .wy-form-halves input[type=email],.wy-control-group .wy-form-halves input[type=month],.wy-control-group .wy-form-halves input[type=number],.wy-control-group .wy-form-halves input[type=password],.wy-control-group .wy-form-halves input[type=search],.wy-control-group .wy-form-halves input[type=tel],.wy-control-group .wy-form-halves input[type=text],.wy-control-group .wy-form-halves input[type=time],.wy-control-group .wy-form-halves input[type=url],.wy-control-group .wy-form-halves input[type=week],.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds input[type=color],.wy-control-group .wy-form-thirds input[type=date],.wy-control-group .wy-form-thirds input[type=datetime-local],.wy-control-group .wy-form-thirds input[type=datetime],.wy-control-group .wy-form-thirds input[type=email],.wy-control-group .wy-form-thirds input[type=month],.wy-control-group .wy-form-thirds input[type=number],.wy-control-group .wy-form-thirds input[type=password],.wy-control-group .wy-form-thirds input[type=search],.wy-control-group .wy-form-thirds input[type=tel],.wy-control-group .wy-form-thirds input[type=text],.wy-control-group .wy-form-thirds input[type=time],.wy-control-group .wy-form-thirds input[type=url],.wy-control-group .wy-form-thirds input[type=week],.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full{float:left;display:block;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.35765%;width:48.82117%}.wy-control-group .wy-form-halves:last-child,.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(odd){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.35765%;width:31.76157%}.wy-control-group .wy-form-thirds:last-child,.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control,.wy-control-no-input{margin:6px 0 0;font-size:90%}.wy-control-no-input{display:inline-block}.wy-control-group.fluid-input input[type=color],.wy-control-group.fluid-input input[type=date],.wy-control-group.fluid-input input[type=datetime-local],.wy-control-group.fluid-input input[type=datetime],.wy-control-group.fluid-input input[type=email],.wy-control-group.fluid-input input[type=month],.wy-control-group.fluid-input input[type=number],.wy-control-group.fluid-input input[type=password],.wy-control-group.fluid-input input[type=search],.wy-control-group.fluid-input input[type=tel],.wy-control-group.fluid-input input[type=text],.wy-control-group.fluid-input input[type=time],.wy-control-group.fluid-input input[type=url],.wy-control-group.fluid-input input[type=week]{width:100%}.wy-form-message-inline{padding-left:.3em;color:#666;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:.3125em;font-style:italic}.wy-form-message p{font-size:inherit;font-style:italic;margin-bottom:6px}.wy-form-message p:last-child{margin-bottom:0}input{line-height:normal}input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;*overflow:visible}input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}input[type=datetime-local]{padding:.34375em .625em}input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{padding:0;margin-right:.3125em;*height:13px;*width:13px}input[type=checkbox],input[type=radio],input[type=search]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}input[type=color]:focus,input[type=date]:focus,input[type=datetime-local]:focus,input[type=datetime]:focus,input[type=email]:focus,input[type=month]:focus,input[type=number]:focus,input[type=password]:focus,input[type=search]:focus,input[type=tel]:focus,input[type=text]:focus,input[type=time]:focus,input[type=url]:focus,input[type=week]:focus{outline:0;outline:thin dotted\9;border-color:#333}input.no-focus:focus{border-color:#ccc!important}input[type=checkbox]:focus,input[type=file]:focus,input[type=radio]:focus{outline:thin dotted #333;outline:1px auto #129fea}input[type=color][disabled],input[type=date][disabled],input[type=datetime-local][disabled],input[type=datetime][disabled],input[type=email][disabled],input[type=month][disabled],input[type=number][disabled],input[type=password][disabled],input[type=search][disabled],input[type=tel][disabled],input[type=text][disabled],input[type=time][disabled],input[type=url][disabled],input[type=week][disabled]{cursor:not-allowed;background-color:#fafafa}input:focus:invalid,select:focus:invalid,textarea:focus:invalid{color:#e74c3c;border:1px solid #e74c3c}input:focus:invalid:focus,select:focus:invalid:focus,textarea:focus:invalid:focus{border-color:#e74c3c}input[type=checkbox]:focus:invalid:focus,input[type=file]:focus:invalid:focus,input[type=radio]:focus:invalid:focus{outline-color:#e74c3c}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif}select,textarea{padding:.5em .625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}input[readonly],select[disabled],select[readonly],textarea[disabled],textarea[readonly]{cursor:not-allowed;background-color:#fafafa}input[type=checkbox][disabled],input[type=radio][disabled]{cursor:not-allowed}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap;padding:6px}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;padding:0 8px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:1px solid #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-switch{position:relative;display:block;height:24px;margin-top:12px;cursor:pointer}.wy-switch:before{left:0;top:0;width:36px;height:12px;background:#ccc}.wy-switch:after,.wy-switch:before{position:absolute;content:"";display:block;border-radius:4px;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch:after{width:18px;height:18px;background:#999;left:-3px;top:-3px}.wy-switch span{position:absolute;left:48px;display:block;font-size:12px;color:#ccc;line-height:1}.wy-switch.active:before{background:#1e8449}.wy-switch.active:after{left:24px;background:#27ae60}.wy-switch.disabled{cursor:not-allowed;opacity:.8}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#e74c3c}.wy-control-group.wy-control-group-error input[type=color],.wy-control-group.wy-control-group-error input[type=date],.wy-control-group.wy-control-group-error input[type=datetime-local],.wy-control-group.wy-control-group-error input[type=datetime],.wy-control-group.wy-control-group-error input[type=email],.wy-control-group.wy-control-group-error input[type=month],.wy-control-group.wy-control-group-error input[type=number],.wy-control-group.wy-control-group-error input[type=password],.wy-control-group.wy-control-group-error input[type=search],.wy-control-group.wy-control-group-error input[type=tel],.wy-control-group.wy-control-group-error input[type=text],.wy-control-group.wy-control-group-error input[type=time],.wy-control-group.wy-control-group-error input[type=url],.wy-control-group.wy-control-group-error input[type=week],.wy-control-group.wy-control-group-error textarea{border:1px solid #e74c3c}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:.5em .625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27ae60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#e74c3c}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#e67e22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980b9}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width:480px){.wy-form button[type=submit]{margin:.7em 0 0}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=text],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week],.wy-form label{margin-bottom:.3em;display:block}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0}.wy-form-message,.wy-form-message-inline,.wy-form .wy-help-inline{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width:768px){.tablet-hide{display:none}}@media screen and (max-width:480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.rst-content table.docutils,.rst-content table.field-list,.wy-table{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.rst-content table.docutils caption,.rst-content table.field-list caption,.wy-table caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.rst-content table.docutils td,.rst-content table.docutils th,.rst-content table.field-list td,.rst-content table.field-list th,.wy-table td,.wy-table th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.rst-content table.docutils td:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list td:first-child,.rst-content table.field-list th:first-child,.wy-table td:first-child,.wy-table th:first-child{border-left-width:0}.rst-content table.docutils thead,.rst-content table.field-list thead,.wy-table thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.rst-content table.docutils thead th,.rst-content table.field-list thead th,.wy-table thead th{font-weight:700;border-bottom:2px solid #e1e4e5}.rst-content table.docutils td,.rst-content table.field-list td,.wy-table td{background-color:transparent;vertical-align:middle}.rst-content table.docutils td p,.rst-content table.field-list td p,.wy-table td p{line-height:18px}.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child,.wy-table td p:last-child{margin-bottom:0}.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min,.wy-table .wy-table-cell-min{width:1%;padding-right:0}.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:grey;font-size:90%}.wy-table-tertiary{color:grey;font-size:80%}.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td,.wy-table-backed,.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td{background-color:#f3f6f6}.rst-content table.docutils,.wy-table-bordered-all{border:1px solid #e1e4e5}.rst-content table.docutils td,.wy-table-bordered-all td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.rst-content table.docutils tbody>tr:last-child td,.wy-table-bordered-all tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0!important}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}a{color:#2980b9;text-decoration:none;cursor:pointer}a:hover{color:#3091d1}a:visited{color:#9b59b6}html{height:100%}body,html{overflow-x:hidden}body{font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;font-weight:400;color:#404040;min-height:100%;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#e67e22!important}a.wy-text-warning:hover{color:#eb9950!important}.wy-text-info{color:#2980b9!important}a.wy-text-info:hover{color:#409ad5!important}.wy-text-success{color:#27ae60!important}a.wy-text-success:hover{color:#36d278!important}.wy-text-danger{color:#e74c3c!important}a.wy-text-danger:hover{color:#ed7669!important}.wy-text-neutral{color:#404040!important}a.wy-text-neutral:hover{color:#595959!important}.rst-content .toctree-wrapper>p.caption,h1,h2,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif}p{line-height:24px;font-size:16px;margin:0 0 24px}h1{font-size:175%}.rst-content .toctree-wrapper>p.caption,h2{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}.rst-content code,.rst-content tt,code{white-space:nowrap;max-width:100%;background:#fff;border:1px solid #e1e4e5;font-size:75%;padding:0 5px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#e74c3c;overflow-x:auto}.rst-content tt.code-large,code.code-large{font-size:90%}.rst-content .section ul,.rst-content .toctree-wrapper ul,.rst-content section ul,.wy-plain-list-disc,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.rst-content .section ul li,.rst-content .toctree-wrapper ul li,.rst-content section ul li,.wy-plain-list-disc li,article ul li{list-style:disc;margin-left:24px}.rst-content .section ul li p:last-child,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li p:last-child,.rst-content .toctree-wrapper ul li ul,.rst-content section ul li p:last-child,.rst-content section ul li ul,.wy-plain-list-disc li p:last-child,.wy-plain-list-disc li ul,article ul li p:last-child,article ul li ul{margin-bottom:0}.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,.rst-content section ul li li,.wy-plain-list-disc li li,article ul li li{list-style:circle}.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,.rst-content section ul li li li,.wy-plain-list-disc li li li,article ul li li li{list-style:square}.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,.rst-content section ul li ol li,.wy-plain-list-disc li ol li,article ul li ol li{list-style:decimal}.rst-content .section ol,.rst-content .section ol.arabic,.rst-content .toctree-wrapper ol,.rst-content .toctree-wrapper ol.arabic,.rst-content section ol,.rst-content section ol.arabic,.wy-plain-list-decimal,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.rst-content .section ol.arabic li,.rst-content .section ol li,.rst-content .toctree-wrapper ol.arabic li,.rst-content .toctree-wrapper ol li,.rst-content section ol.arabic li,.rst-content section ol li,.wy-plain-list-decimal li,article ol li{list-style:decimal;margin-left:24px}.rst-content .section ol.arabic li ul,.rst-content .section ol li p:last-child,.rst-content .section ol li ul,.rst-content .toctree-wrapper ol.arabic li ul,.rst-content .toctree-wrapper ol li p:last-child,.rst-content .toctree-wrapper ol li ul,.rst-content section ol.arabic li ul,.rst-content section ol li p:last-child,.rst-content section ol li ul,.wy-plain-list-decimal li p:last-child,.wy-plain-list-decimal li ul,article ol li p:last-child,article ol li ul{margin-bottom:0}.rst-content .section ol.arabic li ul li,.rst-content .section ol li ul li,.rst-content .toctree-wrapper ol.arabic li ul li,.rst-content .toctree-wrapper ol li ul li,.rst-content section ol.arabic li ul li,.rst-content section ol li ul li,.wy-plain-list-decimal li ul li,article ol li ul li{list-style:disc}.wy-breadcrumbs{*zoom:1}.wy-breadcrumbs:after,.wy-breadcrumbs:before{display:table;content:""}.wy-breadcrumbs:after{clear:both}.wy-breadcrumbs>li{display:inline-block;padding-top:5px}.wy-breadcrumbs>li.wy-breadcrumbs-aside{float:right}.rst-content .wy-breadcrumbs>li code,.rst-content .wy-breadcrumbs>li tt,.wy-breadcrumbs>li .rst-content tt,.wy-breadcrumbs>li code{all:inherit;color:inherit}.breadcrumb-item:before{content:"/";color:#bbb;font-size:13px;padding:0 6px 0 3px}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width:480px){.wy-breadcrumbs-extra,.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}html{font-size:16px}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:after,.wy-menu-horiz:before{display:table;content:""}.wy-menu-horiz:after{clear:both}.wy-menu-horiz li,.wy-menu-horiz ul{display:inline-block}.wy-menu-horiz li:hover{background:hsla(0,0%,100%,.1)}.wy-menu-horiz li.divide-left{border-left:1px solid #404040}.wy-menu-horiz li.divide-right{border-right:1px solid #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical{width:300px}.wy-menu-vertical header,.wy-menu-vertical p.caption{color:#55a5d9;height:32px;line-height:32px;padding:0 1.618em;margin:12px 0 0;display:block;font-weight:700;text-transform:uppercase;font-size:85%;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:1px solid #404040}.wy-menu-vertical li.divide-bottom{border-bottom:1px solid #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:grey;border-right:1px solid #c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.rst-content .wy-menu-vertical li tt,.wy-menu-vertical li .rst-content tt,.wy-menu-vertical li code{border:none;background:inherit;color:inherit;padding-left:0;padding-right:0}.wy-menu-vertical li button.toctree-expand{display:block;float:left;margin-left:-1.2em;line-height:18px;color:#4d4d4d;border:none;background:none;padding:0}.wy-menu-vertical li.current>a,.wy-menu-vertical li.on a{color:#404040;font-weight:700;position:relative;background:#fcfcfc;border:none;padding:.4045em 1.618em}.wy-menu-vertical li.current>a:hover,.wy-menu-vertical li.on a:hover{background:#fcfcfc}.wy-menu-vertical li.current>a:hover button.toctree-expand,.wy-menu-vertical li.on a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand{display:block;line-height:18px;color:#333}.wy-menu-vertical li.toctree-l1.current>a{border-bottom:1px solid #c9c9c9;border-top:1px solid #c9c9c9}.wy-menu-vertical .toctree-l1.current .toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .toctree-l11>ul{display:none}.wy-menu-vertical .toctree-l1.current .current.toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .current.toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .current.toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .current.toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .current.toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .current.toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .current.toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .current.toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .current.toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .current.toctree-l11>ul{display:block}.wy-menu-vertical li.toctree-l3,.wy-menu-vertical li.toctree-l4{font-size:.9em}.wy-menu-vertical li.toctree-l2 a,.wy-menu-vertical li.toctree-l3 a,.wy-menu-vertical li.toctree-l4 a,.wy-menu-vertical li.toctree-l5 a,.wy-menu-vertical li.toctree-l6 a,.wy-menu-vertical li.toctree-l7 a,.wy-menu-vertical li.toctree-l8 a,.wy-menu-vertical li.toctree-l9 a,.wy-menu-vertical li.toctree-l10 a{color:#404040}.wy-menu-vertical li.toctree-l2 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l3 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l4 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l5 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l6 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l7 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l8 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l9 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l10 a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a,.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a,.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a,.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a,.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a,.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a,.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a,.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{display:block}.wy-menu-vertical li.toctree-l2.current>a{padding:.4045em 2.427em}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{padding:.4045em 1.618em .4045em 4.045em}.wy-menu-vertical li.toctree-l3.current>a{padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{padding:.4045em 1.618em .4045em 5.663em}.wy-menu-vertical li.toctree-l4.current>a{padding:.4045em 5.663em}.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a{padding:.4045em 1.618em .4045em 7.281em}.wy-menu-vertical li.toctree-l5.current>a{padding:.4045em 7.281em}.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a{padding:.4045em 1.618em .4045em 8.899em}.wy-menu-vertical li.toctree-l6.current>a{padding:.4045em 8.899em}.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a{padding:.4045em 1.618em .4045em 10.517em}.wy-menu-vertical li.toctree-l7.current>a{padding:.4045em 10.517em}.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a{padding:.4045em 1.618em .4045em 12.135em}.wy-menu-vertical li.toctree-l8.current>a{padding:.4045em 12.135em}.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a{padding:.4045em 1.618em .4045em 13.753em}.wy-menu-vertical li.toctree-l9.current>a{padding:.4045em 13.753em}.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a{padding:.4045em 1.618em .4045em 15.371em}.wy-menu-vertical li.toctree-l10.current>a{padding:.4045em 15.371em}.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{padding:.4045em 1.618em .4045em 16.989em}.wy-menu-vertical li.toctree-l2.current>a,.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{background:#c9c9c9}.wy-menu-vertical li.toctree-l2 button.toctree-expand{color:#a3a3a3}.wy-menu-vertical li.toctree-l3.current>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{background:#bdbdbd}.wy-menu-vertical li.toctree-l3 button.toctree-expand{color:#969696}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical li ul li a{margin-bottom:0;color:#d9d9d9;font-weight:400}.wy-menu-vertical a{line-height:18px;padding:.4045em 1.618em;display:block;position:relative;font-size:90%;color:#d9d9d9}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:hover button.toctree-expand{color:#d9d9d9}.wy-menu-vertical a:active{background-color:#2980b9;cursor:pointer;color:#fff}.wy-menu-vertical a:active button.toctree-expand{color:#fff}.wy-side-nav-search{display:block;width:300px;padding:.809em;margin-bottom:.809em;z-index:200;background-color:#2980b9;text-align:center;color:#fcfcfc}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#2472a4}.wy-side-nav-search img{display:block;margin:auto auto .809em;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-side-nav-search .wy-dropdown>a,.wy-side-nav-search>a{color:#fcfcfc;font-size:100%;font-weight:700;display:inline-block;padding:4px 6px;margin-bottom:.809em;max-width:100%}.wy-side-nav-search .wy-dropdown>a:hover,.wy-side-nav-search>a:hover{background:hsla(0,0%,100%,.1)}.wy-side-nav-search .wy-dropdown>a img.logo,.wy-side-nav-search>a img.logo{display:block;margin:0 auto;height:auto;width:auto;border-radius:0;max-width:100%;background:transparent}.wy-side-nav-search .wy-dropdown>a.icon img.logo,.wy-side-nav-search>a.icon img.logo{margin-top:.85em}.wy-side-nav-search>div.version{margin-top:-.4045em;margin-bottom:.809em;font-weight:400;color:hsla(0,0%,100%,.3)}.wy-nav .wy-menu-vertical header{color:#2980b9}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#2980b9;color:#fff}[data-menu-wrap]{-webkit-transition:all .2s ease-in;-moz-transition:all .2s ease-in;transition:all .2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:#fcfcfc}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:fixed;top:0;bottom:0;left:0;padding-bottom:2em;width:300px;overflow-x:hidden;overflow-y:hidden;min-height:100%;color:#9b9b9b;background:#343131;z-index:200}.wy-side-scroll{width:320px;position:relative;overflow-x:hidden;overflow-y:scroll;height:100%}.wy-nav-top{display:none;background:#2980b9;color:#fff;padding:.4045em .809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:after,.wy-nav-top:before{display:table;content:""}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:700}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer;padding-top:inherit}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100%;max-width:800px;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:grey}footer p{margin-bottom:12px}.rst-content footer span.commit tt,footer span.commit .rst-content tt,footer span.commit code{padding:0;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:1em;background:none;border:none;color:grey}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:after,.rst-footer-buttons:before{width:100%;display:table;content:""}.rst-footer-buttons:after{clear:both}.rst-breadcrumbs-buttons{margin-top:12px;*zoom:1}.rst-breadcrumbs-buttons:after,.rst-breadcrumbs-buttons:before{display:table;content:""}.rst-breadcrumbs-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:1px solid #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:1px solid #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:grey;font-size:90%}.genindextable li>ul{margin-left:24px}@media screen and (max-width:768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-menu.wy-menu-vertical,.wy-side-nav-search,.wy-side-scroll{width:auto}.wy-nav-content-wrap{margin-left:0}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width:1100px){.wy-nav-content-wrap{background:rgba(0,0,0,.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,.wy-nav-side,footer{display:none}.wy-nav-content-wrap{margin-left:0}}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60;*zoom:1}.rst-versions .rst-current-version:after,.rst-versions .rst-current-version:before{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-content .code-block-caption .rst-versions .rst-current-version .headerlink,.rst-content .eqno .rst-versions .rst-current-version .headerlink,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-content code.download .rst-versions .rst-current-version span:first-child,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-content p .rst-versions .rst-current-version .headerlink,.rst-content table>caption .rst-versions .rst-current-version .headerlink,.rst-content tt.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .icon,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-versions .rst-current-version .rst-content .code-block-caption .headerlink,.rst-versions .rst-current-version .rst-content .eqno .headerlink,.rst-versions .rst-current-version .rst-content code.download span:first-child,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-versions .rst-current-version .rst-content p .headerlink,.rst-versions .rst-current-version .rst-content table>caption .headerlink,.rst-versions .rst-current-version .rst-content tt.download span:first-child,.rst-versions .rst-current-version .wy-menu-vertical li button.toctree-expand,.wy-menu-vertical li .rst-versions .rst-current-version button.toctree-expand{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}.rst-content .toctree-wrapper>p.caption,.rst-content h1,.rst-content h2,.rst-content h3,.rst-content h4,.rst-content h5,.rst-content h6{margin-bottom:24px}.rst-content img{max-width:100%;height:auto}.rst-content div.figure,.rst-content figure{margin-bottom:24px}.rst-content div.figure .caption-text,.rst-content figure .caption-text{font-style:italic}.rst-content div.figure p:last-child.caption,.rst-content figure p:last-child.caption{margin-bottom:0}.rst-content div.figure.align-center,.rst-content figure.align-center{text-align:center}.rst-content .section>a>img,.rst-content .section>img,.rst-content section>a>img,.rst-content section>img{margin-bottom:24px}.rst-content abbr[title]{text-decoration:none}.rst-content.style-external-links a.reference.external:after{font-family:FontAwesome;content:"\f08e";color:#b3b3b3;vertical-align:super;font-size:60%;margin:0 .2em}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content pre.literal-block{white-space:pre;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;display:block;overflow:auto}.rst-content div[class^=highlight],.rst-content pre.literal-block{border:1px solid #e1e4e5;overflow-x:auto;margin:1px 0 24px}.rst-content div[class^=highlight] div[class^=highlight],.rst-content pre.literal-block div[class^=highlight]{padding:0;border:none;margin:0}.rst-content div[class^=highlight] td.code{width:100%}.rst-content .linenodiv pre{border-right:1px solid #e6e9ea;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;user-select:none;pointer-events:none}.rst-content div[class^=highlight] pre{white-space:pre;margin:0;padding:12px;display:block;overflow:auto}.rst-content div[class^=highlight] pre .hll{display:block;margin:0 -12px;padding:0 12px}.rst-content .linenodiv pre,.rst-content div[class^=highlight] pre,.rst-content pre.literal-block{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:12px;line-height:1.4}.rst-content div.highlight .gp,.rst-content div.highlight span.linenos{user-select:none;pointer-events:none}.rst-content div.highlight span.linenos{display:inline-block;padding-left:0;padding-right:12px;margin-right:12px;border-right:1px solid #e6e9ea}.rst-content .code-block-caption{font-style:italic;font-size:85%;line-height:1;padding:1em 0;text-align:center}@media print{.rst-content .codeblock,.rst-content div[class^=highlight],.rst-content div[class^=highlight] pre{white-space:pre-wrap}}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning{clear:both}.rst-content .admonition-todo .last,.rst-content .admonition-todo>:last-child,.rst-content .admonition .last,.rst-content .admonition>:last-child,.rst-content .attention .last,.rst-content .attention>:last-child,.rst-content .caution .last,.rst-content .caution>:last-child,.rst-content .danger .last,.rst-content .danger>:last-child,.rst-content .error .last,.rst-content .error>:last-child,.rst-content .hint .last,.rst-content .hint>:last-child,.rst-content .important .last,.rst-content .important>:last-child,.rst-content .note .last,.rst-content .note>:last-child,.rst-content .seealso .last,.rst-content .seealso>:last-child,.rst-content .tip .last,.rst-content .tip>:last-child,.rst-content .warning .last,.rst-content .warning>:last-child{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent!important;border-color:rgba(0,0,0,.1)!important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha>li,.rst-content .toctree-wrapper ol.loweralpha,.rst-content .toctree-wrapper ol.loweralpha>li,.rst-content section ol.loweralpha,.rst-content section ol.loweralpha>li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha>li,.rst-content .toctree-wrapper ol.upperalpha,.rst-content .toctree-wrapper ol.upperalpha>li,.rst-content section ol.upperalpha,.rst-content section ol.upperalpha>li{list-style:upper-alpha}.rst-content .section ol li>*,.rst-content .section ul li>*,.rst-content .toctree-wrapper ol li>*,.rst-content .toctree-wrapper ul li>*,.rst-content section ol li>*,.rst-content section ul li>*{margin-top:12px;margin-bottom:12px}.rst-content .section ol li>:first-child,.rst-content .section ul li>:first-child,.rst-content .toctree-wrapper ol li>:first-child,.rst-content .toctree-wrapper ul li>:first-child,.rst-content section ol li>:first-child,.rst-content section ul li>:first-child{margin-top:0}.rst-content .section ol li>p,.rst-content .section ol li>p:last-child,.rst-content .section ul li>p,.rst-content .section ul li>p:last-child,.rst-content .toctree-wrapper ol li>p,.rst-content .toctree-wrapper ol li>p:last-child,.rst-content .toctree-wrapper ul li>p,.rst-content .toctree-wrapper ul li>p:last-child,.rst-content section ol li>p,.rst-content section ol li>p:last-child,.rst-content section ul li>p,.rst-content section ul li>p:last-child{margin-bottom:12px}.rst-content .section ol li>p:only-child,.rst-content .section ol li>p:only-child:last-child,.rst-content .section ul li>p:only-child,.rst-content .section ul li>p:only-child:last-child,.rst-content .toctree-wrapper ol li>p:only-child,.rst-content .toctree-wrapper ol li>p:only-child:last-child,.rst-content .toctree-wrapper ul li>p:only-child,.rst-content .toctree-wrapper ul li>p:only-child:last-child,.rst-content section ol li>p:only-child,.rst-content section ol li>p:only-child:last-child,.rst-content section ul li>p:only-child,.rst-content section ul li>p:only-child:last-child{margin-bottom:0}.rst-content .section ol li>ol,.rst-content .section ol li>ul,.rst-content .section ul li>ol,.rst-content .section ul li>ul,.rst-content .toctree-wrapper ol li>ol,.rst-content .toctree-wrapper ol li>ul,.rst-content .toctree-wrapper ul li>ol,.rst-content .toctree-wrapper ul li>ul,.rst-content section ol li>ol,.rst-content section ol li>ul,.rst-content section ul li>ol,.rst-content section ul li>ul{margin-bottom:12px}.rst-content .section ol.simple li>*,.rst-content .section ol.simple li ol,.rst-content .section ol.simple li ul,.rst-content .section ul.simple li>*,.rst-content .section ul.simple li ol,.rst-content .section ul.simple li ul,.rst-content .toctree-wrapper ol.simple li>*,.rst-content .toctree-wrapper ol.simple li ol,.rst-content .toctree-wrapper ol.simple li ul,.rst-content .toctree-wrapper ul.simple li>*,.rst-content .toctree-wrapper ul.simple li ol,.rst-content .toctree-wrapper ul.simple li ul,.rst-content section ol.simple li>*,.rst-content section ol.simple li ol,.rst-content section ol.simple li ul,.rst-content section ul.simple li>*,.rst-content section ul.simple li ol,.rst-content section ul.simple li ul{margin-top:0;margin-bottom:0}.rst-content .line-block{margin-left:0;margin-bottom:24px;line-height:24px}.rst-content .line-block .line-block{margin-left:24px;margin-bottom:0}.rst-content .topic-title{font-weight:700;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0 0 24px 24px}.rst-content .align-left{float:left;margin:0 24px 24px 0}.rst-content .align-center{margin:auto}.rst-content .align-center:not(table){display:block}.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink{opacity:0;font-size:14px;font-family:FontAwesome;margin-left:.5em}.rst-content .code-block-caption .headerlink:focus,.rst-content .code-block-caption:hover .headerlink,.rst-content .eqno .headerlink:focus,.rst-content .eqno:hover .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink:focus,.rst-content .toctree-wrapper>p.caption:hover .headerlink,.rst-content dl dt .headerlink:focus,.rst-content dl dt:hover .headerlink,.rst-content h1 .headerlink:focus,.rst-content h1:hover .headerlink,.rst-content h2 .headerlink:focus,.rst-content h2:hover .headerlink,.rst-content h3 .headerlink:focus,.rst-content h3:hover .headerlink,.rst-content h4 .headerlink:focus,.rst-content h4:hover .headerlink,.rst-content h5 .headerlink:focus,.rst-content h5:hover .headerlink,.rst-content h6 .headerlink:focus,.rst-content h6:hover .headerlink,.rst-content p.caption .headerlink:focus,.rst-content p.caption:hover .headerlink,.rst-content p .headerlink:focus,.rst-content p:hover .headerlink,.rst-content table>caption .headerlink:focus,.rst-content table>caption:hover .headerlink{opacity:1}.rst-content p a{overflow-wrap:anywhere}.rst-content .wy-table td p,.rst-content .wy-table td ul,.rst-content .wy-table th p,.rst-content .wy-table th ul,.rst-content table.docutils td p,.rst-content table.docutils td ul,.rst-content table.docutils th p,.rst-content table.docutils th ul,.rst-content table.field-list td p,.rst-content table.field-list td ul,.rst-content table.field-list th p,.rst-content table.field-list th ul{font-size:inherit}.rst-content .btn:focus{outline:2px solid}.rst-content table>caption .headerlink:after{font-size:12px}.rst-content .centered{text-align:center}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:1px solid #e1e4e5}.rst-content .sidebar dl,.rst-content .sidebar p,.rst-content .sidebar ul{font-size:90%}.rst-content .sidebar .last,.rst-content .sidebar>:last-child{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif;font-weight:700;background:#e1e4e5;padding:6px 12px;margin:-24px -24px 24px;font-size:100%}.rst-content .highlighted{background:#f1c40f;box-shadow:0 0 0 2px #f1c40f;display:inline;font-weight:700}.rst-content .citation-reference,.rst-content .footnote-reference{vertical-align:baseline;position:relative;top:-.4em;line-height:0;font-size:90%}.rst-content .citation-reference>span.fn-bracket,.rst-content .footnote-reference>span.fn-bracket{display:none}.rst-content .hlist{width:100%}.rst-content dl dt span.classifier:before{content:" : "}.rst-content dl dt span.classifier-delimiter{display:none!important}html.writer-html4 .rst-content table.docutils.citation,html.writer-html4 .rst-content table.docutils.footnote{background:none;border:none}html.writer-html4 .rst-content table.docutils.citation td,html.writer-html4 .rst-content table.docutils.citation tr,html.writer-html4 .rst-content table.docutils.footnote td,html.writer-html4 .rst-content table.docutils.footnote tr{border:none;background-color:transparent!important;white-space:normal}html.writer-html4 .rst-content table.docutils.citation td.label,html.writer-html4 .rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{display:grid;grid-template-columns:auto minmax(80%,95%)}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{display:inline-grid;grid-template-columns:max-content auto}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{display:grid;grid-template-columns:auto auto minmax(.65rem,auto) minmax(40%,95%)}html.writer-html5 .rst-content aside.citation>span.label,html.writer-html5 .rst-content aside.footnote>span.label,html.writer-html5 .rst-content div.citation>span.label{grid-column-start:1;grid-column-end:2}html.writer-html5 .rst-content aside.citation>span.backrefs,html.writer-html5 .rst-content aside.footnote>span.backrefs,html.writer-html5 .rst-content div.citation>span.backrefs{grid-column-start:2;grid-column-end:3;grid-row-start:1;grid-row-end:3}html.writer-html5 .rst-content aside.citation>p,html.writer-html5 .rst-content aside.footnote>p,html.writer-html5 .rst-content div.citation>p{grid-column-start:4;grid-column-end:5}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{margin-bottom:24px}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{padding-left:1rem}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dd,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dd,html.writer-html5 .rst-content dl.footnote>dt{margin-bottom:0}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{font-size:.9rem}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.footnote>dt{margin:0 .5rem .5rem 0;line-height:1.2rem;word-break:break-all;font-weight:400}html.writer-html5 .rst-content dl.citation>dt>span.brackets:before,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:before{content:"["}html.writer-html5 .rst-content dl.citation>dt>span.brackets:after,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:after{content:"]"}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a{word-break:keep-all}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a:not(:first-child):before,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.footnote>dd{margin:0 0 .5rem;line-height:1.2rem}html.writer-html5 .rst-content dl.citation>dd p,html.writer-html5 .rst-content dl.footnote>dd p{font-size:.9rem}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{padding-left:1rem;padding-right:1rem;font-size:.9rem;line-height:1.2rem}html.writer-html5 .rst-content aside.citation p,html.writer-html5 .rst-content aside.footnote p,html.writer-html5 .rst-content div.citation p{font-size:.9rem;line-height:1.2rem;margin-bottom:12px}html.writer-html5 .rst-content aside.citation span.backrefs,html.writer-html5 .rst-content aside.footnote span.backrefs,html.writer-html5 .rst-content div.citation span.backrefs{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content aside.citation span.backrefs>a,html.writer-html5 .rst-content aside.footnote span.backrefs>a,html.writer-html5 .rst-content div.citation span.backrefs>a{word-break:keep-all}html.writer-html5 .rst-content aside.citation span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content aside.footnote span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content div.citation span.backrefs>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content aside.citation span.label,html.writer-html5 .rst-content aside.footnote span.label,html.writer-html5 .rst-content div.citation span.label{line-height:1.2rem}html.writer-html5 .rst-content aside.citation-list,html.writer-html5 .rst-content aside.footnote-list,html.writer-html5 .rst-content div.citation-list{margin-bottom:24px}html.writer-html5 .rst-content dl.option-list kbd{font-size:.9rem}.rst-content table.docutils.footnote,html.writer-html4 .rst-content table.docutils.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content aside.footnote-list aside.footnote,html.writer-html5 .rst-content div.citation-list>div.citation,html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{color:grey}.rst-content table.docutils.footnote code,.rst-content table.docutils.footnote tt,html.writer-html4 .rst-content table.docutils.citation code,html.writer-html4 .rst-content table.docutils.citation tt,html.writer-html5 .rst-content aside.footnote-list aside.footnote code,html.writer-html5 .rst-content aside.footnote-list aside.footnote tt,html.writer-html5 .rst-content aside.footnote code,html.writer-html5 .rst-content aside.footnote tt,html.writer-html5 .rst-content div.citation-list>div.citation code,html.writer-html5 .rst-content div.citation-list>div.citation tt,html.writer-html5 .rst-content dl.citation code,html.writer-html5 .rst-content dl.citation tt,html.writer-html5 .rst-content dl.footnote code,html.writer-html5 .rst-content dl.footnote tt{color:#555}.rst-content .wy-table-responsive.citation,.rst-content .wy-table-responsive.footnote{margin-bottom:0}.rst-content .wy-table-responsive.citation+:not(.citation),.rst-content .wy-table-responsive.footnote+:not(.footnote){margin-top:24px}.rst-content .wy-table-responsive.citation:last-child,.rst-content .wy-table-responsive.footnote:last-child{margin-bottom:24px}.rst-content table.docutils th{border-color:#e1e4e5}html.writer-html5 .rst-content table.docutils th{border:1px solid #e1e4e5}html.writer-html5 .rst-content table.docutils td>p,html.writer-html5 .rst-content table.docutils th>p{line-height:1rem;margin-bottom:0;font-size:.9rem}.rst-content table.docutils td .last,.rst-content table.docutils td .last>:last-child{margin-bottom:0}.rst-content table.field-list,.rst-content table.field-list td{border:none}.rst-content table.field-list td p{line-height:inherit}.rst-content table.field-list td>strong{display:inline-block}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left}.rst-content code,.rst-content tt{color:#000;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;padding:2px 5px}.rst-content code big,.rst-content code em,.rst-content tt big,.rst-content tt em{font-size:100%!important;line-height:normal}.rst-content code.literal,.rst-content tt.literal{color:#e74c3c;white-space:normal}.rst-content code.xref,.rst-content tt.xref,a .rst-content code,a .rst-content tt{font-weight:700;color:#404040;overflow-wrap:normal}.rst-content kbd,.rst-content pre,.rst-content samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace}.rst-content a code,.rst-content a tt{color:#2980b9}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:700;margin-bottom:12px}.rst-content dl ol,.rst-content dl p,.rst-content dl table,.rst-content dl ul{margin-bottom:12px}.rst-content dl dd{margin:0 0 12px 24px;line-height:24px}.rst-content dl dd>ol:last-child,.rst-content dl dd>p:last-child,.rst-content dl dd>table:last-child,.rst-content dl dd>ul:last-child{margin-bottom:0}html.writer-html4 .rst-content dl:not(.docutils),html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple){margin-bottom:24px}html.writer-html4 .rst-content dl:not(.docutils)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{display:table;margin:6px 0;font-size:90%;line-height:normal;background:#e7f2fa;color:#2980b9;border-top:3px solid #6ab0de;padding:6px;position:relative}html.writer-html4 .rst-content dl:not(.docutils)>dt:before,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:before{color:#6ab0de}html.writer-html4 .rst-content dl:not(.docutils)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{margin-bottom:6px;border:none;border-left:3px solid #ccc;background:#f0f0f0;color:#555}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils)>dt:first-child,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:first-child{margin-top:0}html.writer-html4 .rst-content dl:not(.docutils) code.descclassname,html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descclassname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{background-color:transparent;border:none;padding:0;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .optional,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .property,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .property{display:inline-block;padding-right:8px;max-width:100%}html.writer-html4 .rst-content dl:not(.docutils) .k,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .k{font-style:italic}html.writer-html4 .rst-content dl:not(.docutils) .descclassname,html.writer-html4 .rst-content dl:not(.docutils) .descname,html.writer-html4 .rst-content dl:not(.docutils) .sig-name,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .sig-name{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#000}.rst-content .viewcode-back,.rst-content .viewcode-link{display:inline-block;color:#27ae60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:700}.rst-content code.download,.rst-content tt.download{background:inherit;padding:inherit;font-weight:400;font-family:inherit;font-size:inherit;color:inherit;border:inherit;white-space:inherit}.rst-content code.download span:first-child,.rst-content tt.download span:first-child{-webkit-font-smoothing:subpixel-antialiased}.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{margin-right:4px}.rst-content .guilabel{border:1px solid #7fbbe3;background:#e7f2fa;font-size:80%;font-weight:700;border-radius:4px;padding:2.4px 6px;margin:auto 2px}.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>.kbd,.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>kbd{color:inherit;font-size:80%;background-color:#fff;border:1px solid #a6a6a6;border-radius:4px;box-shadow:0 2px grey;padding:2.4px 6px;margin:auto 0}.rst-content .versionmodified{font-style:italic}@media screen and (max-width:480px){.rst-content .sidebar{width:100%}}span[id*=MathJax-Span]{color:#404040}.math{text-align:center}@font-face{font-family:Lato;src:url(fonts/lato-normal.woff2?bd03a2cc277bbbc338d464e679fe9942) format("woff2"),url(fonts/lato-normal.woff?27bd77b9162d388cb8d4c4217c7c5e2a) format("woff");font-weight:400;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold.woff2?cccb897485813c7c256901dbca54ecf2) format("woff2"),url(fonts/lato-bold.woff?d878b6c29b10beca227e9eef4246111b) format("woff");font-weight:700;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold-italic.woff2?0b6bb6725576b072c5d0b02ecdd1900d) format("woff2"),url(fonts/lato-bold-italic.woff?9c7e4e9eb485b4a121c760e61bc3707c) format("woff");font-weight:700;font-style:italic;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-normal-italic.woff2?4eb103b4d12be57cb1d040ed5e162e9d) format("woff2"),url(fonts/lato-normal-italic.woff?f28f2d6482446544ef1ea1ccc6dd5892) format("woff");font-weight:400;font-style:italic;font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:400;src:url(fonts/Roboto-Slab-Regular.woff2?7abf5b8d04d26a2cafea937019bca958) format("woff2"),url(fonts/Roboto-Slab-Regular.woff?c1be9284088d487c5e3ff0a10a92e58c) format("woff");font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:700;src:url(fonts/Roboto-Slab-Bold.woff2?9984f4a9bda09be08e83f2506954adbe) format("woff2"),url(fonts/Roboto-Slab-Bold.woff?bed5564a116b05148e3b3bea6fb1162a) format("woff");font-display:block} diff --git a/css/theme_extra.css b/css/theme_extra.css new file mode 100644 index 0000000..ab0631a --- /dev/null +++ b/css/theme_extra.css @@ -0,0 +1,197 @@ +/* + * Wrap inline code samples otherwise they shoot of the side and + * can't be read at all. + * + * https://github.com/mkdocs/mkdocs/issues/313 + * https://github.com/mkdocs/mkdocs/issues/233 + * https://github.com/mkdocs/mkdocs/issues/834 + */ +.rst-content code { + white-space: pre-wrap; + word-wrap: break-word; + padding: 2px 5px; +} + +/** + * Make code blocks display as blocks and give them the appropriate + * font size and padding. + * + * https://github.com/mkdocs/mkdocs/issues/855 + * https://github.com/mkdocs/mkdocs/issues/834 + * https://github.com/mkdocs/mkdocs/issues/233 + */ +.rst-content pre code { + white-space: pre; + word-wrap: normal; + display: block; + padding: 12px; + font-size: 12px; +} + +/** + * Fix code colors + * + * https://github.com/mkdocs/mkdocs/issues/2027 + */ +.rst-content code { + color: #E74C3C; +} + +.rst-content pre code { + color: #000; + background: #f8f8f8; +} + +/* + * Fix link colors when the link text is inline code. + * + * https://github.com/mkdocs/mkdocs/issues/718 + */ +a code { + color: #2980B9; +} +a:hover code { + color: #3091d1; +} +a:visited code { + color: #9B59B6; +} + +/* + * The CSS classes from highlight.js seem to clash with the + * ReadTheDocs theme causing some code to be incorrectly made + * bold and italic. + * + * https://github.com/mkdocs/mkdocs/issues/411 + */ +pre .cs, pre .c { + font-weight: inherit; + font-style: inherit; +} + +/* + * Fix some issues with the theme and non-highlighted code + * samples. Without and highlighting styles attached the + * formatting is broken. + * + * https://github.com/mkdocs/mkdocs/issues/319 + */ +.rst-content .no-highlight { + display: block; + padding: 0.5em; + color: #333; +} + + +/* + * Additions specific to the search functionality provided by MkDocs + */ + +.search-results { + margin-top: 23px; +} + +.search-results article { + border-top: 1px solid #E1E4E5; + padding-top: 24px; +} + +.search-results article:first-child { + border-top: none; +} + +form .search-query { + width: 100%; + border-radius: 50px; + padding: 6px 12px; + border-color: #D1D4D5; +} + +/* + * Improve inline code blocks within admonitions. + * + * https://github.com/mkdocs/mkdocs/issues/656 + */ + .rst-content .admonition code { + color: #404040; + border: 1px solid #c7c9cb; + border: 1px solid rgba(0, 0, 0, 0.2); + background: #f8fbfd; + background: rgba(255, 255, 255, 0.7); +} + +/* + * Account for wide tables which go off the side. + * Override borders to avoid weirdness on narrow tables. + * + * https://github.com/mkdocs/mkdocs/issues/834 + * https://github.com/mkdocs/mkdocs/pull/1034 + */ +.rst-content .section .docutils { + width: 100%; + overflow: auto; + display: block; + border: none; +} + +td, th { + border: 1px solid #e1e4e5 !important; + border-collapse: collapse; +} + +/* + * Without the following amendments, the navigation in the theme will be + * slightly cut off. This is due to the fact that the .wy-nav-side has a + * padding-bottom of 2em, which must not necessarily align with the font-size of + * 90 % on the .rst-current-version container, combined with the padding of 12px + * above and below. These amendments fix this in two steps: First, make sure the + * .rst-current-version container has a fixed height of 40px, achieved using + * line-height, and then applying a padding-bottom of 40px to this container. In + * a second step, the items within that container are re-aligned using flexbox. + * + * https://github.com/mkdocs/mkdocs/issues/2012 + */ + .wy-nav-side { + padding-bottom: 40px; +} + +/* For section-index only */ +.wy-menu-vertical .current-section p { + background-color: #e3e3e3; + color: #404040; +} + +/* + * The second step of above amendment: Here we make sure the items are aligned + * correctly within the .rst-current-version container. Using flexbox, we + * achieve it in such a way that it will look like the following: + * + * [No repo_name] + * Next >> // On the first page + * << Previous Next >> // On all subsequent pages + * + * [With repo_name] + * Next >> // On the first page + * << Previous Next >> // On all subsequent pages + * + * https://github.com/mkdocs/mkdocs/issues/2012 + */ +.rst-versions .rst-current-version { + padding: 0 12px; + display: flex; + font-size: initial; + justify-content: space-between; + align-items: center; + line-height: 40px; +} + +/* + * Please note that this amendment also involves removing certain inline-styles + * from the file ./mkdocs/themes/readthedocs/versions.html. + * + * https://github.com/mkdocs/mkdocs/issues/2012 + */ +.rst-current-version span { + flex: 1; + text-align: center; +} diff --git a/general-questions.ipynb b/general-questions.ipynb new file mode 100644 index 0000000..2c474a3 --- /dev/null +++ b/general-questions.ipynb @@ -0,0 +1,41 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "id": "f6c91a18-bca6-4e91-91b2-b221c523f266", + "metadata": {}, + "source": [ + "# To be added " + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "34e2b65f-442a-4470-bf00-ace206fccccf", + "metadata": {}, + "outputs": [], + "source": [] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.10.10" + } + }, + "nbformat": 4, + "nbformat_minor": 5 +} diff --git a/general-questions/index.html b/general-questions/index.html new file mode 100644 index 0000000..851f2a2 --- /dev/null +++ b/general-questions/index.html @@ -0,0 +1,127 @@ + + + + + + + + To be added - Lab note for UMD BIOI611 + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+
+
+ +

To be added

+

+
+ +
+
+ +
+
+ +
+ +
+ +
+ + + + Bix4UMD/BIOI611_lab + + + + + +
+ + + + + + + + + diff --git a/img/favicon.ico b/img/favicon.ico new file mode 100644 index 0000000..e85006a Binary files /dev/null and b/img/favicon.ico differ diff --git a/index.html b/index.html new file mode 100644 index 0000000..ee20d52 --- /dev/null +++ b/index.html @@ -0,0 +1,132 @@ + + + + + + + + Lab note for UMD BIOI611 + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+
+
+ +

BIOI611 lab

+

Welcome to BIOI 611! I’m excited to have you in this course, where we will delve into the fascinating world of transcriptomics and explore the intricacies of gene and transcript-level expression analysis.

+

This course focuses on the analysis of transcriptomics data, and specifically on the analysis of gene and transcript-level expression. Material covered includes transcript and gene expression estimation from RNA-seq data (short and long-read), basic experimental design and statistical methods for differential expression analysis, discovery of novel transcripts via reference-guided and de novo assembly, and the analysis of single-cell gene expression data (e.g., single-cell expression quantification, dimensionality reduction, clustering, pseudotime analysis). Prerequisite: BIOI 604. Core.

+ +
+
+ +
+
+ +
+ +
+ +
+ + + + Bix4UMD/BIOI611_lab + + + + + +
+ + + + + + + + + + + diff --git a/js/html5shiv.min.js b/js/html5shiv.min.js new file mode 100644 index 0000000..1a01c94 --- /dev/null +++ b/js/html5shiv.min.js @@ -0,0 +1,4 @@ +/** +* @preserve HTML5 Shiv 3.7.3 | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed +*/ +!function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=t.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=t.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),t.elements=c+" "+a,j(b)}function f(a){var b=s[a[q]];return b||(b={},r++,a[q]=r,s[r]=b),b}function g(a,c,d){if(c||(c=b),l)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():p.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||o.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),l)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return t.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(t,b.frag)}function j(a){a||(a=b);var d=f(a);return!t.shivCSS||k||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),l||i(a,d),a}var k,l,m="3.7.3",n=a.html5||{},o=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,p=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,q="_html5shiv",r=0,s={};!function(){try{var a=b.createElement("a");a.innerHTML="",k="hidden"in a,l=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){k=!0,l=!0}}();var t={elements:n.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:m,shivCSS:n.shivCSS!==!1,supportsUnknownElements:l,shivMethods:n.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=t,j(b),"object"==typeof module&&module.exports&&(module.exports=t)}("undefined"!=typeof window?window:this,document); diff --git a/js/jquery-3.6.0.min.js b/js/jquery-3.6.0.min.js new file mode 100644 index 0000000..c4c6022 --- /dev/null +++ b/js/jquery-3.6.0.min.js @@ -0,0 +1,2 @@ +/*! jQuery v3.6.0 | (c) OpenJS Foundation and other contributors | jquery.org/license */ +!function(e,t){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=e.document?t(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return t(e)}:t(e)}("undefined"!=typeof window?window:this,function(C,e){"use strict";var t=[],r=Object.getPrototypeOf,s=t.slice,g=t.flat?function(e){return t.flat.call(e)}:function(e){return t.concat.apply([],e)},u=t.push,i=t.indexOf,n={},o=n.toString,v=n.hasOwnProperty,a=v.toString,l=a.call(Object),y={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType&&"function"!=typeof e.item},x=function(e){return null!=e&&e===e.window},E=C.document,c={type:!0,src:!0,nonce:!0,noModule:!0};function b(e,t,n){var r,i,o=(n=n||E).createElement("script");if(o.text=e,t)for(r in c)(i=t[r]||t.getAttribute&&t.getAttribute(r))&&o.setAttribute(r,i);n.head.appendChild(o).parentNode.removeChild(o)}function w(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?n[o.call(e)]||"object":typeof e}var f="3.6.0",S=function(e,t){return new S.fn.init(e,t)};function p(e){var t=!!e&&"length"in e&&e.length,n=w(e);return!m(e)&&!x(e)&&("array"===n||0===t||"number"==typeof t&&0+~]|"+M+")"+M+"*"),U=new RegExp(M+"|>"),X=new RegExp(F),V=new RegExp("^"+I+"$"),G={ID:new RegExp("^#("+I+")"),CLASS:new RegExp("^\\.("+I+")"),TAG:new RegExp("^("+I+"|[*])"),ATTR:new RegExp("^"+W),PSEUDO:new RegExp("^"+F),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+R+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},Y=/HTML$/i,Q=/^(?:input|select|textarea|button)$/i,J=/^h\d$/i,K=/^[^{]+\{\s*\[native \w/,Z=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,ee=/[+~]/,te=new RegExp("\\\\[\\da-fA-F]{1,6}"+M+"?|\\\\([^\\r\\n\\f])","g"),ne=function(e,t){var n="0x"+e.slice(1)-65536;return t||(n<0?String.fromCharCode(n+65536):String.fromCharCode(n>>10|55296,1023&n|56320))},re=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ie=function(e,t){return t?"\0"===e?"\ufffd":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},oe=function(){T()},ae=be(function(e){return!0===e.disabled&&"fieldset"===e.nodeName.toLowerCase()},{dir:"parentNode",next:"legend"});try{H.apply(t=O.call(p.childNodes),p.childNodes),t[p.childNodes.length].nodeType}catch(e){H={apply:t.length?function(e,t){L.apply(e,O.call(t))}:function(e,t){var n=e.length,r=0;while(e[n++]=t[r++]);e.length=n-1}}}function se(t,e,n,r){var i,o,a,s,u,l,c,f=e&&e.ownerDocument,p=e?e.nodeType:9;if(n=n||[],"string"!=typeof t||!t||1!==p&&9!==p&&11!==p)return n;if(!r&&(T(e),e=e||C,E)){if(11!==p&&(u=Z.exec(t)))if(i=u[1]){if(9===p){if(!(a=e.getElementById(i)))return n;if(a.id===i)return n.push(a),n}else if(f&&(a=f.getElementById(i))&&y(e,a)&&a.id===i)return n.push(a),n}else{if(u[2])return H.apply(n,e.getElementsByTagName(t)),n;if((i=u[3])&&d.getElementsByClassName&&e.getElementsByClassName)return H.apply(n,e.getElementsByClassName(i)),n}if(d.qsa&&!N[t+" "]&&(!v||!v.test(t))&&(1!==p||"object"!==e.nodeName.toLowerCase())){if(c=t,f=e,1===p&&(U.test(t)||z.test(t))){(f=ee.test(t)&&ye(e.parentNode)||e)===e&&d.scope||((s=e.getAttribute("id"))?s=s.replace(re,ie):e.setAttribute("id",s=S)),o=(l=h(t)).length;while(o--)l[o]=(s?"#"+s:":scope")+" "+xe(l[o]);c=l.join(",")}try{return H.apply(n,f.querySelectorAll(c)),n}catch(e){N(t,!0)}finally{s===S&&e.removeAttribute("id")}}}return g(t.replace($,"$1"),e,n,r)}function ue(){var r=[];return function e(t,n){return r.push(t+" ")>b.cacheLength&&delete e[r.shift()],e[t+" "]=n}}function le(e){return e[S]=!0,e}function ce(e){var t=C.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function fe(e,t){var n=e.split("|"),r=n.length;while(r--)b.attrHandle[n[r]]=t}function pe(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function de(t){return function(e){return"input"===e.nodeName.toLowerCase()&&e.type===t}}function he(n){return function(e){var t=e.nodeName.toLowerCase();return("input"===t||"button"===t)&&e.type===n}}function ge(t){return function(e){return"form"in e?e.parentNode&&!1===e.disabled?"label"in e?"label"in e.parentNode?e.parentNode.disabled===t:e.disabled===t:e.isDisabled===t||e.isDisabled!==!t&&ae(e)===t:e.disabled===t:"label"in e&&e.disabled===t}}function ve(a){return le(function(o){return o=+o,le(function(e,t){var n,r=a([],e.length,o),i=r.length;while(i--)e[n=r[i]]&&(e[n]=!(t[n]=e[n]))})})}function ye(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}for(e in d=se.support={},i=se.isXML=function(e){var t=e&&e.namespaceURI,n=e&&(e.ownerDocument||e).documentElement;return!Y.test(t||n&&n.nodeName||"HTML")},T=se.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:p;return r!=C&&9===r.nodeType&&r.documentElement&&(a=(C=r).documentElement,E=!i(C),p!=C&&(n=C.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",oe,!1):n.attachEvent&&n.attachEvent("onunload",oe)),d.scope=ce(function(e){return a.appendChild(e).appendChild(C.createElement("div")),"undefined"!=typeof e.querySelectorAll&&!e.querySelectorAll(":scope fieldset div").length}),d.attributes=ce(function(e){return e.className="i",!e.getAttribute("className")}),d.getElementsByTagName=ce(function(e){return e.appendChild(C.createComment("")),!e.getElementsByTagName("*").length}),d.getElementsByClassName=K.test(C.getElementsByClassName),d.getById=ce(function(e){return a.appendChild(e).id=S,!C.getElementsByName||!C.getElementsByName(S).length}),d.getById?(b.filter.ID=function(e){var t=e.replace(te,ne);return function(e){return e.getAttribute("id")===t}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n=t.getElementById(e);return n?[n]:[]}}):(b.filter.ID=function(e){var n=e.replace(te,ne);return function(e){var t="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return t&&t.value===n}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];i=t.getElementsByName(e),r=0;while(o=i[r++])if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),b.find.TAG=d.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):d.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=o[i++])1===n.nodeType&&r.push(n);return r}return o},b.find.CLASS=d.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&E)return t.getElementsByClassName(e)},s=[],v=[],(d.qsa=K.test(C.querySelectorAll))&&(ce(function(e){var t;a.appendChild(e).innerHTML="",e.querySelectorAll("[msallowcapture^='']").length&&v.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||v.push("\\["+M+"*(?:value|"+R+")"),e.querySelectorAll("[id~="+S+"-]").length||v.push("~="),(t=C.createElement("input")).setAttribute("name",""),e.appendChild(t),e.querySelectorAll("[name='']").length||v.push("\\["+M+"*name"+M+"*="+M+"*(?:''|\"\")"),e.querySelectorAll(":checked").length||v.push(":checked"),e.querySelectorAll("a#"+S+"+*").length||v.push(".#.+[+~]"),e.querySelectorAll("\\\f"),v.push("[\\r\\n\\f]")}),ce(function(e){e.innerHTML="";var t=C.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&v.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&v.push(":enabled",":disabled"),a.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&v.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),v.push(",.*:")})),(d.matchesSelector=K.test(c=a.matches||a.webkitMatchesSelector||a.mozMatchesSelector||a.oMatchesSelector||a.msMatchesSelector))&&ce(function(e){d.disconnectedMatch=c.call(e,"*"),c.call(e,"[s!='']:x"),s.push("!=",F)}),v=v.length&&new RegExp(v.join("|")),s=s.length&&new RegExp(s.join("|")),t=K.test(a.compareDocumentPosition),y=t||K.test(a.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},j=t?function(e,t){if(e===t)return l=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n||(1&(n=(e.ownerDocument||e)==(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!d.sortDetached&&t.compareDocumentPosition(e)===n?e==C||e.ownerDocument==p&&y(p,e)?-1:t==C||t.ownerDocument==p&&y(p,t)?1:u?P(u,e)-P(u,t):0:4&n?-1:1)}:function(e,t){if(e===t)return l=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e==C?-1:t==C?1:i?-1:o?1:u?P(u,e)-P(u,t):0;if(i===o)return pe(e,t);n=e;while(n=n.parentNode)a.unshift(n);n=t;while(n=n.parentNode)s.unshift(n);while(a[r]===s[r])r++;return r?pe(a[r],s[r]):a[r]==p?-1:s[r]==p?1:0}),C},se.matches=function(e,t){return se(e,null,null,t)},se.matchesSelector=function(e,t){if(T(e),d.matchesSelector&&E&&!N[t+" "]&&(!s||!s.test(t))&&(!v||!v.test(t)))try{var n=c.call(e,t);if(n||d.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(e){N(t,!0)}return 0":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(te,ne),e[3]=(e[3]||e[4]||e[5]||"").replace(te,ne),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||se.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&se.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return G.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&X.test(n)&&(t=h(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(te,ne).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=m[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&m(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(n,r,i){return function(e){var t=se.attr(e,n);return null==t?"!="===r:!r||(t+="","="===r?t===i:"!="===r?t!==i:"^="===r?i&&0===t.indexOf(i):"*="===r?i&&-1:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,n,r){return m(n)?S.grep(e,function(e,t){return!!n.call(e,t,e)!==r}):n.nodeType?S.grep(e,function(e){return e===n!==r}):"string"!=typeof n?S.grep(e,function(e){return-1)[^>]*|#([\w-]+))$/;(S.fn.init=function(e,t,n){var r,i;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(r="<"===e[0]&&">"===e[e.length-1]&&3<=e.length?[null,e,null]:q.exec(e))||!r[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r[1]){if(t=t instanceof S?t[0]:t,S.merge(this,S.parseHTML(r[1],t&&t.nodeType?t.ownerDocument||t:E,!0)),N.test(r[1])&&S.isPlainObject(t))for(r in t)m(this[r])?this[r](t[r]):this.attr(r,t[r]);return this}return(i=E.getElementById(r[2]))&&(this[0]=i,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(S):S.makeArray(e,this)}).prototype=S.fn,D=S(E);var L=/^(?:parents|prev(?:Until|All))/,H={children:!0,contents:!0,next:!0,prev:!0};function O(e,t){while((e=e[t])&&1!==e.nodeType);return e}S.fn.extend({has:function(e){var t=S(e,this),n=t.length;return this.filter(function(){for(var e=0;e\x20\t\r\n\f]*)/i,he=/^$|^module$|\/(?:java|ecma)script/i;ce=E.createDocumentFragment().appendChild(E.createElement("div")),(fe=E.createElement("input")).setAttribute("type","radio"),fe.setAttribute("checked","checked"),fe.setAttribute("name","t"),ce.appendChild(fe),y.checkClone=ce.cloneNode(!0).cloneNode(!0).lastChild.checked,ce.innerHTML="",y.noCloneChecked=!!ce.cloneNode(!0).lastChild.defaultValue,ce.innerHTML="",y.option=!!ce.lastChild;var ge={thead:[1,"","
"],col:[2,"","
"],tr:[2,"","
"],td:[3,"","
"],_default:[0,"",""]};function ve(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&A(e,t)?S.merge([e],n):n}function ye(e,t){for(var n=0,r=e.length;n",""]);var me=/<|&#?\w+;/;function xe(e,t,n,r,i){for(var o,a,s,u,l,c,f=t.createDocumentFragment(),p=[],d=0,h=e.length;d\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&S(e).children("tbody")[0]||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function qe(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Le(e,t){var n,r,i,o,a,s;if(1===t.nodeType){if(Y.hasData(e)&&(s=Y.get(e).events))for(i in Y.remove(t,"handle events"),s)for(n=0,r=s[i].length;n").attr(n.scriptAttrs||{}).prop({charset:n.scriptCharset,src:n.url}).on("load error",i=function(e){r.remove(),i=null,e&&t("error"===e.type?404:200,e.type)}),E.head.appendChild(r[0])},abort:function(){i&&i()}}});var _t,zt=[],Ut=/(=)\?(?=&|$)|\?\?/;S.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=zt.pop()||S.expando+"_"+wt.guid++;return this[e]=!0,e}}),S.ajaxPrefilter("json jsonp",function(e,t,n){var r,i,o,a=!1!==e.jsonp&&(Ut.test(e.url)?"url":"string"==typeof e.data&&0===(e.contentType||"").indexOf("application/x-www-form-urlencoded")&&Ut.test(e.data)&&"data");if(a||"jsonp"===e.dataTypes[0])return r=e.jsonpCallback=m(e.jsonpCallback)?e.jsonpCallback():e.jsonpCallback,a?e[a]=e[a].replace(Ut,"$1"+r):!1!==e.jsonp&&(e.url+=(Tt.test(e.url)?"&":"?")+e.jsonp+"="+r),e.converters["script json"]=function(){return o||S.error(r+" was not called"),o[0]},e.dataTypes[0]="json",i=C[r],C[r]=function(){o=arguments},n.always(function(){void 0===i?S(C).removeProp(r):C[r]=i,e[r]&&(e.jsonpCallback=t.jsonpCallback,zt.push(r)),o&&m(i)&&i(o[0]),o=i=void 0}),"script"}),y.createHTMLDocument=((_t=E.implementation.createHTMLDocument("").body).innerHTML="
",2===_t.childNodes.length),S.parseHTML=function(e,t,n){return"string"!=typeof e?[]:("boolean"==typeof t&&(n=t,t=!1),t||(y.createHTMLDocument?((r=(t=E.implementation.createHTMLDocument("")).createElement("base")).href=E.location.href,t.head.appendChild(r)):t=E),o=!n&&[],(i=N.exec(e))?[t.createElement(i[1])]:(i=xe([e],t,o),o&&o.length&&S(o).remove(),S.merge([],i.childNodes)));var r,i,o},S.fn.load=function(e,t,n){var r,i,o,a=this,s=e.indexOf(" ");return-1").append(S.parseHTML(e)).find(r):e)}).always(n&&function(e,t){a.each(function(){n.apply(this,o||[e.responseText,t,e])})}),this},S.expr.pseudos.animated=function(t){return S.grep(S.timers,function(e){return t===e.elem}).length},S.offset={setOffset:function(e,t,n){var r,i,o,a,s,u,l=S.css(e,"position"),c=S(e),f={};"static"===l&&(e.style.position="relative"),s=c.offset(),o=S.css(e,"top"),u=S.css(e,"left"),("absolute"===l||"fixed"===l)&&-1<(o+u).indexOf("auto")?(a=(r=c.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(u)||0),m(t)&&(t=t.call(e,n,S.extend({},s))),null!=t.top&&(f.top=t.top-s.top+a),null!=t.left&&(f.left=t.left-s.left+i),"using"in t?t.using.call(e,f):c.css(f)}},S.fn.extend({offset:function(t){if(arguments.length)return void 0===t?this:this.each(function(e){S.offset.setOffset(this,t,e)});var e,n,r=this[0];return r?r.getClientRects().length?(e=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:e.top+n.pageYOffset,left:e.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this[0]){var e,t,n,r=this[0],i={top:0,left:0};if("fixed"===S.css(r,"position"))t=r.getBoundingClientRect();else{t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;while(e&&(e===n.body||e===n.documentElement)&&"static"===S.css(e,"position"))e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=S(e).offset()).top+=S.css(e,"borderTopWidth",!0),i.left+=S.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-S.css(r,"marginTop",!0),left:t.left-i.left-S.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var e=this.offsetParent;while(e&&"static"===S.css(e,"position"))e=e.offsetParent;return e||re})}}),S.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(t,i){var o="pageYOffset"===i;S.fn[t]=function(e){return $(this,function(e,t,n){var r;if(x(e)?r=e:9===e.nodeType&&(r=e.defaultView),void 0===n)return r?r[i]:e[t];r?r.scrollTo(o?r.pageXOffset:n,o?n:r.pageYOffset):e[t]=n},t,e,arguments.length)}}),S.each(["top","left"],function(e,n){S.cssHooks[n]=Fe(y.pixelPosition,function(e,t){if(t)return t=We(e,n),Pe.test(t)?S(e).position()[n]+"px":t})}),S.each({Height:"height",Width:"width"},function(a,s){S.each({padding:"inner"+a,content:s,"":"outer"+a},function(r,o){S.fn[o]=function(e,t){var n=arguments.length&&(r||"boolean"!=typeof e),i=r||(!0===e||!0===t?"margin":"border");return $(this,function(e,t,n){var r;return x(e)?0===o.indexOf("outer")?e["inner"+a]:e.document.documentElement["client"+a]:9===e.nodeType?(r=e.documentElement,Math.max(e.body["scroll"+a],r["scroll"+a],e.body["offset"+a],r["offset"+a],r["client"+a])):void 0===n?S.css(e,t,i):S.style(e,t,n,i)},s,n?e:void 0,n)}})}),S.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(e,t){S.fn[t]=function(e){return this.on(t,e)}}),S.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)},hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),S.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,n){S.fn[n]=function(e,t){return 0"),n("table.docutils.footnote").wrap("
"),n("table.docutils.citation").wrap("
"),n(".wy-menu-vertical ul").not(".simple").siblings("a").each((function(){var t=n(this);expand=n(''),expand.on("click",(function(n){return e.toggleCurrent(t),n.stopPropagation(),!1})),t.prepend(expand)}))},reset:function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical"),t=e.find('[href="'+n+'"]');if(0===t.length){var i=$('.document [id="'+n.substring(1)+'"]').closest("div.section");0===(t=e.find('[href="#'+i.attr("id")+'"]')).length&&(t=e.find('[href="#"]'))}if(t.length>0){$(".wy-menu-vertical .current").removeClass("current").attr("aria-expanded","false"),t.addClass("current").attr("aria-expanded","true"),t.closest("li.toctree-l1").parent().addClass("current").attr("aria-expanded","true");for(let n=1;n<=10;n++)t.closest("li.toctree-l"+n).addClass("current").attr("aria-expanded","true");t[0].scrollIntoView()}}catch(n){console.log("Error expanding nav for anchor",n)}},onScroll:function(){this.winScroll=!1;var n=this.win.scrollTop(),e=n+this.winHeight,t=this.navBar.scrollTop()+(n-this.winPosition);n<0||e>this.docHeight||(this.navBar.scrollTop(t),this.winPosition=n)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",(function(){this.linkScroll=!1}))},toggleCurrent:function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current").attr("aria-expanded","false"),e.siblings().find("li.current").removeClass("current").attr("aria-expanded","false");var t=e.find("> ul li");t.length&&(t.removeClass("current").attr("aria-expanded","false"),e.toggleClass("current").attr("aria-expanded",(function(n,e){return"true"==e?"false":"true"})))}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:n.exports.ThemeNav,StickyNav:n.exports.ThemeNav}),function(){for(var n=0,e=["ms","moz","webkit","o"],t=0;t + + + + + + + To be added - Lab note for UMD BIOI611 + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+
+
+ +

To be added

+

+
+ +
+
+ +
+
+ +
+ +
+ +
+ + + + Bix4UMD/BIOI611_lab + + + + + +
+ + + + + + + + + diff --git a/ref.ipynb b/ref.ipynb new file mode 100644 index 0000000..a610add --- /dev/null +++ b/ref.ipynb @@ -0,0 +1,33 @@ +{ + "cells": [ + { + "cell_type": "code", + "execution_count": null, + "id": "cddc4857-4def-4e55-988f-43ff2d033833", + "metadata": {}, + "outputs": [], + "source": [] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.10.12" + } + }, + "nbformat": 4, + "nbformat_minor": 5 +} diff --git a/ref/index.html b/ref/index.html new file mode 100644 index 0000000..23a172e --- /dev/null +++ b/ref/index.html @@ -0,0 +1,126 @@ + + + + + + + + Ref - Lab note for UMD BIOI611 + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+
+
+ +

+
+ +
+
+ +
+
+ +
+ +
+ +
+ + + + Bix4UMD/BIOI611_lab + + + + + +
+ + + + + + + + + diff --git a/search.html b/search.html new file mode 100644 index 0000000..ac00a79 --- /dev/null +++ b/search.html @@ -0,0 +1,127 @@ + + + + + + + + Lab note for UMD BIOI611 + + + + + + + + + + + + + +
+ + +
+ +
+
+
    +
  • +
  • +
  • +
+
+
+
+
+ + +

Search Results

+ + + +
+ Searching... +
+ + +
+
+ +
+
+ +
+ +
+ +
+ + + + Bix4UMD/BIOI611_lab + + + + + +
+ + + + + + + + + diff --git a/search/lunr.js b/search/lunr.js new file mode 100644 index 0000000..aca0a16 --- /dev/null +++ b/search/lunr.js @@ -0,0 +1,3475 @@ +/** + * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 2.3.9 + * Copyright (C) 2020 Oliver Nightingale + * @license MIT + */ + +;(function(){ + +/** + * A convenience function for configuring and constructing + * a new lunr Index. + * + * A lunr.Builder instance is created and the pipeline setup + * with a trimmer, stop word filter and stemmer. + * + * This builder object is yielded to the configuration function + * that is passed as a parameter, allowing the list of fields + * and other builder parameters to be customised. + * + * All documents _must_ be added within the passed config function. + * + * @example + * var idx = lunr(function () { + * this.field('title') + * this.field('body') + * this.ref('id') + * + * documents.forEach(function (doc) { + * this.add(doc) + * }, this) + * }) + * + * @see {@link lunr.Builder} + * @see {@link lunr.Pipeline} + * @see {@link lunr.trimmer} + * @see {@link lunr.stopWordFilter} + * @see {@link lunr.stemmer} + * @namespace {function} lunr + */ +var lunr = function (config) { + var builder = new lunr.Builder + + builder.pipeline.add( + lunr.trimmer, + lunr.stopWordFilter, + lunr.stemmer + ) + + builder.searchPipeline.add( + lunr.stemmer + ) + + config.call(builder, builder) + return builder.build() +} + +lunr.version = "2.3.9" +/*! + * lunr.utils + * Copyright (C) 2020 Oliver Nightingale + */ + +/** + * A namespace containing utils for the rest of the lunr library + * @namespace lunr.utils + */ +lunr.utils = {} + +/** + * Print a warning message to the console. + * + * @param {String} message The message to be printed. + * @memberOf lunr.utils + * @function + */ +lunr.utils.warn = (function (global) { + /* eslint-disable no-console */ + return function (message) { + if (global.console && console.warn) { + console.warn(message) + } + } + /* eslint-enable no-console */ +})(this) + +/** + * Convert an object to a string. + * + * In the case of `null` and `undefined` the function returns + * the empty string, in all other cases the result of calling + * `toString` on the passed object is returned. + * + * @param {Any} obj The object to convert to a string. + * @return {String} string representation of the passed object. + * @memberOf lunr.utils + */ +lunr.utils.asString = function (obj) { + if (obj === void 0 || obj === null) { + return "" + } else { + return obj.toString() + } +} + +/** + * Clones an object. + * + * Will create a copy of an existing object such that any mutations + * on the copy cannot affect the original. + * + * Only shallow objects are supported, passing a nested object to this + * function will cause a TypeError. + * + * Objects with primitives, and arrays of primitives are supported. + * + * @param {Object} obj The object to clone. + * @return {Object} a clone of the passed object. + * @throws {TypeError} when a nested object is passed. + * @memberOf Utils + */ +lunr.utils.clone = function (obj) { + if (obj === null || obj === undefined) { + return obj + } + + var clone = Object.create(null), + keys = Object.keys(obj) + + for (var i = 0; i < keys.length; i++) { + var key = keys[i], + val = obj[key] + + if (Array.isArray(val)) { + clone[key] = val.slice() + continue + } + + if (typeof val === 'string' || + typeof val === 'number' || + typeof val === 'boolean') { + clone[key] = val + continue + } + + throw new TypeError("clone is not deep and does not support nested objects") + } + + return clone +} +lunr.FieldRef = function (docRef, fieldName, stringValue) { + this.docRef = docRef + this.fieldName = fieldName + this._stringValue = stringValue +} + +lunr.FieldRef.joiner = "/" + +lunr.FieldRef.fromString = function (s) { + var n = s.indexOf(lunr.FieldRef.joiner) + + if (n === -1) { + throw "malformed field ref string" + } + + var fieldRef = s.slice(0, n), + docRef = s.slice(n + 1) + + return new lunr.FieldRef (docRef, fieldRef, s) +} + +lunr.FieldRef.prototype.toString = function () { + if (this._stringValue == undefined) { + this._stringValue = this.fieldName + lunr.FieldRef.joiner + this.docRef + } + + return this._stringValue +} +/*! + * lunr.Set + * Copyright (C) 2020 Oliver Nightingale + */ + +/** + * A lunr set. + * + * @constructor + */ +lunr.Set = function (elements) { + this.elements = Object.create(null) + + if (elements) { + this.length = elements.length + + for (var i = 0; i < this.length; i++) { + this.elements[elements[i]] = true + } + } else { + this.length = 0 + } +} + +/** + * A complete set that contains all elements. + * + * @static + * @readonly + * @type {lunr.Set} + */ +lunr.Set.complete = { + intersect: function (other) { + return other + }, + + union: function () { + return this + }, + + contains: function () { + return true + } +} + +/** + * An empty set that contains no elements. + * + * @static + * @readonly + * @type {lunr.Set} + */ +lunr.Set.empty = { + intersect: function () { + return this + }, + + union: function (other) { + return other + }, + + contains: function () { + return false + } +} + +/** + * Returns true if this set contains the specified object. + * + * @param {object} object - Object whose presence in this set is to be tested. + * @returns {boolean} - True if this set contains the specified object. + */ +lunr.Set.prototype.contains = function (object) { + return !!this.elements[object] +} + +/** + * Returns a new set containing only the elements that are present in both + * this set and the specified set. + * + * @param {lunr.Set} other - set to intersect with this set. + * @returns {lunr.Set} a new set that is the intersection of this and the specified set. + */ + +lunr.Set.prototype.intersect = function (other) { + var a, b, elements, intersection = [] + + if (other === lunr.Set.complete) { + return this + } + + if (other === lunr.Set.empty) { + return other + } + + if (this.length < other.length) { + a = this + b = other + } else { + a = other + b = this + } + + elements = Object.keys(a.elements) + + for (var i = 0; i < elements.length; i++) { + var element = elements[i] + if (element in b.elements) { + intersection.push(element) + } + } + + return new lunr.Set (intersection) +} + +/** + * Returns a new set combining the elements of this and the specified set. + * + * @param {lunr.Set} other - set to union with this set. + * @return {lunr.Set} a new set that is the union of this and the specified set. + */ + +lunr.Set.prototype.union = function (other) { + if (other === lunr.Set.complete) { + return lunr.Set.complete + } + + if (other === lunr.Set.empty) { + return this + } + + return new lunr.Set(Object.keys(this.elements).concat(Object.keys(other.elements))) +} +/** + * A function to calculate the inverse document frequency for + * a posting. This is shared between the builder and the index + * + * @private + * @param {object} posting - The posting for a given term + * @param {number} documentCount - The total number of documents. + */ +lunr.idf = function (posting, documentCount) { + var documentsWithTerm = 0 + + for (var fieldName in posting) { + if (fieldName == '_index') continue // Ignore the term index, its not a field + documentsWithTerm += Object.keys(posting[fieldName]).length + } + + var x = (documentCount - documentsWithTerm + 0.5) / (documentsWithTerm + 0.5) + + return Math.log(1 + Math.abs(x)) +} + +/** + * A token wraps a string representation of a token + * as it is passed through the text processing pipeline. + * + * @constructor + * @param {string} [str=''] - The string token being wrapped. + * @param {object} [metadata={}] - Metadata associated with this token. + */ +lunr.Token = function (str, metadata) { + this.str = str || "" + this.metadata = metadata || {} +} + +/** + * Returns the token string that is being wrapped by this object. + * + * @returns {string} + */ +lunr.Token.prototype.toString = function () { + return this.str +} + +/** + * A token update function is used when updating or optionally + * when cloning a token. + * + * @callback lunr.Token~updateFunction + * @param {string} str - The string representation of the token. + * @param {Object} metadata - All metadata associated with this token. + */ + +/** + * Applies the given function to the wrapped string token. + * + * @example + * token.update(function (str, metadata) { + * return str.toUpperCase() + * }) + * + * @param {lunr.Token~updateFunction} fn - A function to apply to the token string. + * @returns {lunr.Token} + */ +lunr.Token.prototype.update = function (fn) { + this.str = fn(this.str, this.metadata) + return this +} + +/** + * Creates a clone of this token. Optionally a function can be + * applied to the cloned token. + * + * @param {lunr.Token~updateFunction} [fn] - An optional function to apply to the cloned token. + * @returns {lunr.Token} + */ +lunr.Token.prototype.clone = function (fn) { + fn = fn || function (s) { return s } + return new lunr.Token (fn(this.str, this.metadata), this.metadata) +} +/*! + * lunr.tokenizer + * Copyright (C) 2020 Oliver Nightingale + */ + +/** + * A function for splitting a string into tokens ready to be inserted into + * the search index. Uses `lunr.tokenizer.separator` to split strings, change + * the value of this property to change how strings are split into tokens. + * + * This tokenizer will convert its parameter to a string by calling `toString` and + * then will split this string on the character in `lunr.tokenizer.separator`. + * Arrays will have their elements converted to strings and wrapped in a lunr.Token. + * + * Optional metadata can be passed to the tokenizer, this metadata will be cloned and + * added as metadata to every token that is created from the object to be tokenized. + * + * @static + * @param {?(string|object|object[])} obj - The object to convert into tokens + * @param {?object} metadata - Optional metadata to associate with every token + * @returns {lunr.Token[]} + * @see {@link lunr.Pipeline} + */ +lunr.tokenizer = function (obj, metadata) { + if (obj == null || obj == undefined) { + return [] + } + + if (Array.isArray(obj)) { + return obj.map(function (t) { + return new lunr.Token( + lunr.utils.asString(t).toLowerCase(), + lunr.utils.clone(metadata) + ) + }) + } + + var str = obj.toString().toLowerCase(), + len = str.length, + tokens = [] + + for (var sliceEnd = 0, sliceStart = 0; sliceEnd <= len; sliceEnd++) { + var char = str.charAt(sliceEnd), + sliceLength = sliceEnd - sliceStart + + if ((char.match(lunr.tokenizer.separator) || sliceEnd == len)) { + + if (sliceLength > 0) { + var tokenMetadata = lunr.utils.clone(metadata) || {} + tokenMetadata["position"] = [sliceStart, sliceLength] + tokenMetadata["index"] = tokens.length + + tokens.push( + new lunr.Token ( + str.slice(sliceStart, sliceEnd), + tokenMetadata + ) + ) + } + + sliceStart = sliceEnd + 1 + } + + } + + return tokens +} + +/** + * The separator used to split a string into tokens. Override this property to change the behaviour of + * `lunr.tokenizer` behaviour when tokenizing strings. By default this splits on whitespace and hyphens. + * + * @static + * @see lunr.tokenizer + */ +lunr.tokenizer.separator = /[\s\-]+/ +/*! + * lunr.Pipeline + * Copyright (C) 2020 Oliver Nightingale + */ + +/** + * lunr.Pipelines maintain an ordered list of functions to be applied to all + * tokens in documents entering the search index and queries being ran against + * the index. + * + * An instance of lunr.Index created with the lunr shortcut will contain a + * pipeline with a stop word filter and an English language stemmer. Extra + * functions can be added before or after either of these functions or these + * default functions can be removed. + * + * When run the pipeline will call each function in turn, passing a token, the + * index of that token in the original list of all tokens and finally a list of + * all the original tokens. + * + * The output of functions in the pipeline will be passed to the next function + * in the pipeline. To exclude a token from entering the index the function + * should return undefined, the rest of the pipeline will not be called with + * this token. + * + * For serialisation of pipelines to work, all functions used in an instance of + * a pipeline should be registered with lunr.Pipeline. Registered functions can + * then be loaded. If trying to load a serialised pipeline that uses functions + * that are not registered an error will be thrown. + * + * If not planning on serialising the pipeline then registering pipeline functions + * is not necessary. + * + * @constructor + */ +lunr.Pipeline = function () { + this._stack = [] +} + +lunr.Pipeline.registeredFunctions = Object.create(null) + +/** + * A pipeline function maps lunr.Token to lunr.Token. A lunr.Token contains the token + * string as well as all known metadata. A pipeline function can mutate the token string + * or mutate (or add) metadata for a given token. + * + * A pipeline function can indicate that the passed token should be discarded by returning + * null, undefined or an empty string. This token will not be passed to any downstream pipeline + * functions and will not be added to the index. + * + * Multiple tokens can be returned by returning an array of tokens. Each token will be passed + * to any downstream pipeline functions and all will returned tokens will be added to the index. + * + * Any number of pipeline functions may be chained together using a lunr.Pipeline. + * + * @interface lunr.PipelineFunction + * @param {lunr.Token} token - A token from the document being processed. + * @param {number} i - The index of this token in the complete list of tokens for this document/field. + * @param {lunr.Token[]} tokens - All tokens for this document/field. + * @returns {(?lunr.Token|lunr.Token[])} + */ + +/** + * Register a function with the pipeline. + * + * Functions that are used in the pipeline should be registered if the pipeline + * needs to be serialised, or a serialised pipeline needs to be loaded. + * + * Registering a function does not add it to a pipeline, functions must still be + * added to instances of the pipeline for them to be used when running a pipeline. + * + * @param {lunr.PipelineFunction} fn - The function to check for. + * @param {String} label - The label to register this function with + */ +lunr.Pipeline.registerFunction = function (fn, label) { + if (label in this.registeredFunctions) { + lunr.utils.warn('Overwriting existing registered function: ' + label) + } + + fn.label = label + lunr.Pipeline.registeredFunctions[fn.label] = fn +} + +/** + * Warns if the function is not registered as a Pipeline function. + * + * @param {lunr.PipelineFunction} fn - The function to check for. + * @private + */ +lunr.Pipeline.warnIfFunctionNotRegistered = function (fn) { + var isRegistered = fn.label && (fn.label in this.registeredFunctions) + + if (!isRegistered) { + lunr.utils.warn('Function is not registered with pipeline. This may cause problems when serialising the index.\n', fn) + } +} + +/** + * Loads a previously serialised pipeline. + * + * All functions to be loaded must already be registered with lunr.Pipeline. + * If any function from the serialised data has not been registered then an + * error will be thrown. + * + * @param {Object} serialised - The serialised pipeline to load. + * @returns {lunr.Pipeline} + */ +lunr.Pipeline.load = function (serialised) { + var pipeline = new lunr.Pipeline + + serialised.forEach(function (fnName) { + var fn = lunr.Pipeline.registeredFunctions[fnName] + + if (fn) { + pipeline.add(fn) + } else { + throw new Error('Cannot load unregistered function: ' + fnName) + } + }) + + return pipeline +} + +/** + * Adds new functions to the end of the pipeline. + * + * Logs a warning if the function has not been registered. + * + * @param {lunr.PipelineFunction[]} functions - Any number of functions to add to the pipeline. + */ +lunr.Pipeline.prototype.add = function () { + var fns = Array.prototype.slice.call(arguments) + + fns.forEach(function (fn) { + lunr.Pipeline.warnIfFunctionNotRegistered(fn) + this._stack.push(fn) + }, this) +} + +/** + * Adds a single function after a function that already exists in the + * pipeline. + * + * Logs a warning if the function has not been registered. + * + * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline. + * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline. + */ +lunr.Pipeline.prototype.after = function (existingFn, newFn) { + lunr.Pipeline.warnIfFunctionNotRegistered(newFn) + + var pos = this._stack.indexOf(existingFn) + if (pos == -1) { + throw new Error('Cannot find existingFn') + } + + pos = pos + 1 + this._stack.splice(pos, 0, newFn) +} + +/** + * Adds a single function before a function that already exists in the + * pipeline. + * + * Logs a warning if the function has not been registered. + * + * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline. + * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline. + */ +lunr.Pipeline.prototype.before = function (existingFn, newFn) { + lunr.Pipeline.warnIfFunctionNotRegistered(newFn) + + var pos = this._stack.indexOf(existingFn) + if (pos == -1) { + throw new Error('Cannot find existingFn') + } + + this._stack.splice(pos, 0, newFn) +} + +/** + * Removes a function from the pipeline. + * + * @param {lunr.PipelineFunction} fn The function to remove from the pipeline. + */ +lunr.Pipeline.prototype.remove = function (fn) { + var pos = this._stack.indexOf(fn) + if (pos == -1) { + return + } + + this._stack.splice(pos, 1) +} + +/** + * Runs the current list of functions that make up the pipeline against the + * passed tokens. + * + * @param {Array} tokens The tokens to run through the pipeline. + * @returns {Array} + */ +lunr.Pipeline.prototype.run = function (tokens) { + var stackLength = this._stack.length + + for (var i = 0; i < stackLength; i++) { + var fn = this._stack[i] + var memo = [] + + for (var j = 0; j < tokens.length; j++) { + var result = fn(tokens[j], j, tokens) + + if (result === null || result === void 0 || result === '') continue + + if (Array.isArray(result)) { + for (var k = 0; k < result.length; k++) { + memo.push(result[k]) + } + } else { + memo.push(result) + } + } + + tokens = memo + } + + return tokens +} + +/** + * Convenience method for passing a string through a pipeline and getting + * strings out. This method takes care of wrapping the passed string in a + * token and mapping the resulting tokens back to strings. + * + * @param {string} str - The string to pass through the pipeline. + * @param {?object} metadata - Optional metadata to associate with the token + * passed to the pipeline. + * @returns {string[]} + */ +lunr.Pipeline.prototype.runString = function (str, metadata) { + var token = new lunr.Token (str, metadata) + + return this.run([token]).map(function (t) { + return t.toString() + }) +} + +/** + * Resets the pipeline by removing any existing processors. + * + */ +lunr.Pipeline.prototype.reset = function () { + this._stack = [] +} + +/** + * Returns a representation of the pipeline ready for serialisation. + * + * Logs a warning if the function has not been registered. + * + * @returns {Array} + */ +lunr.Pipeline.prototype.toJSON = function () { + return this._stack.map(function (fn) { + lunr.Pipeline.warnIfFunctionNotRegistered(fn) + + return fn.label + }) +} +/*! + * lunr.Vector + * Copyright (C) 2020 Oliver Nightingale + */ + +/** + * A vector is used to construct the vector space of documents and queries. These + * vectors support operations to determine the similarity between two documents or + * a document and a query. + * + * Normally no parameters are required for initializing a vector, but in the case of + * loading a previously dumped vector the raw elements can be provided to the constructor. + * + * For performance reasons vectors are implemented with a flat array, where an elements + * index is immediately followed by its value. E.g. [index, value, index, value]. This + * allows the underlying array to be as sparse as possible and still offer decent + * performance when being used for vector calculations. + * + * @constructor + * @param {Number[]} [elements] - The flat list of element index and element value pairs. + */ +lunr.Vector = function (elements) { + this._magnitude = 0 + this.elements = elements || [] +} + + +/** + * Calculates the position within the vector to insert a given index. + * + * This is used internally by insert and upsert. If there are duplicate indexes then + * the position is returned as if the value for that index were to be updated, but it + * is the callers responsibility to check whether there is a duplicate at that index + * + * @param {Number} insertIdx - The index at which the element should be inserted. + * @returns {Number} + */ +lunr.Vector.prototype.positionForIndex = function (index) { + // For an empty vector the tuple can be inserted at the beginning + if (this.elements.length == 0) { + return 0 + } + + var start = 0, + end = this.elements.length / 2, + sliceLength = end - start, + pivotPoint = Math.floor(sliceLength / 2), + pivotIndex = this.elements[pivotPoint * 2] + + while (sliceLength > 1) { + if (pivotIndex < index) { + start = pivotPoint + } + + if (pivotIndex > index) { + end = pivotPoint + } + + if (pivotIndex == index) { + break + } + + sliceLength = end - start + pivotPoint = start + Math.floor(sliceLength / 2) + pivotIndex = this.elements[pivotPoint * 2] + } + + if (pivotIndex == index) { + return pivotPoint * 2 + } + + if (pivotIndex > index) { + return pivotPoint * 2 + } + + if (pivotIndex < index) { + return (pivotPoint + 1) * 2 + } +} + +/** + * Inserts an element at an index within the vector. + * + * Does not allow duplicates, will throw an error if there is already an entry + * for this index. + * + * @param {Number} insertIdx - The index at which the element should be inserted. + * @param {Number} val - The value to be inserted into the vector. + */ +lunr.Vector.prototype.insert = function (insertIdx, val) { + this.upsert(insertIdx, val, function () { + throw "duplicate index" + }) +} + +/** + * Inserts or updates an existing index within the vector. + * + * @param {Number} insertIdx - The index at which the element should be inserted. + * @param {Number} val - The value to be inserted into the vector. + * @param {function} fn - A function that is called for updates, the existing value and the + * requested value are passed as arguments + */ +lunr.Vector.prototype.upsert = function (insertIdx, val, fn) { + this._magnitude = 0 + var position = this.positionForIndex(insertIdx) + + if (this.elements[position] == insertIdx) { + this.elements[position + 1] = fn(this.elements[position + 1], val) + } else { + this.elements.splice(position, 0, insertIdx, val) + } +} + +/** + * Calculates the magnitude of this vector. + * + * @returns {Number} + */ +lunr.Vector.prototype.magnitude = function () { + if (this._magnitude) return this._magnitude + + var sumOfSquares = 0, + elementsLength = this.elements.length + + for (var i = 1; i < elementsLength; i += 2) { + var val = this.elements[i] + sumOfSquares += val * val + } + + return this._magnitude = Math.sqrt(sumOfSquares) +} + +/** + * Calculates the dot product of this vector and another vector. + * + * @param {lunr.Vector} otherVector - The vector to compute the dot product with. + * @returns {Number} + */ +lunr.Vector.prototype.dot = function (otherVector) { + var dotProduct = 0, + a = this.elements, b = otherVector.elements, + aLen = a.length, bLen = b.length, + aVal = 0, bVal = 0, + i = 0, j = 0 + + while (i < aLen && j < bLen) { + aVal = a[i], bVal = b[j] + if (aVal < bVal) { + i += 2 + } else if (aVal > bVal) { + j += 2 + } else if (aVal == bVal) { + dotProduct += a[i + 1] * b[j + 1] + i += 2 + j += 2 + } + } + + return dotProduct +} + +/** + * Calculates the similarity between this vector and another vector. + * + * @param {lunr.Vector} otherVector - The other vector to calculate the + * similarity with. + * @returns {Number} + */ +lunr.Vector.prototype.similarity = function (otherVector) { + return this.dot(otherVector) / this.magnitude() || 0 +} + +/** + * Converts the vector to an array of the elements within the vector. + * + * @returns {Number[]} + */ +lunr.Vector.prototype.toArray = function () { + var output = new Array (this.elements.length / 2) + + for (var i = 1, j = 0; i < this.elements.length; i += 2, j++) { + output[j] = this.elements[i] + } + + return output +} + +/** + * A JSON serializable representation of the vector. + * + * @returns {Number[]} + */ +lunr.Vector.prototype.toJSON = function () { + return this.elements +} +/* eslint-disable */ +/*! + * lunr.stemmer + * Copyright (C) 2020 Oliver Nightingale + * Includes code from - http://tartarus.org/~martin/PorterStemmer/js.txt + */ + +/** + * lunr.stemmer is an english language stemmer, this is a JavaScript + * implementation of the PorterStemmer taken from http://tartarus.org/~martin + * + * @static + * @implements {lunr.PipelineFunction} + * @param {lunr.Token} token - The string to stem + * @returns {lunr.Token} + * @see {@link lunr.Pipeline} + * @function + */ +lunr.stemmer = (function(){ + var step2list = { + "ational" : "ate", + "tional" : "tion", + "enci" : "ence", + "anci" : "ance", + "izer" : "ize", + "bli" : "ble", + "alli" : "al", + "entli" : "ent", + "eli" : "e", + "ousli" : "ous", + "ization" : "ize", + "ation" : "ate", + "ator" : "ate", + "alism" : "al", + "iveness" : "ive", + "fulness" : "ful", + "ousness" : "ous", + "aliti" : "al", + "iviti" : "ive", + "biliti" : "ble", + "logi" : "log" + }, + + step3list = { + "icate" : "ic", + "ative" : "", + "alize" : "al", + "iciti" : "ic", + "ical" : "ic", + "ful" : "", + "ness" : "" + }, + + c = "[^aeiou]", // consonant + v = "[aeiouy]", // vowel + C = c + "[^aeiouy]*", // consonant sequence + V = v + "[aeiou]*", // vowel sequence + + mgr0 = "^(" + C + ")?" + V + C, // [C]VC... is m>0 + meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$", // [C]VC[V] is m=1 + mgr1 = "^(" + C + ")?" + V + C + V + C, // [C]VCVC... is m>1 + s_v = "^(" + C + ")?" + v; // vowel in stem + + var re_mgr0 = new RegExp(mgr0); + var re_mgr1 = new RegExp(mgr1); + var re_meq1 = new RegExp(meq1); + var re_s_v = new RegExp(s_v); + + var re_1a = /^(.+?)(ss|i)es$/; + var re2_1a = /^(.+?)([^s])s$/; + var re_1b = /^(.+?)eed$/; + var re2_1b = /^(.+?)(ed|ing)$/; + var re_1b_2 = /.$/; + var re2_1b_2 = /(at|bl|iz)$/; + var re3_1b_2 = new RegExp("([^aeiouylsz])\\1$"); + var re4_1b_2 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + + var re_1c = /^(.+?[^aeiou])y$/; + var re_2 = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; + + var re_3 = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; + + var re_4 = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; + var re2_4 = /^(.+?)(s|t)(ion)$/; + + var re_5 = /^(.+?)e$/; + var re_5_1 = /ll$/; + var re3_5 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + + var porterStemmer = function porterStemmer(w) { + var stem, + suffix, + firstch, + re, + re2, + re3, + re4; + + if (w.length < 3) { return w; } + + firstch = w.substr(0,1); + if (firstch == "y") { + w = firstch.toUpperCase() + w.substr(1); + } + + // Step 1a + re = re_1a + re2 = re2_1a; + + if (re.test(w)) { w = w.replace(re,"$1$2"); } + else if (re2.test(w)) { w = w.replace(re2,"$1$2"); } + + // Step 1b + re = re_1b; + re2 = re2_1b; + if (re.test(w)) { + var fp = re.exec(w); + re = re_mgr0; + if (re.test(fp[1])) { + re = re_1b_2; + w = w.replace(re,""); + } + } else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1]; + re2 = re_s_v; + if (re2.test(stem)) { + w = stem; + re2 = re2_1b_2; + re3 = re3_1b_2; + re4 = re4_1b_2; + if (re2.test(w)) { w = w + "e"; } + else if (re3.test(w)) { re = re_1b_2; w = w.replace(re,""); } + else if (re4.test(w)) { w = w + "e"; } + } + } + + // Step 1c - replace suffix y or Y by i if preceded by a non-vowel which is not the first letter of the word (so cry -> cri, by -> by, say -> say) + re = re_1c; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + w = stem + "i"; + } + + // Step 2 + re = re_2; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = re_mgr0; + if (re.test(stem)) { + w = stem + step2list[suffix]; + } + } + + // Step 3 + re = re_3; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = re_mgr0; + if (re.test(stem)) { + w = stem + step3list[suffix]; + } + } + + // Step 4 + re = re_4; + re2 = re2_4; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = re_mgr1; + if (re.test(stem)) { + w = stem; + } + } else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1] + fp[2]; + re2 = re_mgr1; + if (re2.test(stem)) { + w = stem; + } + } + + // Step 5 + re = re_5; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = re_mgr1; + re2 = re_meq1; + re3 = re3_5; + if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) { + w = stem; + } + } + + re = re_5_1; + re2 = re_mgr1; + if (re.test(w) && re2.test(w)) { + re = re_1b_2; + w = w.replace(re,""); + } + + // and turn initial Y back to y + + if (firstch == "y") { + w = firstch.toLowerCase() + w.substr(1); + } + + return w; + }; + + return function (token) { + return token.update(porterStemmer); + } +})(); + +lunr.Pipeline.registerFunction(lunr.stemmer, 'stemmer') +/*! + * lunr.stopWordFilter + * Copyright (C) 2020 Oliver Nightingale + */ + +/** + * lunr.generateStopWordFilter builds a stopWordFilter function from the provided + * list of stop words. + * + * The built in lunr.stopWordFilter is built using this generator and can be used + * to generate custom stopWordFilters for applications or non English languages. + * + * @function + * @param {Array} token The token to pass through the filter + * @returns {lunr.PipelineFunction} + * @see lunr.Pipeline + * @see lunr.stopWordFilter + */ +lunr.generateStopWordFilter = function (stopWords) { + var words = stopWords.reduce(function (memo, stopWord) { + memo[stopWord] = stopWord + return memo + }, {}) + + return function (token) { + if (token && words[token.toString()] !== token.toString()) return token + } +} + +/** + * lunr.stopWordFilter is an English language stop word list filter, any words + * contained in the list will not be passed through the filter. + * + * This is intended to be used in the Pipeline. If the token does not pass the + * filter then undefined will be returned. + * + * @function + * @implements {lunr.PipelineFunction} + * @params {lunr.Token} token - A token to check for being a stop word. + * @returns {lunr.Token} + * @see {@link lunr.Pipeline} + */ +lunr.stopWordFilter = lunr.generateStopWordFilter([ + 'a', + 'able', + 'about', + 'across', + 'after', + 'all', + 'almost', + 'also', + 'am', + 'among', + 'an', + 'and', + 'any', + 'are', + 'as', + 'at', + 'be', + 'because', + 'been', + 'but', + 'by', + 'can', + 'cannot', + 'could', + 'dear', + 'did', + 'do', + 'does', + 'either', + 'else', + 'ever', + 'every', + 'for', + 'from', + 'get', + 'got', + 'had', + 'has', + 'have', + 'he', + 'her', + 'hers', + 'him', + 'his', + 'how', + 'however', + 'i', + 'if', + 'in', + 'into', + 'is', + 'it', + 'its', + 'just', + 'least', + 'let', + 'like', + 'likely', + 'may', + 'me', + 'might', + 'most', + 'must', + 'my', + 'neither', + 'no', + 'nor', + 'not', + 'of', + 'off', + 'often', + 'on', + 'only', + 'or', + 'other', + 'our', + 'own', + 'rather', + 'said', + 'say', + 'says', + 'she', + 'should', + 'since', + 'so', + 'some', + 'than', + 'that', + 'the', + 'their', + 'them', + 'then', + 'there', + 'these', + 'they', + 'this', + 'tis', + 'to', + 'too', + 'twas', + 'us', + 'wants', + 'was', + 'we', + 'were', + 'what', + 'when', + 'where', + 'which', + 'while', + 'who', + 'whom', + 'why', + 'will', + 'with', + 'would', + 'yet', + 'you', + 'your' +]) + +lunr.Pipeline.registerFunction(lunr.stopWordFilter, 'stopWordFilter') +/*! + * lunr.trimmer + * Copyright (C) 2020 Oliver Nightingale + */ + +/** + * lunr.trimmer is a pipeline function for trimming non word + * characters from the beginning and end of tokens before they + * enter the index. + * + * This implementation may not work correctly for non latin + * characters and should either be removed or adapted for use + * with languages with non-latin characters. + * + * @static + * @implements {lunr.PipelineFunction} + * @param {lunr.Token} token The token to pass through the filter + * @returns {lunr.Token} + * @see lunr.Pipeline + */ +lunr.trimmer = function (token) { + return token.update(function (s) { + return s.replace(/^\W+/, '').replace(/\W+$/, '') + }) +} + +lunr.Pipeline.registerFunction(lunr.trimmer, 'trimmer') +/*! + * lunr.TokenSet + * Copyright (C) 2020 Oliver Nightingale + */ + +/** + * A token set is used to store the unique list of all tokens + * within an index. Token sets are also used to represent an + * incoming query to the index, this query token set and index + * token set are then intersected to find which tokens to look + * up in the inverted index. + * + * A token set can hold multiple tokens, as in the case of the + * index token set, or it can hold a single token as in the + * case of a simple query token set. + * + * Additionally token sets are used to perform wildcard matching. + * Leading, contained and trailing wildcards are supported, and + * from this edit distance matching can also be provided. + * + * Token sets are implemented as a minimal finite state automata, + * where both common prefixes and suffixes are shared between tokens. + * This helps to reduce the space used for storing the token set. + * + * @constructor + */ +lunr.TokenSet = function () { + this.final = false + this.edges = {} + this.id = lunr.TokenSet._nextId + lunr.TokenSet._nextId += 1 +} + +/** + * Keeps track of the next, auto increment, identifier to assign + * to a new tokenSet. + * + * TokenSets require a unique identifier to be correctly minimised. + * + * @private + */ +lunr.TokenSet._nextId = 1 + +/** + * Creates a TokenSet instance from the given sorted array of words. + * + * @param {String[]} arr - A sorted array of strings to create the set from. + * @returns {lunr.TokenSet} + * @throws Will throw an error if the input array is not sorted. + */ +lunr.TokenSet.fromArray = function (arr) { + var builder = new lunr.TokenSet.Builder + + for (var i = 0, len = arr.length; i < len; i++) { + builder.insert(arr[i]) + } + + builder.finish() + return builder.root +} + +/** + * Creates a token set from a query clause. + * + * @private + * @param {Object} clause - A single clause from lunr.Query. + * @param {string} clause.term - The query clause term. + * @param {number} [clause.editDistance] - The optional edit distance for the term. + * @returns {lunr.TokenSet} + */ +lunr.TokenSet.fromClause = function (clause) { + if ('editDistance' in clause) { + return lunr.TokenSet.fromFuzzyString(clause.term, clause.editDistance) + } else { + return lunr.TokenSet.fromString(clause.term) + } +} + +/** + * Creates a token set representing a single string with a specified + * edit distance. + * + * Insertions, deletions, substitutions and transpositions are each + * treated as an edit distance of 1. + * + * Increasing the allowed edit distance will have a dramatic impact + * on the performance of both creating and intersecting these TokenSets. + * It is advised to keep the edit distance less than 3. + * + * @param {string} str - The string to create the token set from. + * @param {number} editDistance - The allowed edit distance to match. + * @returns {lunr.Vector} + */ +lunr.TokenSet.fromFuzzyString = function (str, editDistance) { + var root = new lunr.TokenSet + + var stack = [{ + node: root, + editsRemaining: editDistance, + str: str + }] + + while (stack.length) { + var frame = stack.pop() + + // no edit + if (frame.str.length > 0) { + var char = frame.str.charAt(0), + noEditNode + + if (char in frame.node.edges) { + noEditNode = frame.node.edges[char] + } else { + noEditNode = new lunr.TokenSet + frame.node.edges[char] = noEditNode + } + + if (frame.str.length == 1) { + noEditNode.final = true + } + + stack.push({ + node: noEditNode, + editsRemaining: frame.editsRemaining, + str: frame.str.slice(1) + }) + } + + if (frame.editsRemaining == 0) { + continue + } + + // insertion + if ("*" in frame.node.edges) { + var insertionNode = frame.node.edges["*"] + } else { + var insertionNode = new lunr.TokenSet + frame.node.edges["*"] = insertionNode + } + + if (frame.str.length == 0) { + insertionNode.final = true + } + + stack.push({ + node: insertionNode, + editsRemaining: frame.editsRemaining - 1, + str: frame.str + }) + + // deletion + // can only do a deletion if we have enough edits remaining + // and if there are characters left to delete in the string + if (frame.str.length > 1) { + stack.push({ + node: frame.node, + editsRemaining: frame.editsRemaining - 1, + str: frame.str.slice(1) + }) + } + + // deletion + // just removing the last character from the str + if (frame.str.length == 1) { + frame.node.final = true + } + + // substitution + // can only do a substitution if we have enough edits remaining + // and if there are characters left to substitute + if (frame.str.length >= 1) { + if ("*" in frame.node.edges) { + var substitutionNode = frame.node.edges["*"] + } else { + var substitutionNode = new lunr.TokenSet + frame.node.edges["*"] = substitutionNode + } + + if (frame.str.length == 1) { + substitutionNode.final = true + } + + stack.push({ + node: substitutionNode, + editsRemaining: frame.editsRemaining - 1, + str: frame.str.slice(1) + }) + } + + // transposition + // can only do a transposition if there are edits remaining + // and there are enough characters to transpose + if (frame.str.length > 1) { + var charA = frame.str.charAt(0), + charB = frame.str.charAt(1), + transposeNode + + if (charB in frame.node.edges) { + transposeNode = frame.node.edges[charB] + } else { + transposeNode = new lunr.TokenSet + frame.node.edges[charB] = transposeNode + } + + if (frame.str.length == 1) { + transposeNode.final = true + } + + stack.push({ + node: transposeNode, + editsRemaining: frame.editsRemaining - 1, + str: charA + frame.str.slice(2) + }) + } + } + + return root +} + +/** + * Creates a TokenSet from a string. + * + * The string may contain one or more wildcard characters (*) + * that will allow wildcard matching when intersecting with + * another TokenSet. + * + * @param {string} str - The string to create a TokenSet from. + * @returns {lunr.TokenSet} + */ +lunr.TokenSet.fromString = function (str) { + var node = new lunr.TokenSet, + root = node + + /* + * Iterates through all characters within the passed string + * appending a node for each character. + * + * When a wildcard character is found then a self + * referencing edge is introduced to continually match + * any number of any characters. + */ + for (var i = 0, len = str.length; i < len; i++) { + var char = str[i], + final = (i == len - 1) + + if (char == "*") { + node.edges[char] = node + node.final = final + + } else { + var next = new lunr.TokenSet + next.final = final + + node.edges[char] = next + node = next + } + } + + return root +} + +/** + * Converts this TokenSet into an array of strings + * contained within the TokenSet. + * + * This is not intended to be used on a TokenSet that + * contains wildcards, in these cases the results are + * undefined and are likely to cause an infinite loop. + * + * @returns {string[]} + */ +lunr.TokenSet.prototype.toArray = function () { + var words = [] + + var stack = [{ + prefix: "", + node: this + }] + + while (stack.length) { + var frame = stack.pop(), + edges = Object.keys(frame.node.edges), + len = edges.length + + if (frame.node.final) { + /* In Safari, at this point the prefix is sometimes corrupted, see: + * https://github.com/olivernn/lunr.js/issues/279 Calling any + * String.prototype method forces Safari to "cast" this string to what + * it's supposed to be, fixing the bug. */ + frame.prefix.charAt(0) + words.push(frame.prefix) + } + + for (var i = 0; i < len; i++) { + var edge = edges[i] + + stack.push({ + prefix: frame.prefix.concat(edge), + node: frame.node.edges[edge] + }) + } + } + + return words +} + +/** + * Generates a string representation of a TokenSet. + * + * This is intended to allow TokenSets to be used as keys + * in objects, largely to aid the construction and minimisation + * of a TokenSet. As such it is not designed to be a human + * friendly representation of the TokenSet. + * + * @returns {string} + */ +lunr.TokenSet.prototype.toString = function () { + // NOTE: Using Object.keys here as this.edges is very likely + // to enter 'hash-mode' with many keys being added + // + // avoiding a for-in loop here as it leads to the function + // being de-optimised (at least in V8). From some simple + // benchmarks the performance is comparable, but allowing + // V8 to optimize may mean easy performance wins in the future. + + if (this._str) { + return this._str + } + + var str = this.final ? '1' : '0', + labels = Object.keys(this.edges).sort(), + len = labels.length + + for (var i = 0; i < len; i++) { + var label = labels[i], + node = this.edges[label] + + str = str + label + node.id + } + + return str +} + +/** + * Returns a new TokenSet that is the intersection of + * this TokenSet and the passed TokenSet. + * + * This intersection will take into account any wildcards + * contained within the TokenSet. + * + * @param {lunr.TokenSet} b - An other TokenSet to intersect with. + * @returns {lunr.TokenSet} + */ +lunr.TokenSet.prototype.intersect = function (b) { + var output = new lunr.TokenSet, + frame = undefined + + var stack = [{ + qNode: b, + output: output, + node: this + }] + + while (stack.length) { + frame = stack.pop() + + // NOTE: As with the #toString method, we are using + // Object.keys and a for loop instead of a for-in loop + // as both of these objects enter 'hash' mode, causing + // the function to be de-optimised in V8 + var qEdges = Object.keys(frame.qNode.edges), + qLen = qEdges.length, + nEdges = Object.keys(frame.node.edges), + nLen = nEdges.length + + for (var q = 0; q < qLen; q++) { + var qEdge = qEdges[q] + + for (var n = 0; n < nLen; n++) { + var nEdge = nEdges[n] + + if (nEdge == qEdge || qEdge == '*') { + var node = frame.node.edges[nEdge], + qNode = frame.qNode.edges[qEdge], + final = node.final && qNode.final, + next = undefined + + if (nEdge in frame.output.edges) { + // an edge already exists for this character + // no need to create a new node, just set the finality + // bit unless this node is already final + next = frame.output.edges[nEdge] + next.final = next.final || final + + } else { + // no edge exists yet, must create one + // set the finality bit and insert it + // into the output + next = new lunr.TokenSet + next.final = final + frame.output.edges[nEdge] = next + } + + stack.push({ + qNode: qNode, + output: next, + node: node + }) + } + } + } + } + + return output +} +lunr.TokenSet.Builder = function () { + this.previousWord = "" + this.root = new lunr.TokenSet + this.uncheckedNodes = [] + this.minimizedNodes = {} +} + +lunr.TokenSet.Builder.prototype.insert = function (word) { + var node, + commonPrefix = 0 + + if (word < this.previousWord) { + throw new Error ("Out of order word insertion") + } + + for (var i = 0; i < word.length && i < this.previousWord.length; i++) { + if (word[i] != this.previousWord[i]) break + commonPrefix++ + } + + this.minimize(commonPrefix) + + if (this.uncheckedNodes.length == 0) { + node = this.root + } else { + node = this.uncheckedNodes[this.uncheckedNodes.length - 1].child + } + + for (var i = commonPrefix; i < word.length; i++) { + var nextNode = new lunr.TokenSet, + char = word[i] + + node.edges[char] = nextNode + + this.uncheckedNodes.push({ + parent: node, + char: char, + child: nextNode + }) + + node = nextNode + } + + node.final = true + this.previousWord = word +} + +lunr.TokenSet.Builder.prototype.finish = function () { + this.minimize(0) +} + +lunr.TokenSet.Builder.prototype.minimize = function (downTo) { + for (var i = this.uncheckedNodes.length - 1; i >= downTo; i--) { + var node = this.uncheckedNodes[i], + childKey = node.child.toString() + + if (childKey in this.minimizedNodes) { + node.parent.edges[node.char] = this.minimizedNodes[childKey] + } else { + // Cache the key for this node since + // we know it can't change anymore + node.child._str = childKey + + this.minimizedNodes[childKey] = node.child + } + + this.uncheckedNodes.pop() + } +} +/*! + * lunr.Index + * Copyright (C) 2020 Oliver Nightingale + */ + +/** + * An index contains the built index of all documents and provides a query interface + * to the index. + * + * Usually instances of lunr.Index will not be created using this constructor, instead + * lunr.Builder should be used to construct new indexes, or lunr.Index.load should be + * used to load previously built and serialized indexes. + * + * @constructor + * @param {Object} attrs - The attributes of the built search index. + * @param {Object} attrs.invertedIndex - An index of term/field to document reference. + * @param {Object} attrs.fieldVectors - Field vectors + * @param {lunr.TokenSet} attrs.tokenSet - An set of all corpus tokens. + * @param {string[]} attrs.fields - The names of indexed document fields. + * @param {lunr.Pipeline} attrs.pipeline - The pipeline to use for search terms. + */ +lunr.Index = function (attrs) { + this.invertedIndex = attrs.invertedIndex + this.fieldVectors = attrs.fieldVectors + this.tokenSet = attrs.tokenSet + this.fields = attrs.fields + this.pipeline = attrs.pipeline +} + +/** + * A result contains details of a document matching a search query. + * @typedef {Object} lunr.Index~Result + * @property {string} ref - The reference of the document this result represents. + * @property {number} score - A number between 0 and 1 representing how similar this document is to the query. + * @property {lunr.MatchData} matchData - Contains metadata about this match including which term(s) caused the match. + */ + +/** + * Although lunr provides the ability to create queries using lunr.Query, it also provides a simple + * query language which itself is parsed into an instance of lunr.Query. + * + * For programmatically building queries it is advised to directly use lunr.Query, the query language + * is best used for human entered text rather than program generated text. + * + * At its simplest queries can just be a single term, e.g. `hello`, multiple terms are also supported + * and will be combined with OR, e.g `hello world` will match documents that contain either 'hello' + * or 'world', though those that contain both will rank higher in the results. + * + * Wildcards can be included in terms to match one or more unspecified characters, these wildcards can + * be inserted anywhere within the term, and more than one wildcard can exist in a single term. Adding + * wildcards will increase the number of documents that will be found but can also have a negative + * impact on query performance, especially with wildcards at the beginning of a term. + * + * Terms can be restricted to specific fields, e.g. `title:hello`, only documents with the term + * hello in the title field will match this query. Using a field not present in the index will lead + * to an error being thrown. + * + * Modifiers can also be added to terms, lunr supports edit distance and boost modifiers on terms. A term + * boost will make documents matching that term score higher, e.g. `foo^5`. Edit distance is also supported + * to provide fuzzy matching, e.g. 'hello~2' will match documents with hello with an edit distance of 2. + * Avoid large values for edit distance to improve query performance. + * + * Each term also supports a presence modifier. By default a term's presence in document is optional, however + * this can be changed to either required or prohibited. For a term's presence to be required in a document the + * term should be prefixed with a '+', e.g. `+foo bar` is a search for documents that must contain 'foo' and + * optionally contain 'bar'. Conversely a leading '-' sets the terms presence to prohibited, i.e. it must not + * appear in a document, e.g. `-foo bar` is a search for documents that do not contain 'foo' but may contain 'bar'. + * + * To escape special characters the backslash character '\' can be used, this allows searches to include + * characters that would normally be considered modifiers, e.g. `foo\~2` will search for a term "foo~2" instead + * of attempting to apply a boost of 2 to the search term "foo". + * + * @typedef {string} lunr.Index~QueryString + * @example Simple single term query + * hello + * @example Multiple term query + * hello world + * @example term scoped to a field + * title:hello + * @example term with a boost of 10 + * hello^10 + * @example term with an edit distance of 2 + * hello~2 + * @example terms with presence modifiers + * -foo +bar baz + */ + +/** + * Performs a search against the index using lunr query syntax. + * + * Results will be returned sorted by their score, the most relevant results + * will be returned first. For details on how the score is calculated, please see + * the {@link https://lunrjs.com/guides/searching.html#scoring|guide}. + * + * For more programmatic querying use lunr.Index#query. + * + * @param {lunr.Index~QueryString} queryString - A string containing a lunr query. + * @throws {lunr.QueryParseError} If the passed query string cannot be parsed. + * @returns {lunr.Index~Result[]} + */ +lunr.Index.prototype.search = function (queryString) { + return this.query(function (query) { + var parser = new lunr.QueryParser(queryString, query) + parser.parse() + }) +} + +/** + * A query builder callback provides a query object to be used to express + * the query to perform on the index. + * + * @callback lunr.Index~queryBuilder + * @param {lunr.Query} query - The query object to build up. + * @this lunr.Query + */ + +/** + * Performs a query against the index using the yielded lunr.Query object. + * + * If performing programmatic queries against the index, this method is preferred + * over lunr.Index#search so as to avoid the additional query parsing overhead. + * + * A query object is yielded to the supplied function which should be used to + * express the query to be run against the index. + * + * Note that although this function takes a callback parameter it is _not_ an + * asynchronous operation, the callback is just yielded a query object to be + * customized. + * + * @param {lunr.Index~queryBuilder} fn - A function that is used to build the query. + * @returns {lunr.Index~Result[]} + */ +lunr.Index.prototype.query = function (fn) { + // for each query clause + // * process terms + // * expand terms from token set + // * find matching documents and metadata + // * get document vectors + // * score documents + + var query = new lunr.Query(this.fields), + matchingFields = Object.create(null), + queryVectors = Object.create(null), + termFieldCache = Object.create(null), + requiredMatches = Object.create(null), + prohibitedMatches = Object.create(null) + + /* + * To support field level boosts a query vector is created per + * field. An empty vector is eagerly created to support negated + * queries. + */ + for (var i = 0; i < this.fields.length; i++) { + queryVectors[this.fields[i]] = new lunr.Vector + } + + fn.call(query, query) + + for (var i = 0; i < query.clauses.length; i++) { + /* + * Unless the pipeline has been disabled for this term, which is + * the case for terms with wildcards, we need to pass the clause + * term through the search pipeline. A pipeline returns an array + * of processed terms. Pipeline functions may expand the passed + * term, which means we may end up performing multiple index lookups + * for a single query term. + */ + var clause = query.clauses[i], + terms = null, + clauseMatches = lunr.Set.empty + + if (clause.usePipeline) { + terms = this.pipeline.runString(clause.term, { + fields: clause.fields + }) + } else { + terms = [clause.term] + } + + for (var m = 0; m < terms.length; m++) { + var term = terms[m] + + /* + * Each term returned from the pipeline needs to use the same query + * clause object, e.g. the same boost and or edit distance. The + * simplest way to do this is to re-use the clause object but mutate + * its term property. + */ + clause.term = term + + /* + * From the term in the clause we create a token set which will then + * be used to intersect the indexes token set to get a list of terms + * to lookup in the inverted index + */ + var termTokenSet = lunr.TokenSet.fromClause(clause), + expandedTerms = this.tokenSet.intersect(termTokenSet).toArray() + + /* + * If a term marked as required does not exist in the tokenSet it is + * impossible for the search to return any matches. We set all the field + * scoped required matches set to empty and stop examining any further + * clauses. + */ + if (expandedTerms.length === 0 && clause.presence === lunr.Query.presence.REQUIRED) { + for (var k = 0; k < clause.fields.length; k++) { + var field = clause.fields[k] + requiredMatches[field] = lunr.Set.empty + } + + break + } + + for (var j = 0; j < expandedTerms.length; j++) { + /* + * For each term get the posting and termIndex, this is required for + * building the query vector. + */ + var expandedTerm = expandedTerms[j], + posting = this.invertedIndex[expandedTerm], + termIndex = posting._index + + for (var k = 0; k < clause.fields.length; k++) { + /* + * For each field that this query term is scoped by (by default + * all fields are in scope) we need to get all the document refs + * that have this term in that field. + * + * The posting is the entry in the invertedIndex for the matching + * term from above. + */ + var field = clause.fields[k], + fieldPosting = posting[field], + matchingDocumentRefs = Object.keys(fieldPosting), + termField = expandedTerm + "/" + field, + matchingDocumentsSet = new lunr.Set(matchingDocumentRefs) + + /* + * if the presence of this term is required ensure that the matching + * documents are added to the set of required matches for this clause. + * + */ + if (clause.presence == lunr.Query.presence.REQUIRED) { + clauseMatches = clauseMatches.union(matchingDocumentsSet) + + if (requiredMatches[field] === undefined) { + requiredMatches[field] = lunr.Set.complete + } + } + + /* + * if the presence of this term is prohibited ensure that the matching + * documents are added to the set of prohibited matches for this field, + * creating that set if it does not yet exist. + */ + if (clause.presence == lunr.Query.presence.PROHIBITED) { + if (prohibitedMatches[field] === undefined) { + prohibitedMatches[field] = lunr.Set.empty + } + + prohibitedMatches[field] = prohibitedMatches[field].union(matchingDocumentsSet) + + /* + * Prohibited matches should not be part of the query vector used for + * similarity scoring and no metadata should be extracted so we continue + * to the next field + */ + continue + } + + /* + * The query field vector is populated using the termIndex found for + * the term and a unit value with the appropriate boost applied. + * Using upsert because there could already be an entry in the vector + * for the term we are working with. In that case we just add the scores + * together. + */ + queryVectors[field].upsert(termIndex, clause.boost, function (a, b) { return a + b }) + + /** + * If we've already seen this term, field combo then we've already collected + * the matching documents and metadata, no need to go through all that again + */ + if (termFieldCache[termField]) { + continue + } + + for (var l = 0; l < matchingDocumentRefs.length; l++) { + /* + * All metadata for this term/field/document triple + * are then extracted and collected into an instance + * of lunr.MatchData ready to be returned in the query + * results + */ + var matchingDocumentRef = matchingDocumentRefs[l], + matchingFieldRef = new lunr.FieldRef (matchingDocumentRef, field), + metadata = fieldPosting[matchingDocumentRef], + fieldMatch + + if ((fieldMatch = matchingFields[matchingFieldRef]) === undefined) { + matchingFields[matchingFieldRef] = new lunr.MatchData (expandedTerm, field, metadata) + } else { + fieldMatch.add(expandedTerm, field, metadata) + } + + } + + termFieldCache[termField] = true + } + } + } + + /** + * If the presence was required we need to update the requiredMatches field sets. + * We do this after all fields for the term have collected their matches because + * the clause terms presence is required in _any_ of the fields not _all_ of the + * fields. + */ + if (clause.presence === lunr.Query.presence.REQUIRED) { + for (var k = 0; k < clause.fields.length; k++) { + var field = clause.fields[k] + requiredMatches[field] = requiredMatches[field].intersect(clauseMatches) + } + } + } + + /** + * Need to combine the field scoped required and prohibited + * matching documents into a global set of required and prohibited + * matches + */ + var allRequiredMatches = lunr.Set.complete, + allProhibitedMatches = lunr.Set.empty + + for (var i = 0; i < this.fields.length; i++) { + var field = this.fields[i] + + if (requiredMatches[field]) { + allRequiredMatches = allRequiredMatches.intersect(requiredMatches[field]) + } + + if (prohibitedMatches[field]) { + allProhibitedMatches = allProhibitedMatches.union(prohibitedMatches[field]) + } + } + + var matchingFieldRefs = Object.keys(matchingFields), + results = [], + matches = Object.create(null) + + /* + * If the query is negated (contains only prohibited terms) + * we need to get _all_ fieldRefs currently existing in the + * index. This is only done when we know that the query is + * entirely prohibited terms to avoid any cost of getting all + * fieldRefs unnecessarily. + * + * Additionally, blank MatchData must be created to correctly + * populate the results. + */ + if (query.isNegated()) { + matchingFieldRefs = Object.keys(this.fieldVectors) + + for (var i = 0; i < matchingFieldRefs.length; i++) { + var matchingFieldRef = matchingFieldRefs[i] + var fieldRef = lunr.FieldRef.fromString(matchingFieldRef) + matchingFields[matchingFieldRef] = new lunr.MatchData + } + } + + for (var i = 0; i < matchingFieldRefs.length; i++) { + /* + * Currently we have document fields that match the query, but we + * need to return documents. The matchData and scores are combined + * from multiple fields belonging to the same document. + * + * Scores are calculated by field, using the query vectors created + * above, and combined into a final document score using addition. + */ + var fieldRef = lunr.FieldRef.fromString(matchingFieldRefs[i]), + docRef = fieldRef.docRef + + if (!allRequiredMatches.contains(docRef)) { + continue + } + + if (allProhibitedMatches.contains(docRef)) { + continue + } + + var fieldVector = this.fieldVectors[fieldRef], + score = queryVectors[fieldRef.fieldName].similarity(fieldVector), + docMatch + + if ((docMatch = matches[docRef]) !== undefined) { + docMatch.score += score + docMatch.matchData.combine(matchingFields[fieldRef]) + } else { + var match = { + ref: docRef, + score: score, + matchData: matchingFields[fieldRef] + } + matches[docRef] = match + results.push(match) + } + } + + /* + * Sort the results objects by score, highest first. + */ + return results.sort(function (a, b) { + return b.score - a.score + }) +} + +/** + * Prepares the index for JSON serialization. + * + * The schema for this JSON blob will be described in a + * separate JSON schema file. + * + * @returns {Object} + */ +lunr.Index.prototype.toJSON = function () { + var invertedIndex = Object.keys(this.invertedIndex) + .sort() + .map(function (term) { + return [term, this.invertedIndex[term]] + }, this) + + var fieldVectors = Object.keys(this.fieldVectors) + .map(function (ref) { + return [ref, this.fieldVectors[ref].toJSON()] + }, this) + + return { + version: lunr.version, + fields: this.fields, + fieldVectors: fieldVectors, + invertedIndex: invertedIndex, + pipeline: this.pipeline.toJSON() + } +} + +/** + * Loads a previously serialized lunr.Index + * + * @param {Object} serializedIndex - A previously serialized lunr.Index + * @returns {lunr.Index} + */ +lunr.Index.load = function (serializedIndex) { + var attrs = {}, + fieldVectors = {}, + serializedVectors = serializedIndex.fieldVectors, + invertedIndex = Object.create(null), + serializedInvertedIndex = serializedIndex.invertedIndex, + tokenSetBuilder = new lunr.TokenSet.Builder, + pipeline = lunr.Pipeline.load(serializedIndex.pipeline) + + if (serializedIndex.version != lunr.version) { + lunr.utils.warn("Version mismatch when loading serialised index. Current version of lunr '" + lunr.version + "' does not match serialized index '" + serializedIndex.version + "'") + } + + for (var i = 0; i < serializedVectors.length; i++) { + var tuple = serializedVectors[i], + ref = tuple[0], + elements = tuple[1] + + fieldVectors[ref] = new lunr.Vector(elements) + } + + for (var i = 0; i < serializedInvertedIndex.length; i++) { + var tuple = serializedInvertedIndex[i], + term = tuple[0], + posting = tuple[1] + + tokenSetBuilder.insert(term) + invertedIndex[term] = posting + } + + tokenSetBuilder.finish() + + attrs.fields = serializedIndex.fields + + attrs.fieldVectors = fieldVectors + attrs.invertedIndex = invertedIndex + attrs.tokenSet = tokenSetBuilder.root + attrs.pipeline = pipeline + + return new lunr.Index(attrs) +} +/*! + * lunr.Builder + * Copyright (C) 2020 Oliver Nightingale + */ + +/** + * lunr.Builder performs indexing on a set of documents and + * returns instances of lunr.Index ready for querying. + * + * All configuration of the index is done via the builder, the + * fields to index, the document reference, the text processing + * pipeline and document scoring parameters are all set on the + * builder before indexing. + * + * @constructor + * @property {string} _ref - Internal reference to the document reference field. + * @property {string[]} _fields - Internal reference to the document fields to index. + * @property {object} invertedIndex - The inverted index maps terms to document fields. + * @property {object} documentTermFrequencies - Keeps track of document term frequencies. + * @property {object} documentLengths - Keeps track of the length of documents added to the index. + * @property {lunr.tokenizer} tokenizer - Function for splitting strings into tokens for indexing. + * @property {lunr.Pipeline} pipeline - The pipeline performs text processing on tokens before indexing. + * @property {lunr.Pipeline} searchPipeline - A pipeline for processing search terms before querying the index. + * @property {number} documentCount - Keeps track of the total number of documents indexed. + * @property {number} _b - A parameter to control field length normalization, setting this to 0 disabled normalization, 1 fully normalizes field lengths, the default value is 0.75. + * @property {number} _k1 - A parameter to control how quickly an increase in term frequency results in term frequency saturation, the default value is 1.2. + * @property {number} termIndex - A counter incremented for each unique term, used to identify a terms position in the vector space. + * @property {array} metadataWhitelist - A list of metadata keys that have been whitelisted for entry in the index. + */ +lunr.Builder = function () { + this._ref = "id" + this._fields = Object.create(null) + this._documents = Object.create(null) + this.invertedIndex = Object.create(null) + this.fieldTermFrequencies = {} + this.fieldLengths = {} + this.tokenizer = lunr.tokenizer + this.pipeline = new lunr.Pipeline + this.searchPipeline = new lunr.Pipeline + this.documentCount = 0 + this._b = 0.75 + this._k1 = 1.2 + this.termIndex = 0 + this.metadataWhitelist = [] +} + +/** + * Sets the document field used as the document reference. Every document must have this field. + * The type of this field in the document should be a string, if it is not a string it will be + * coerced into a string by calling toString. + * + * The default ref is 'id'. + * + * The ref should _not_ be changed during indexing, it should be set before any documents are + * added to the index. Changing it during indexing can lead to inconsistent results. + * + * @param {string} ref - The name of the reference field in the document. + */ +lunr.Builder.prototype.ref = function (ref) { + this._ref = ref +} + +/** + * A function that is used to extract a field from a document. + * + * Lunr expects a field to be at the top level of a document, if however the field + * is deeply nested within a document an extractor function can be used to extract + * the right field for indexing. + * + * @callback fieldExtractor + * @param {object} doc - The document being added to the index. + * @returns {?(string|object|object[])} obj - The object that will be indexed for this field. + * @example Extracting a nested field + * function (doc) { return doc.nested.field } + */ + +/** + * Adds a field to the list of document fields that will be indexed. Every document being + * indexed should have this field. Null values for this field in indexed documents will + * not cause errors but will limit the chance of that document being retrieved by searches. + * + * All fields should be added before adding documents to the index. Adding fields after + * a document has been indexed will have no effect on already indexed documents. + * + * Fields can be boosted at build time. This allows terms within that field to have more + * importance when ranking search results. Use a field boost to specify that matches within + * one field are more important than other fields. + * + * @param {string} fieldName - The name of a field to index in all documents. + * @param {object} attributes - Optional attributes associated with this field. + * @param {number} [attributes.boost=1] - Boost applied to all terms within this field. + * @param {fieldExtractor} [attributes.extractor] - Function to extract a field from a document. + * @throws {RangeError} fieldName cannot contain unsupported characters '/' + */ +lunr.Builder.prototype.field = function (fieldName, attributes) { + if (/\//.test(fieldName)) { + throw new RangeError ("Field '" + fieldName + "' contains illegal character '/'") + } + + this._fields[fieldName] = attributes || {} +} + +/** + * A parameter to tune the amount of field length normalisation that is applied when + * calculating relevance scores. A value of 0 will completely disable any normalisation + * and a value of 1 will fully normalise field lengths. The default is 0.75. Values of b + * will be clamped to the range 0 - 1. + * + * @param {number} number - The value to set for this tuning parameter. + */ +lunr.Builder.prototype.b = function (number) { + if (number < 0) { + this._b = 0 + } else if (number > 1) { + this._b = 1 + } else { + this._b = number + } +} + +/** + * A parameter that controls the speed at which a rise in term frequency results in term + * frequency saturation. The default value is 1.2. Setting this to a higher value will give + * slower saturation levels, a lower value will result in quicker saturation. + * + * @param {number} number - The value to set for this tuning parameter. + */ +lunr.Builder.prototype.k1 = function (number) { + this._k1 = number +} + +/** + * Adds a document to the index. + * + * Before adding fields to the index the index should have been fully setup, with the document + * ref and all fields to index already having been specified. + * + * The document must have a field name as specified by the ref (by default this is 'id') and + * it should have all fields defined for indexing, though null or undefined values will not + * cause errors. + * + * Entire documents can be boosted at build time. Applying a boost to a document indicates that + * this document should rank higher in search results than other documents. + * + * @param {object} doc - The document to add to the index. + * @param {object} attributes - Optional attributes associated with this document. + * @param {number} [attributes.boost=1] - Boost applied to all terms within this document. + */ +lunr.Builder.prototype.add = function (doc, attributes) { + var docRef = doc[this._ref], + fields = Object.keys(this._fields) + + this._documents[docRef] = attributes || {} + this.documentCount += 1 + + for (var i = 0; i < fields.length; i++) { + var fieldName = fields[i], + extractor = this._fields[fieldName].extractor, + field = extractor ? extractor(doc) : doc[fieldName], + tokens = this.tokenizer(field, { + fields: [fieldName] + }), + terms = this.pipeline.run(tokens), + fieldRef = new lunr.FieldRef (docRef, fieldName), + fieldTerms = Object.create(null) + + this.fieldTermFrequencies[fieldRef] = fieldTerms + this.fieldLengths[fieldRef] = 0 + + // store the length of this field for this document + this.fieldLengths[fieldRef] += terms.length + + // calculate term frequencies for this field + for (var j = 0; j < terms.length; j++) { + var term = terms[j] + + if (fieldTerms[term] == undefined) { + fieldTerms[term] = 0 + } + + fieldTerms[term] += 1 + + // add to inverted index + // create an initial posting if one doesn't exist + if (this.invertedIndex[term] == undefined) { + var posting = Object.create(null) + posting["_index"] = this.termIndex + this.termIndex += 1 + + for (var k = 0; k < fields.length; k++) { + posting[fields[k]] = Object.create(null) + } + + this.invertedIndex[term] = posting + } + + // add an entry for this term/fieldName/docRef to the invertedIndex + if (this.invertedIndex[term][fieldName][docRef] == undefined) { + this.invertedIndex[term][fieldName][docRef] = Object.create(null) + } + + // store all whitelisted metadata about this token in the + // inverted index + for (var l = 0; l < this.metadataWhitelist.length; l++) { + var metadataKey = this.metadataWhitelist[l], + metadata = term.metadata[metadataKey] + + if (this.invertedIndex[term][fieldName][docRef][metadataKey] == undefined) { + this.invertedIndex[term][fieldName][docRef][metadataKey] = [] + } + + this.invertedIndex[term][fieldName][docRef][metadataKey].push(metadata) + } + } + + } +} + +/** + * Calculates the average document length for this index + * + * @private + */ +lunr.Builder.prototype.calculateAverageFieldLengths = function () { + + var fieldRefs = Object.keys(this.fieldLengths), + numberOfFields = fieldRefs.length, + accumulator = {}, + documentsWithField = {} + + for (var i = 0; i < numberOfFields; i++) { + var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]), + field = fieldRef.fieldName + + documentsWithField[field] || (documentsWithField[field] = 0) + documentsWithField[field] += 1 + + accumulator[field] || (accumulator[field] = 0) + accumulator[field] += this.fieldLengths[fieldRef] + } + + var fields = Object.keys(this._fields) + + for (var i = 0; i < fields.length; i++) { + var fieldName = fields[i] + accumulator[fieldName] = accumulator[fieldName] / documentsWithField[fieldName] + } + + this.averageFieldLength = accumulator +} + +/** + * Builds a vector space model of every document using lunr.Vector + * + * @private + */ +lunr.Builder.prototype.createFieldVectors = function () { + var fieldVectors = {}, + fieldRefs = Object.keys(this.fieldTermFrequencies), + fieldRefsLength = fieldRefs.length, + termIdfCache = Object.create(null) + + for (var i = 0; i < fieldRefsLength; i++) { + var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]), + fieldName = fieldRef.fieldName, + fieldLength = this.fieldLengths[fieldRef], + fieldVector = new lunr.Vector, + termFrequencies = this.fieldTermFrequencies[fieldRef], + terms = Object.keys(termFrequencies), + termsLength = terms.length + + + var fieldBoost = this._fields[fieldName].boost || 1, + docBoost = this._documents[fieldRef.docRef].boost || 1 + + for (var j = 0; j < termsLength; j++) { + var term = terms[j], + tf = termFrequencies[term], + termIndex = this.invertedIndex[term]._index, + idf, score, scoreWithPrecision + + if (termIdfCache[term] === undefined) { + idf = lunr.idf(this.invertedIndex[term], this.documentCount) + termIdfCache[term] = idf + } else { + idf = termIdfCache[term] + } + + score = idf * ((this._k1 + 1) * tf) / (this._k1 * (1 - this._b + this._b * (fieldLength / this.averageFieldLength[fieldName])) + tf) + score *= fieldBoost + score *= docBoost + scoreWithPrecision = Math.round(score * 1000) / 1000 + // Converts 1.23456789 to 1.234. + // Reducing the precision so that the vectors take up less + // space when serialised. Doing it now so that they behave + // the same before and after serialisation. Also, this is + // the fastest approach to reducing a number's precision in + // JavaScript. + + fieldVector.insert(termIndex, scoreWithPrecision) + } + + fieldVectors[fieldRef] = fieldVector + } + + this.fieldVectors = fieldVectors +} + +/** + * Creates a token set of all tokens in the index using lunr.TokenSet + * + * @private + */ +lunr.Builder.prototype.createTokenSet = function () { + this.tokenSet = lunr.TokenSet.fromArray( + Object.keys(this.invertedIndex).sort() + ) +} + +/** + * Builds the index, creating an instance of lunr.Index. + * + * This completes the indexing process and should only be called + * once all documents have been added to the index. + * + * @returns {lunr.Index} + */ +lunr.Builder.prototype.build = function () { + this.calculateAverageFieldLengths() + this.createFieldVectors() + this.createTokenSet() + + return new lunr.Index({ + invertedIndex: this.invertedIndex, + fieldVectors: this.fieldVectors, + tokenSet: this.tokenSet, + fields: Object.keys(this._fields), + pipeline: this.searchPipeline + }) +} + +/** + * Applies a plugin to the index builder. + * + * A plugin is a function that is called with the index builder as its context. + * Plugins can be used to customise or extend the behaviour of the index + * in some way. A plugin is just a function, that encapsulated the custom + * behaviour that should be applied when building the index. + * + * The plugin function will be called with the index builder as its argument, additional + * arguments can also be passed when calling use. The function will be called + * with the index builder as its context. + * + * @param {Function} plugin The plugin to apply. + */ +lunr.Builder.prototype.use = function (fn) { + var args = Array.prototype.slice.call(arguments, 1) + args.unshift(this) + fn.apply(this, args) +} +/** + * Contains and collects metadata about a matching document. + * A single instance of lunr.MatchData is returned as part of every + * lunr.Index~Result. + * + * @constructor + * @param {string} term - The term this match data is associated with + * @param {string} field - The field in which the term was found + * @param {object} metadata - The metadata recorded about this term in this field + * @property {object} metadata - A cloned collection of metadata associated with this document. + * @see {@link lunr.Index~Result} + */ +lunr.MatchData = function (term, field, metadata) { + var clonedMetadata = Object.create(null), + metadataKeys = Object.keys(metadata || {}) + + // Cloning the metadata to prevent the original + // being mutated during match data combination. + // Metadata is kept in an array within the inverted + // index so cloning the data can be done with + // Array#slice + for (var i = 0; i < metadataKeys.length; i++) { + var key = metadataKeys[i] + clonedMetadata[key] = metadata[key].slice() + } + + this.metadata = Object.create(null) + + if (term !== undefined) { + this.metadata[term] = Object.create(null) + this.metadata[term][field] = clonedMetadata + } +} + +/** + * An instance of lunr.MatchData will be created for every term that matches a + * document. However only one instance is required in a lunr.Index~Result. This + * method combines metadata from another instance of lunr.MatchData with this + * objects metadata. + * + * @param {lunr.MatchData} otherMatchData - Another instance of match data to merge with this one. + * @see {@link lunr.Index~Result} + */ +lunr.MatchData.prototype.combine = function (otherMatchData) { + var terms = Object.keys(otherMatchData.metadata) + + for (var i = 0; i < terms.length; i++) { + var term = terms[i], + fields = Object.keys(otherMatchData.metadata[term]) + + if (this.metadata[term] == undefined) { + this.metadata[term] = Object.create(null) + } + + for (var j = 0; j < fields.length; j++) { + var field = fields[j], + keys = Object.keys(otherMatchData.metadata[term][field]) + + if (this.metadata[term][field] == undefined) { + this.metadata[term][field] = Object.create(null) + } + + for (var k = 0; k < keys.length; k++) { + var key = keys[k] + + if (this.metadata[term][field][key] == undefined) { + this.metadata[term][field][key] = otherMatchData.metadata[term][field][key] + } else { + this.metadata[term][field][key] = this.metadata[term][field][key].concat(otherMatchData.metadata[term][field][key]) + } + + } + } + } +} + +/** + * Add metadata for a term/field pair to this instance of match data. + * + * @param {string} term - The term this match data is associated with + * @param {string} field - The field in which the term was found + * @param {object} metadata - The metadata recorded about this term in this field + */ +lunr.MatchData.prototype.add = function (term, field, metadata) { + if (!(term in this.metadata)) { + this.metadata[term] = Object.create(null) + this.metadata[term][field] = metadata + return + } + + if (!(field in this.metadata[term])) { + this.metadata[term][field] = metadata + return + } + + var metadataKeys = Object.keys(metadata) + + for (var i = 0; i < metadataKeys.length; i++) { + var key = metadataKeys[i] + + if (key in this.metadata[term][field]) { + this.metadata[term][field][key] = this.metadata[term][field][key].concat(metadata[key]) + } else { + this.metadata[term][field][key] = metadata[key] + } + } +} +/** + * A lunr.Query provides a programmatic way of defining queries to be performed + * against a {@link lunr.Index}. + * + * Prefer constructing a lunr.Query using the {@link lunr.Index#query} method + * so the query object is pre-initialized with the right index fields. + * + * @constructor + * @property {lunr.Query~Clause[]} clauses - An array of query clauses. + * @property {string[]} allFields - An array of all available fields in a lunr.Index. + */ +lunr.Query = function (allFields) { + this.clauses = [] + this.allFields = allFields +} + +/** + * Constants for indicating what kind of automatic wildcard insertion will be used when constructing a query clause. + * + * This allows wildcards to be added to the beginning and end of a term without having to manually do any string + * concatenation. + * + * The wildcard constants can be bitwise combined to select both leading and trailing wildcards. + * + * @constant + * @default + * @property {number} wildcard.NONE - The term will have no wildcards inserted, this is the default behaviour + * @property {number} wildcard.LEADING - Prepend the term with a wildcard, unless a leading wildcard already exists + * @property {number} wildcard.TRAILING - Append a wildcard to the term, unless a trailing wildcard already exists + * @see lunr.Query~Clause + * @see lunr.Query#clause + * @see lunr.Query#term + * @example query term with trailing wildcard + * query.term('foo', { wildcard: lunr.Query.wildcard.TRAILING }) + * @example query term with leading and trailing wildcard + * query.term('foo', { + * wildcard: lunr.Query.wildcard.LEADING | lunr.Query.wildcard.TRAILING + * }) + */ + +lunr.Query.wildcard = new String ("*") +lunr.Query.wildcard.NONE = 0 +lunr.Query.wildcard.LEADING = 1 +lunr.Query.wildcard.TRAILING = 2 + +/** + * Constants for indicating what kind of presence a term must have in matching documents. + * + * @constant + * @enum {number} + * @see lunr.Query~Clause + * @see lunr.Query#clause + * @see lunr.Query#term + * @example query term with required presence + * query.term('foo', { presence: lunr.Query.presence.REQUIRED }) + */ +lunr.Query.presence = { + /** + * Term's presence in a document is optional, this is the default value. + */ + OPTIONAL: 1, + + /** + * Term's presence in a document is required, documents that do not contain + * this term will not be returned. + */ + REQUIRED: 2, + + /** + * Term's presence in a document is prohibited, documents that do contain + * this term will not be returned. + */ + PROHIBITED: 3 +} + +/** + * A single clause in a {@link lunr.Query} contains a term and details on how to + * match that term against a {@link lunr.Index}. + * + * @typedef {Object} lunr.Query~Clause + * @property {string[]} fields - The fields in an index this clause should be matched against. + * @property {number} [boost=1] - Any boost that should be applied when matching this clause. + * @property {number} [editDistance] - Whether the term should have fuzzy matching applied, and how fuzzy the match should be. + * @property {boolean} [usePipeline] - Whether the term should be passed through the search pipeline. + * @property {number} [wildcard=lunr.Query.wildcard.NONE] - Whether the term should have wildcards appended or prepended. + * @property {number} [presence=lunr.Query.presence.OPTIONAL] - The terms presence in any matching documents. + */ + +/** + * Adds a {@link lunr.Query~Clause} to this query. + * + * Unless the clause contains the fields to be matched all fields will be matched. In addition + * a default boost of 1 is applied to the clause. + * + * @param {lunr.Query~Clause} clause - The clause to add to this query. + * @see lunr.Query~Clause + * @returns {lunr.Query} + */ +lunr.Query.prototype.clause = function (clause) { + if (!('fields' in clause)) { + clause.fields = this.allFields + } + + if (!('boost' in clause)) { + clause.boost = 1 + } + + if (!('usePipeline' in clause)) { + clause.usePipeline = true + } + + if (!('wildcard' in clause)) { + clause.wildcard = lunr.Query.wildcard.NONE + } + + if ((clause.wildcard & lunr.Query.wildcard.LEADING) && (clause.term.charAt(0) != lunr.Query.wildcard)) { + clause.term = "*" + clause.term + } + + if ((clause.wildcard & lunr.Query.wildcard.TRAILING) && (clause.term.slice(-1) != lunr.Query.wildcard)) { + clause.term = "" + clause.term + "*" + } + + if (!('presence' in clause)) { + clause.presence = lunr.Query.presence.OPTIONAL + } + + this.clauses.push(clause) + + return this +} + +/** + * A negated query is one in which every clause has a presence of + * prohibited. These queries require some special processing to return + * the expected results. + * + * @returns boolean + */ +lunr.Query.prototype.isNegated = function () { + for (var i = 0; i < this.clauses.length; i++) { + if (this.clauses[i].presence != lunr.Query.presence.PROHIBITED) { + return false + } + } + + return true +} + +/** + * Adds a term to the current query, under the covers this will create a {@link lunr.Query~Clause} + * to the list of clauses that make up this query. + * + * The term is used as is, i.e. no tokenization will be performed by this method. Instead conversion + * to a token or token-like string should be done before calling this method. + * + * The term will be converted to a string by calling `toString`. Multiple terms can be passed as an + * array, each term in the array will share the same options. + * + * @param {object|object[]} term - The term(s) to add to the query. + * @param {object} [options] - Any additional properties to add to the query clause. + * @returns {lunr.Query} + * @see lunr.Query#clause + * @see lunr.Query~Clause + * @example adding a single term to a query + * query.term("foo") + * @example adding a single term to a query and specifying search fields, term boost and automatic trailing wildcard + * query.term("foo", { + * fields: ["title"], + * boost: 10, + * wildcard: lunr.Query.wildcard.TRAILING + * }) + * @example using lunr.tokenizer to convert a string to tokens before using them as terms + * query.term(lunr.tokenizer("foo bar")) + */ +lunr.Query.prototype.term = function (term, options) { + if (Array.isArray(term)) { + term.forEach(function (t) { this.term(t, lunr.utils.clone(options)) }, this) + return this + } + + var clause = options || {} + clause.term = term.toString() + + this.clause(clause) + + return this +} +lunr.QueryParseError = function (message, start, end) { + this.name = "QueryParseError" + this.message = message + this.start = start + this.end = end +} + +lunr.QueryParseError.prototype = new Error +lunr.QueryLexer = function (str) { + this.lexemes = [] + this.str = str + this.length = str.length + this.pos = 0 + this.start = 0 + this.escapeCharPositions = [] +} + +lunr.QueryLexer.prototype.run = function () { + var state = lunr.QueryLexer.lexText + + while (state) { + state = state(this) + } +} + +lunr.QueryLexer.prototype.sliceString = function () { + var subSlices = [], + sliceStart = this.start, + sliceEnd = this.pos + + for (var i = 0; i < this.escapeCharPositions.length; i++) { + sliceEnd = this.escapeCharPositions[i] + subSlices.push(this.str.slice(sliceStart, sliceEnd)) + sliceStart = sliceEnd + 1 + } + + subSlices.push(this.str.slice(sliceStart, this.pos)) + this.escapeCharPositions.length = 0 + + return subSlices.join('') +} + +lunr.QueryLexer.prototype.emit = function (type) { + this.lexemes.push({ + type: type, + str: this.sliceString(), + start: this.start, + end: this.pos + }) + + this.start = this.pos +} + +lunr.QueryLexer.prototype.escapeCharacter = function () { + this.escapeCharPositions.push(this.pos - 1) + this.pos += 1 +} + +lunr.QueryLexer.prototype.next = function () { + if (this.pos >= this.length) { + return lunr.QueryLexer.EOS + } + + var char = this.str.charAt(this.pos) + this.pos += 1 + return char +} + +lunr.QueryLexer.prototype.width = function () { + return this.pos - this.start +} + +lunr.QueryLexer.prototype.ignore = function () { + if (this.start == this.pos) { + this.pos += 1 + } + + this.start = this.pos +} + +lunr.QueryLexer.prototype.backup = function () { + this.pos -= 1 +} + +lunr.QueryLexer.prototype.acceptDigitRun = function () { + var char, charCode + + do { + char = this.next() + charCode = char.charCodeAt(0) + } while (charCode > 47 && charCode < 58) + + if (char != lunr.QueryLexer.EOS) { + this.backup() + } +} + +lunr.QueryLexer.prototype.more = function () { + return this.pos < this.length +} + +lunr.QueryLexer.EOS = 'EOS' +lunr.QueryLexer.FIELD = 'FIELD' +lunr.QueryLexer.TERM = 'TERM' +lunr.QueryLexer.EDIT_DISTANCE = 'EDIT_DISTANCE' +lunr.QueryLexer.BOOST = 'BOOST' +lunr.QueryLexer.PRESENCE = 'PRESENCE' + +lunr.QueryLexer.lexField = function (lexer) { + lexer.backup() + lexer.emit(lunr.QueryLexer.FIELD) + lexer.ignore() + return lunr.QueryLexer.lexText +} + +lunr.QueryLexer.lexTerm = function (lexer) { + if (lexer.width() > 1) { + lexer.backup() + lexer.emit(lunr.QueryLexer.TERM) + } + + lexer.ignore() + + if (lexer.more()) { + return lunr.QueryLexer.lexText + } +} + +lunr.QueryLexer.lexEditDistance = function (lexer) { + lexer.ignore() + lexer.acceptDigitRun() + lexer.emit(lunr.QueryLexer.EDIT_DISTANCE) + return lunr.QueryLexer.lexText +} + +lunr.QueryLexer.lexBoost = function (lexer) { + lexer.ignore() + lexer.acceptDigitRun() + lexer.emit(lunr.QueryLexer.BOOST) + return lunr.QueryLexer.lexText +} + +lunr.QueryLexer.lexEOS = function (lexer) { + if (lexer.width() > 0) { + lexer.emit(lunr.QueryLexer.TERM) + } +} + +// This matches the separator used when tokenising fields +// within a document. These should match otherwise it is +// not possible to search for some tokens within a document. +// +// It is possible for the user to change the separator on the +// tokenizer so it _might_ clash with any other of the special +// characters already used within the search string, e.g. :. +// +// This means that it is possible to change the separator in +// such a way that makes some words unsearchable using a search +// string. +lunr.QueryLexer.termSeparator = lunr.tokenizer.separator + +lunr.QueryLexer.lexText = function (lexer) { + while (true) { + var char = lexer.next() + + if (char == lunr.QueryLexer.EOS) { + return lunr.QueryLexer.lexEOS + } + + // Escape character is '\' + if (char.charCodeAt(0) == 92) { + lexer.escapeCharacter() + continue + } + + if (char == ":") { + return lunr.QueryLexer.lexField + } + + if (char == "~") { + lexer.backup() + if (lexer.width() > 0) { + lexer.emit(lunr.QueryLexer.TERM) + } + return lunr.QueryLexer.lexEditDistance + } + + if (char == "^") { + lexer.backup() + if (lexer.width() > 0) { + lexer.emit(lunr.QueryLexer.TERM) + } + return lunr.QueryLexer.lexBoost + } + + // "+" indicates term presence is required + // checking for length to ensure that only + // leading "+" are considered + if (char == "+" && lexer.width() === 1) { + lexer.emit(lunr.QueryLexer.PRESENCE) + return lunr.QueryLexer.lexText + } + + // "-" indicates term presence is prohibited + // checking for length to ensure that only + // leading "-" are considered + if (char == "-" && lexer.width() === 1) { + lexer.emit(lunr.QueryLexer.PRESENCE) + return lunr.QueryLexer.lexText + } + + if (char.match(lunr.QueryLexer.termSeparator)) { + return lunr.QueryLexer.lexTerm + } + } +} + +lunr.QueryParser = function (str, query) { + this.lexer = new lunr.QueryLexer (str) + this.query = query + this.currentClause = {} + this.lexemeIdx = 0 +} + +lunr.QueryParser.prototype.parse = function () { + this.lexer.run() + this.lexemes = this.lexer.lexemes + + var state = lunr.QueryParser.parseClause + + while (state) { + state = state(this) + } + + return this.query +} + +lunr.QueryParser.prototype.peekLexeme = function () { + return this.lexemes[this.lexemeIdx] +} + +lunr.QueryParser.prototype.consumeLexeme = function () { + var lexeme = this.peekLexeme() + this.lexemeIdx += 1 + return lexeme +} + +lunr.QueryParser.prototype.nextClause = function () { + var completedClause = this.currentClause + this.query.clause(completedClause) + this.currentClause = {} +} + +lunr.QueryParser.parseClause = function (parser) { + var lexeme = parser.peekLexeme() + + if (lexeme == undefined) { + return + } + + switch (lexeme.type) { + case lunr.QueryLexer.PRESENCE: + return lunr.QueryParser.parsePresence + case lunr.QueryLexer.FIELD: + return lunr.QueryParser.parseField + case lunr.QueryLexer.TERM: + return lunr.QueryParser.parseTerm + default: + var errorMessage = "expected either a field or a term, found " + lexeme.type + + if (lexeme.str.length >= 1) { + errorMessage += " with value '" + lexeme.str + "'" + } + + throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end) + } +} + +lunr.QueryParser.parsePresence = function (parser) { + var lexeme = parser.consumeLexeme() + + if (lexeme == undefined) { + return + } + + switch (lexeme.str) { + case "-": + parser.currentClause.presence = lunr.Query.presence.PROHIBITED + break + case "+": + parser.currentClause.presence = lunr.Query.presence.REQUIRED + break + default: + var errorMessage = "unrecognised presence operator'" + lexeme.str + "'" + throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end) + } + + var nextLexeme = parser.peekLexeme() + + if (nextLexeme == undefined) { + var errorMessage = "expecting term or field, found nothing" + throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end) + } + + switch (nextLexeme.type) { + case lunr.QueryLexer.FIELD: + return lunr.QueryParser.parseField + case lunr.QueryLexer.TERM: + return lunr.QueryParser.parseTerm + default: + var errorMessage = "expecting term or field, found '" + nextLexeme.type + "'" + throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end) + } +} + +lunr.QueryParser.parseField = function (parser) { + var lexeme = parser.consumeLexeme() + + if (lexeme == undefined) { + return + } + + if (parser.query.allFields.indexOf(lexeme.str) == -1) { + var possibleFields = parser.query.allFields.map(function (f) { return "'" + f + "'" }).join(', '), + errorMessage = "unrecognised field '" + lexeme.str + "', possible fields: " + possibleFields + + throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end) + } + + parser.currentClause.fields = [lexeme.str] + + var nextLexeme = parser.peekLexeme() + + if (nextLexeme == undefined) { + var errorMessage = "expecting term, found nothing" + throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end) + } + + switch (nextLexeme.type) { + case lunr.QueryLexer.TERM: + return lunr.QueryParser.parseTerm + default: + var errorMessage = "expecting term, found '" + nextLexeme.type + "'" + throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end) + } +} + +lunr.QueryParser.parseTerm = function (parser) { + var lexeme = parser.consumeLexeme() + + if (lexeme == undefined) { + return + } + + parser.currentClause.term = lexeme.str.toLowerCase() + + if (lexeme.str.indexOf("*") != -1) { + parser.currentClause.usePipeline = false + } + + var nextLexeme = parser.peekLexeme() + + if (nextLexeme == undefined) { + parser.nextClause() + return + } + + switch (nextLexeme.type) { + case lunr.QueryLexer.TERM: + parser.nextClause() + return lunr.QueryParser.parseTerm + case lunr.QueryLexer.FIELD: + parser.nextClause() + return lunr.QueryParser.parseField + case lunr.QueryLexer.EDIT_DISTANCE: + return lunr.QueryParser.parseEditDistance + case lunr.QueryLexer.BOOST: + return lunr.QueryParser.parseBoost + case lunr.QueryLexer.PRESENCE: + parser.nextClause() + return lunr.QueryParser.parsePresence + default: + var errorMessage = "Unexpected lexeme type '" + nextLexeme.type + "'" + throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end) + } +} + +lunr.QueryParser.parseEditDistance = function (parser) { + var lexeme = parser.consumeLexeme() + + if (lexeme == undefined) { + return + } + + var editDistance = parseInt(lexeme.str, 10) + + if (isNaN(editDistance)) { + var errorMessage = "edit distance must be numeric" + throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end) + } + + parser.currentClause.editDistance = editDistance + + var nextLexeme = parser.peekLexeme() + + if (nextLexeme == undefined) { + parser.nextClause() + return + } + + switch (nextLexeme.type) { + case lunr.QueryLexer.TERM: + parser.nextClause() + return lunr.QueryParser.parseTerm + case lunr.QueryLexer.FIELD: + parser.nextClause() + return lunr.QueryParser.parseField + case lunr.QueryLexer.EDIT_DISTANCE: + return lunr.QueryParser.parseEditDistance + case lunr.QueryLexer.BOOST: + return lunr.QueryParser.parseBoost + case lunr.QueryLexer.PRESENCE: + parser.nextClause() + return lunr.QueryParser.parsePresence + default: + var errorMessage = "Unexpected lexeme type '" + nextLexeme.type + "'" + throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end) + } +} + +lunr.QueryParser.parseBoost = function (parser) { + var lexeme = parser.consumeLexeme() + + if (lexeme == undefined) { + return + } + + var boost = parseInt(lexeme.str, 10) + + if (isNaN(boost)) { + var errorMessage = "boost must be numeric" + throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end) + } + + parser.currentClause.boost = boost + + var nextLexeme = parser.peekLexeme() + + if (nextLexeme == undefined) { + parser.nextClause() + return + } + + switch (nextLexeme.type) { + case lunr.QueryLexer.TERM: + parser.nextClause() + return lunr.QueryParser.parseTerm + case lunr.QueryLexer.FIELD: + parser.nextClause() + return lunr.QueryParser.parseField + case lunr.QueryLexer.EDIT_DISTANCE: + return lunr.QueryParser.parseEditDistance + case lunr.QueryLexer.BOOST: + return lunr.QueryParser.parseBoost + case lunr.QueryLexer.PRESENCE: + parser.nextClause() + return lunr.QueryParser.parsePresence + default: + var errorMessage = "Unexpected lexeme type '" + nextLexeme.type + "'" + throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end) + } +} + + /** + * export the module via AMD, CommonJS or as a browser global + * Export code from https://github.com/umdjs/umd/blob/master/returnExports.js + */ + ;(function (root, factory) { + if (typeof define === 'function' && define.amd) { + // AMD. Register as an anonymous module. + define(factory) + } else if (typeof exports === 'object') { + /** + * Node. Does not work with strict CommonJS, but + * only CommonJS-like environments that support module.exports, + * like Node. + */ + module.exports = factory() + } else { + // Browser globals (root is window) + root.lunr = factory() + } + }(this, function () { + /** + * Just return a value to define the module export. + * This example returns an object, but the module + * can return a function as the exported value. + */ + return lunr + })) +})(); diff --git a/search/main.js b/search/main.js new file mode 100644 index 0000000..a5e469d --- /dev/null +++ b/search/main.js @@ -0,0 +1,109 @@ +function getSearchTermFromLocation() { + var sPageURL = window.location.search.substring(1); + var sURLVariables = sPageURL.split('&'); + for (var i = 0; i < sURLVariables.length; i++) { + var sParameterName = sURLVariables[i].split('='); + if (sParameterName[0] == 'q') { + return decodeURIComponent(sParameterName[1].replace(/\+/g, '%20')); + } + } +} + +function joinUrl (base, path) { + if (path.substring(0, 1) === "/") { + // path starts with `/`. Thus it is absolute. + return path; + } + if (base.substring(base.length-1) === "/") { + // base ends with `/` + return base + path; + } + return base + "/" + path; +} + +function escapeHtml (value) { + return value.replace(/&/g, '&') + .replace(/"/g, '"') + .replace(//g, '>'); +} + +function formatResult (location, title, summary) { + return ''; +} + +function displayResults (results) { + var search_results = document.getElementById("mkdocs-search-results"); + while (search_results.firstChild) { + search_results.removeChild(search_results.firstChild); + } + if (results.length > 0){ + for (var i=0; i < results.length; i++){ + var result = results[i]; + var html = formatResult(result.location, result.title, result.summary); + search_results.insertAdjacentHTML('beforeend', html); + } + } else { + var noResultsText = search_results.getAttribute('data-no-results-text'); + if (!noResultsText) { + noResultsText = "No results found"; + } + search_results.insertAdjacentHTML('beforeend', '

' + noResultsText + '

'); + } +} + +function doSearch () { + var query = document.getElementById('mkdocs-search-query').value; + if (query.length > min_search_length) { + if (!window.Worker) { + displayResults(search(query)); + } else { + searchWorker.postMessage({query: query}); + } + } else { + // Clear results for short queries + displayResults([]); + } +} + +function initSearch () { + var search_input = document.getElementById('mkdocs-search-query'); + if (search_input) { + search_input.addEventListener("keyup", doSearch); + } + var term = getSearchTermFromLocation(); + if (term) { + search_input.value = term; + doSearch(); + } +} + +function onWorkerMessage (e) { + if (e.data.allowSearch) { + initSearch(); + } else if (e.data.results) { + var results = e.data.results; + displayResults(results); + } else if (e.data.config) { + min_search_length = e.data.config.min_search_length-1; + } +} + +if (!window.Worker) { + console.log('Web Worker API not supported'); + // load index in main thread + $.getScript(joinUrl(base_url, "search/worker.js")).done(function () { + console.log('Loaded worker'); + init(); + window.postMessage = function (msg) { + onWorkerMessage({data: msg}); + }; + }).fail(function (jqxhr, settings, exception) { + console.error('Could not load worker.js'); + }); +} else { + // Wrap search in a web worker + var searchWorker = new Worker(joinUrl(base_url, "search/worker.js")); + searchWorker.postMessage({init: true}); + searchWorker.onmessage = onWorkerMessage; +} diff --git a/search/search_index.json b/search/search_index.json new file mode 100644 index 0000000..f719dbc --- /dev/null +++ b/search/search_index.json @@ -0,0 +1 @@ +{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"BIOI611 lab Welcome to BIOI 611! I\u2019m excited to have you in this course, where we will delve into the fascinating world of transcriptomics and explore the intricacies of gene and transcript-level expression analysis. This course focuses on the analysis of transcriptomics data, and specifically on the analysis of gene and transcript-level expression. Material covered includes transcript and gene expression estimation from RNA-seq data (short and long-read), basic experimental design and statistical methods for differential expression analysis, discovery of novel transcripts via reference-guided and de novo assembly, and the analysis of single-cell gene expression data (e.g., single-cell expression quantification, dimensionality reduction, clustering, pseudotime analysis). Prerequisite: BIOI 604. Core.","title":"BIOI611 lab"},{"location":"#bioi611-lab","text":"Welcome to BIOI 611! I\u2019m excited to have you in this course, where we will delve into the fascinating world of transcriptomics and explore the intricacies of gene and transcript-level expression analysis. This course focuses on the analysis of transcriptomics data, and specifically on the analysis of gene and transcript-level expression. Material covered includes transcript and gene expression estimation from RNA-seq data (short and long-read), basic experimental design and statistical methods for differential expression analysis, discovery of novel transcripts via reference-guided and de novo assembly, and the analysis of single-cell gene expression data (e.g., single-cell expression quantification, dimensionality reduction, clustering, pseudotime analysis). Prerequisite: BIOI 604. Core.","title":"BIOI611 lab"},{"location":"FASTQ_PHRED/","text":"What is PHRED Scores A Phred score is a measure of the probability that a base call in a DNA sequencing read is incorrect. It is a logarithmic scale, meaning that a small change in the Phred score represents a large change in the probability of an error. $$Q = -10 \\cdot \\log_{10}(P)$$ Where: Q is the PHRED score. P is the probability that the base was called incorrectly. For example: Q = 20 : This corresponds to a 1 in 100 probability of an incorrect base call, or an accuracy of 99%. Q = 30 : This corresponds to a 1 in 1000 probability of an incorrect base call, or an accuracy of 99.9%. Q = 40 : This corresponds to a 1 in 10,000 probability of an incorrect base call, or an accuracy of 99.99%. # Print the header cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"Phred\", \"Prob of\")) cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"score\", \"Incorrect call\")) # Loop through Phred scores from 0 to 41 for (phred in 0:41) { cat(sprintf(\"%-5d\\t\\t%0.5f\\n\", phred, 10^(phred / -10))) } What is ASCII ASCII (American Standard Code for Information Interchange) is used to represent characters in computers. We can represent Phred scores using ASCII characters. The advantage is that the quality information can be esisly stored in text based FASTQ file. Not all ASCII characters are printable. The first printable ASCII character is ! and the decimal code for the character for ! is 33. # Store output in a vector to fit on a slide output <- c(sprintf(\"%-8s %-8s\", \"Character\", \"ASCII #\")) # Loop through ASCII values from 33 to 89 for (i in 33:89) { output <- c(output, sprintf(\"%-8s %-8d\", intToUtf8(i), i)) } # Print the output in a single block (e.g., to fit on a slide) cat(paste(output, collapse = \"\\n\")) Phred scores in FASTQ file In a FASTQ file, Phred scores are represented as ASCII characters. These characters are converted back to numeric values (PHRED scores) based on the encoding scheme used: PHRED+33 Encoding (Sanger/Illumina 1.8+) : The ASCII character for a quality score Q is calculated as: ASCII character=chr(Q+33) For example: A PHRED score of 30 is encoded as chr(30 + 33) = chr(63) , which corresponds to the ASCII character ? . PHRED+64 Encoding (Illumina 1.3-1.7) : The ASCII character for a quality score QQQ is calculated as: ASCII character=chr(Q+64) For example: A PHRED score of 30 is encoded as chr(30 + 64) = chr(94) , which corresponds to the ASCII character ^ . # Print the header cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t\\t%-10s\\n\", \"Phred\", \"Prob. of\", \"ASCII\", \"ASCII\")) cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t%-10s\\n\", \"score\", \"Error\", \"Phred+33\", \"Phred+64\")) # Loop through Phred scores from 0 to 41 for (phred in 0:41) { # Calculate the probability of error prob_error <- 10^(phred / -10) # Convert Phred scores to ASCII characters ascii_phred33 <- intToUtf8(phred + 33) ascii_phred64 <- intToUtf8(phred + 64) # Print the results in a formatted table cat(sprintf(\"%-5d\\t\\t%0.5f\\t\\t%-6s\\t\\t%-10s\\n\", phred, prob_error, ascii_phred33, ascii_phred64)) }","title":"PRED Score in Bioinformatics"},{"location":"FASTQ_PHRED/#what-is-phred-scores","text":"A Phred score is a measure of the probability that a base call in a DNA sequencing read is incorrect. It is a logarithmic scale, meaning that a small change in the Phred score represents a large change in the probability of an error. $$Q = -10 \\cdot \\log_{10}(P)$$ Where: Q is the PHRED score. P is the probability that the base was called incorrectly. For example: Q = 20 : This corresponds to a 1 in 100 probability of an incorrect base call, or an accuracy of 99%. Q = 30 : This corresponds to a 1 in 1000 probability of an incorrect base call, or an accuracy of 99.9%. Q = 40 : This corresponds to a 1 in 10,000 probability of an incorrect base call, or an accuracy of 99.99%. # Print the header cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"Phred\", \"Prob of\")) cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"score\", \"Incorrect call\")) # Loop through Phred scores from 0 to 41 for (phred in 0:41) { cat(sprintf(\"%-5d\\t\\t%0.5f\\n\", phred, 10^(phred / -10))) }","title":"What is PHRED Scores"},{"location":"FASTQ_PHRED/#what-is-ascii","text":"ASCII (American Standard Code for Information Interchange) is used to represent characters in computers. We can represent Phred scores using ASCII characters. The advantage is that the quality information can be esisly stored in text based FASTQ file. Not all ASCII characters are printable. The first printable ASCII character is ! and the decimal code for the character for ! is 33. # Store output in a vector to fit on a slide output <- c(sprintf(\"%-8s %-8s\", \"Character\", \"ASCII #\")) # Loop through ASCII values from 33 to 89 for (i in 33:89) { output <- c(output, sprintf(\"%-8s %-8d\", intToUtf8(i), i)) } # Print the output in a single block (e.g., to fit on a slide) cat(paste(output, collapse = \"\\n\"))","title":"What is ASCII"},{"location":"FASTQ_PHRED/#phred-scores-in-fastq-file","text":"In a FASTQ file, Phred scores are represented as ASCII characters. These characters are converted back to numeric values (PHRED scores) based on the encoding scheme used: PHRED+33 Encoding (Sanger/Illumina 1.8+) : The ASCII character for a quality score Q is calculated as: ASCII character=chr(Q+33) For example: A PHRED score of 30 is encoded as chr(30 + 33) = chr(63) , which corresponds to the ASCII character ? . PHRED+64 Encoding (Illumina 1.3-1.7) : The ASCII character for a quality score QQQ is calculated as: ASCII character=chr(Q+64) For example: A PHRED score of 30 is encoded as chr(30 + 64) = chr(94) , which corresponds to the ASCII character ^ . # Print the header cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t\\t%-10s\\n\", \"Phred\", \"Prob. of\", \"ASCII\", \"ASCII\")) cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t%-10s\\n\", \"score\", \"Error\", \"Phred+33\", \"Phred+64\")) # Loop through Phred scores from 0 to 41 for (phred in 0:41) { # Calculate the probability of error prob_error <- 10^(phred / -10) # Convert Phred scores to ASCII characters ascii_phred33 <- intToUtf8(phred + 33) ascii_phred64 <- intToUtf8(phred + 64) # Print the results in a formatted table cat(sprintf(\"%-5d\\t\\t%0.5f\\t\\t%-6s\\t\\t%-10s\\n\", phred, prob_error, ascii_phred33, ascii_phred64)) }","title":"Phred scores in FASTQ file"},{"location":"Phred_FQ/","text":"What is PHRED Scores A Phred score is a measure of the probability that a base call in a DNA sequencing read is incorrect. It is a logarithmic scale, meaning that a small change in the Phred score represents a large change in the probability of an error. $$Q = -10 \\cdot \\log_{10}(P)$$ Where: Q is the PHRED score. P is the probability that the base was called incorrectly. For example: Q = 20 : This corresponds to a 1 in 100 probability of an incorrect base call, or an accuracy of 99%. Q = 30 : This corresponds to a 1 in 1000 probability of an incorrect base call, or an accuracy of 99.9%. Q = 40 : This corresponds to a 1 in 10,000 probability of an incorrect base call, or an accuracy of 99.99%. # Print the header cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"Phred\", \"Prob of\")) cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"score\", \"Incorrect call\")) # Loop through Phred scores from 0 to 41 for (phred in 0:41) { cat(sprintf(\"%-5d\\t\\t%0.5f\\n\", phred, 10^(phred / -10))) } Phred Prob of score Incorrect call 0 1.00000 1 0.79433 2 0.63096 3 0.50119 4 0.39811 5 0.31623 6 0.25119 7 0.19953 8 0.15849 9 0.12589 10 0.10000 11 0.07943 12 0.06310 13 0.05012 14 0.03981 15 0.03162 16 0.02512 17 0.01995 18 0.01585 19 0.01259 20 0.01000 21 0.00794 22 0.00631 23 0.00501 24 0.00398 25 0.00316 26 0.00251 27 0.00200 28 0.00158 29 0.00126 30 0.00100 31 0.00079 32 0.00063 33 0.00050 34 0.00040 35 0.00032 36 0.00025 37 0.00020 38 0.00016 39 0.00013 40 0.00010 41 0.00008 What is ASCII ASCII (American Standard Code for Information Interchange) is used to represent characters in computers. We can represent Phred scores using ASCII characters. The advantage is that the quality information can be esisly stored in text based FASTQ file. Not all ASCII characters are printable. The first printable ASCII character is ! and the decimal code for the character for ! is 33. # Store output in a vector to fit on a slide output <- c(sprintf(\"%-8s %-8s\", \"Character\", \"ASCII #\")) # Loop through ASCII values from 33 to 89 for (i in 33:89) { output <- c(output, sprintf(\"%-8s %-8d\", intToUtf8(i), i)) } # Print the output in a single block (e.g., to fit on a slide) cat(paste(output, collapse = \"\\n\")) Character ASCII # ! 33 \" 34 # 35 $ 36 % 37 & 38 ' 39 ( 40 ) 41 * 42 + 43 , 44 - 45 . 46 / 47 0 48 1 49 2 50 3 51 4 52 5 53 6 54 7 55 8 56 9 57 : 58 ; 59 < 60 = 61 > 62 ? 63 @ 64 A 65 B 66 C 67 D 68 E 69 F 70 G 71 H 72 I 73 J 74 K 75 L 76 M 77 N 78 O 79 P 80 Q 81 R 82 S 83 T 84 U 85 V 86 W 87 X 88 Y 89 Phred scores in FASTQ file In a FASTQ file, Phred scores are represented as ASCII characters. These characters are converted back to numeric values (PHRED scores) based on the encoding scheme used: PHRED+33 Encoding (Sanger/Illumina 1.8+) : The ASCII character for a quality score Q is calculated as: ASCII character=chr(Q+33) For example: A PHRED score of 30 is encoded as chr(30 + 33) = chr(63) , which corresponds to the ASCII character ? . PHRED+64 Encoding (Illumina 1.3-1.7) : The ASCII character for a quality score QQQ is calculated as: ASCII character=chr(Q+64) For example: A PHRED score of 30 is encoded as chr(30 + 64) = chr(94) , which corresponds to the ASCII character ^ . # Print the header cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t\\t%-10s\\n\", \"Phred\", \"Prob. of\", \"ASCII\", \"ASCII\")) cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t%-10s\\n\", \"score\", \"Error\", \"Phred+33\", \"Phred+64\")) # Loop through Phred scores from 0 to 41 for (phred in 0:41) { # Calculate the probability of error prob_error <- 10^(phred / -10) # Convert Phred scores to ASCII characters ascii_phred33 <- intToUtf8(phred + 33) ascii_phred64 <- intToUtf8(phred + 64) # Print the results in a formatted table cat(sprintf(\"%-5d\\t\\t%0.5f\\t\\t%-6s\\t\\t%-10s\\n\", phred, prob_error, ascii_phred33, ascii_phred64)) } Phred Prob. of ASCII ASCII score Error Phred+33 Phred+64 0 1.00000 ! @ 1 0.79433 \" A 2 0.63096 # B 3 0.50119 $ C 4 0.39811 % D 5 0.31623 & E 6 0.25119 ' F 7 0.19953 ( G 8 0.15849 ) H 9 0.12589 * I 10 0.10000 + J 11 0.07943 , K 12 0.06310 - L 13 0.05012 . M 14 0.03981 / N 15 0.03162 0 O 16 0.02512 1 P 17 0.01995 2 Q 18 0.01585 3 R 19 0.01259 4 S 20 0.01000 5 T 21 0.00794 6 U 22 0.00631 7 V 23 0.00501 8 W 24 0.00398 9 X 25 0.00316 : Y 26 0.00251 ; Z 27 0.00200 < [ 28 0.00158 = \\ 29 0.00126 > ] 30 0.00100 ? ^ 31 0.00079 @ _ 32 0.00063 A ` 33 0.00050 B a 34 0.00040 C b 35 0.00032 D c 36 0.00025 E d 37 0.00020 F e 38 0.00016 G f 39 0.00013 H g 40 0.00010 I h 41 0.00008 J i","title":"Phred FQ"},{"location":"Phred_FQ/#what-is-phred-scores","text":"A Phred score is a measure of the probability that a base call in a DNA sequencing read is incorrect. It is a logarithmic scale, meaning that a small change in the Phred score represents a large change in the probability of an error. $$Q = -10 \\cdot \\log_{10}(P)$$ Where: Q is the PHRED score. P is the probability that the base was called incorrectly. For example: Q = 20 : This corresponds to a 1 in 100 probability of an incorrect base call, or an accuracy of 99%. Q = 30 : This corresponds to a 1 in 1000 probability of an incorrect base call, or an accuracy of 99.9%. Q = 40 : This corresponds to a 1 in 10,000 probability of an incorrect base call, or an accuracy of 99.99%. # Print the header cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"Phred\", \"Prob of\")) cat(sprintf(\"%-5s\\t\\t%-10s\\n\", \"score\", \"Incorrect call\")) # Loop through Phred scores from 0 to 41 for (phred in 0:41) { cat(sprintf(\"%-5d\\t\\t%0.5f\\n\", phred, 10^(phred / -10))) } Phred Prob of score Incorrect call 0 1.00000 1 0.79433 2 0.63096 3 0.50119 4 0.39811 5 0.31623 6 0.25119 7 0.19953 8 0.15849 9 0.12589 10 0.10000 11 0.07943 12 0.06310 13 0.05012 14 0.03981 15 0.03162 16 0.02512 17 0.01995 18 0.01585 19 0.01259 20 0.01000 21 0.00794 22 0.00631 23 0.00501 24 0.00398 25 0.00316 26 0.00251 27 0.00200 28 0.00158 29 0.00126 30 0.00100 31 0.00079 32 0.00063 33 0.00050 34 0.00040 35 0.00032 36 0.00025 37 0.00020 38 0.00016 39 0.00013 40 0.00010 41 0.00008","title":"What is PHRED Scores"},{"location":"Phred_FQ/#what-is-ascii","text":"ASCII (American Standard Code for Information Interchange) is used to represent characters in computers. We can represent Phred scores using ASCII characters. The advantage is that the quality information can be esisly stored in text based FASTQ file. Not all ASCII characters are printable. The first printable ASCII character is ! and the decimal code for the character for ! is 33. # Store output in a vector to fit on a slide output <- c(sprintf(\"%-8s %-8s\", \"Character\", \"ASCII #\")) # Loop through ASCII values from 33 to 89 for (i in 33:89) { output <- c(output, sprintf(\"%-8s %-8d\", intToUtf8(i), i)) } # Print the output in a single block (e.g., to fit on a slide) cat(paste(output, collapse = \"\\n\")) Character ASCII # ! 33 \" 34 # 35 $ 36 % 37 & 38 ' 39 ( 40 ) 41 * 42 + 43 , 44 - 45 . 46 / 47 0 48 1 49 2 50 3 51 4 52 5 53 6 54 7 55 8 56 9 57 : 58 ; 59 < 60 = 61 > 62 ? 63 @ 64 A 65 B 66 C 67 D 68 E 69 F 70 G 71 H 72 I 73 J 74 K 75 L 76 M 77 N 78 O 79 P 80 Q 81 R 82 S 83 T 84 U 85 V 86 W 87 X 88 Y 89","title":"What is ASCII"},{"location":"Phred_FQ/#phred-scores-in-fastq-file","text":"In a FASTQ file, Phred scores are represented as ASCII characters. These characters are converted back to numeric values (PHRED scores) based on the encoding scheme used: PHRED+33 Encoding (Sanger/Illumina 1.8+) : The ASCII character for a quality score Q is calculated as: ASCII character=chr(Q+33) For example: A PHRED score of 30 is encoded as chr(30 + 33) = chr(63) , which corresponds to the ASCII character ? . PHRED+64 Encoding (Illumina 1.3-1.7) : The ASCII character for a quality score QQQ is calculated as: ASCII character=chr(Q+64) For example: A PHRED score of 30 is encoded as chr(30 + 64) = chr(94) , which corresponds to the ASCII character ^ . # Print the header cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t\\t%-10s\\n\", \"Phred\", \"Prob. of\", \"ASCII\", \"ASCII\")) cat(sprintf(\"%-5s\\t\\t%-10s\\t%-6s\\t%-10s\\n\", \"score\", \"Error\", \"Phred+33\", \"Phred+64\")) # Loop through Phred scores from 0 to 41 for (phred in 0:41) { # Calculate the probability of error prob_error <- 10^(phred / -10) # Convert Phred scores to ASCII characters ascii_phred33 <- intToUtf8(phred + 33) ascii_phred64 <- intToUtf8(phred + 64) # Print the results in a formatted table cat(sprintf(\"%-5d\\t\\t%0.5f\\t\\t%-6s\\t\\t%-10s\\n\", phred, prob_error, ascii_phred33, ascii_phred64)) } Phred Prob. of ASCII ASCII score Error Phred+33 Phred+64 0 1.00000 ! @ 1 0.79433 \" A 2 0.63096 # B 3 0.50119 $ C 4 0.39811 % D 5 0.31623 & E 6 0.25119 ' F 7 0.19953 ( G 8 0.15849 ) H 9 0.12589 * I 10 0.10000 + J 11 0.07943 , K 12 0.06310 - L 13 0.05012 . M 14 0.03981 / N 15 0.03162 0 O 16 0.02512 1 P 17 0.01995 2 Q 18 0.01585 3 R 19 0.01259 4 S 20 0.01000 5 T 21 0.00794 6 U 22 0.00631 7 V 23 0.00501 8 W 24 0.00398 9 X 25 0.00316 : Y 26 0.00251 ; Z 27 0.00200 < [ 28 0.00158 = \\ 29 0.00126 > ] 30 0.00100 ? ^ 31 0.00079 @ _ 32 0.00063 A ` 33 0.00050 B a 34 0.00040 C b 35 0.00032 D c 36 0.00025 E d 37 0.00020 F e 38 0.00016 G f 39 0.00013 H g 40 0.00010 I h 41 0.00008 J i","title":"Phred scores in FASTQ file"},{"location":"basic_linux/","text":"Linux for Bioinformatics Navigating in Linux file system You are in your home directory after you log into the system and are directed to the shell command prompt. This section will show you hot to explore Linux file system using shell commands. Path To understand Linux file system, you can image it as a tree structure. In Linux, a path is a unique location of a file or a directory in the file system. For convenience, Linux file system is usually thought of in a tree structure. On a standard Linux system you will find the layout generally follows the scheme presented below. The tree of the file system starts at the trunk or slash, indicated by a forward slash ( / ). This directory, containing all underlying directories and files, is also called the root directory or \u201cthe root\u201d of the file system. %%bash ## In your account, you will see a folder ## with you account ID as the name cd ~ echo $HOME /home/xie186 Relative and absolute path Absolute path An absolute path is defined as the location of a file or directory from the root directory(/). An absolute path starts from the root of the tree ( / ). Here are some examples: /home/xie186 /home/xie186/.bashrc Relative path Relative path is a path related to the present working directory: data/sample1/ and ../doc/ . If you want to get the absolute path based on relative path , you can use readlink with parameter -f : pwd readlink -f ../ Once we enter into a Linux file system, we need to 1) know where we are; 2) how to get where we want; 3) how to know what files or directories we have in a particular path. Check where you are using command pwd In order to know where we are, we need to use pwd command. The command pwd is short for \u201cprint name of current/working directory\u201d. It will return the full path of current directory. Command pwd is almost always used by itself. This means you only need to type pwd and press ENTER %%bash pwd Listing the contents using command ls After you know where you are, then you want to know what you have in that directory, we can use command ls to list directory contents Its syntax is: ls [option]... [file]... ls with no option will list files and directories in bare format. Bare format means the detailed information (type, size, modified date and time, permissions and links etc) won\u2019t be viewed. When you use ls by itself, it will list files and directories in the current directory. ls ~/ ls -a ls -ld Linux command options can be combined without a space between them and with a single - (dash). The following command is a faster way to use the l and a options and gives the same output as the Linux command shown above. ls -lt ~/.bashrc -rw-r--r--. 1 xie186 zt-bioi611 1067 Aug 22 22:27 /home/xie186/.bashrc Change directory using command cd Unlike pwd , when you use cd you usually need to provide the path (either absolute or relative path) which we want to enter. If you didn\u2019t provide any path information, you will change to home directory by default. Path Shortcuts Description Single dot . The current folder Double dots .. The folder above the current folder Tilde character ~ Home directory (normally the directory:/home/my_login_name) Dash - Your last working directory Here are some examples: cd ~ pwd ls ls ../ ## pwd cd ../ pwd cd ./ pwd Each directory has two entries in it at the start, with names . (a link to itself) and .. (a link to its parent directory). The exception, of course, is the root directory, where the .. directory also refers to the root directory. Sometimes you go to a new directory and do something, then you remember that you need to go to the previous working direcotry. To get back instantly, use a dash. %%bash # This is our current directory pwd # Let us go our home diretory cd ~ # Check where we are pwd # Let us go to your previous working directory cd - # Check where we are now pwd /home/xie186/BIOI611_lab/docs /home/xie186 /home/xie186/BIOI611_lab/docs /home/xie186/BIOI611_lab/docs Manipulations of files and directories In Linux, manipulations of files and directories are the most frequent work. In this section, you will learn how to copy, rename, remove, and create files and directories. Command line cp In Linux, command cp can help you copy files and directories into a target directory. Command line mv Move files/folders and rename file/folders using mv : # move file from one location to another mv file1 target_direcotry/ # rename mv file1 file2 mv file1 file2 file3 target_direcotry/ Command mkdir The syntax is shown as below: mkdir [OPTION ...] DIRECTORY ... Multiple directories can be specified when calling mkdir mkdir directory1 directory2 mkdir -p foo/bar/baz How to defining complex directory trees with one command: mkdir -p project/{software,results,doc/{html,info,pdf},scripts} Then you can view the directory using tree . Command rm You can use rm to remove both files and directories. ## You can remove one file. rm file1 ## `rm` can remove multiple files simutaneously rm file2 file3 You can also use 'rm' to remove a folder. If a folder is empty, you can remove it using rm with -r . rm -r FOLDER If a folder is not empty, you can remove it using rm with -r and -f . mkdir test_folder rm -r test_folder View text files in Linux Commands cat , more and less The command cat is short for concatenate files and print on the standard output. The syntax is shown as below: cat [OPTION]... [FILE]... For small text file, cat can be used to view the files on the standard output. The command more is old utility. When the text passed to it is too large to fit on one screen, it pages it. You can scroll down but not up. The syntaxt of more is shown below: more [options] file [...] The command less was written by a man who was fed up with more\u2019s inability to scroll backwards through a file. He turned less into an open source project and over time, various individuals added new features to it. less is massive now. That\u2019s why some small embedded systems have more but not less. For comparison, less\u2019s source is over 27000 lines long. more implementations are generally only a little over 2000 lines long. The syntaxt of less is shown below: less [options] file [...] Command head and tail The command head is used to output the first part of files. By default, it outputs the first 10 lines of the file. head [OPTION]... [FILE]... Here is an exmaple of printing the first 5 files of the file: head -n 5 code_perl/variable_assign.pl In fact, the letter n does not even need to be used at all. Just the hyphen and the integer (with no intervening space) are sufficient to tell head how many lines to return. Thus, the following would produce the same result as the above commands: head -5 target_file.txt The command tail is used to output the last part of files. By default, it prints the last 10 lines of the file to standard output. The syntax is shown below: tail [OPTION]... [FILE]... Here is an exmaple of printing the last 5 files of the file: tail -5 target_file.txt To view lines from a specific point in a file, you can use -n +NUMBER with the tail command. For example, here is an example of viewing the file from the 2nd line of the line. tail -n +2 target_file.txt Auto-completion In most Shell environment, programmable completion feature will also improve your speed of typing. It permits typing a partial name of command or a partial file (or directory), then pressing TAB key to auto-complete the command. If there are more than one possible completions, then TAB will list all of them. A handy autocomplete feature also exists. Type one or more letters, press the Tab key twice, and then a list of functions starting with these letters appears. For example: type so , press the Tab key twice, and then you get the list as: soelim sort sotruss soundstretch source Demonstration of programmable completion feature. File permissions In Linux, file permissions are a vital aspect of system security and resource management. This is particularly important in bioinformatics, where large datasets and scripts are often shared across teams. Permissions determine who can read, write, or execute a file, ensuring that critical data is not accidentally modified or deleted. Three Permission Categories : User (u): The owner of the file. Group (g): A group of users who share access to the file. Other (o): All other users on the system. Permission Types : Read (r): Ability to view the contents of a file. Write (w): Ability to modify or delete the file. Execute (x): Ability to run the file as a program (for scripts or executables). %%bash groups $USER animako eunal gstewar1 mjames17 mjeakle nmilza rahooper xie186 : zt-bioi611 zt-bioi611_mgr animako : zt-bioi611 eunal : zt-bioi611 gstewar1 : zt-bioi611 mjames17 : zt-bioi611 mjeakle : zt-bioi611 nmilza : zt-bioi611 rahooper : zt-bioi611 %%bash mkdir -p ~/test_permission/ touch ~/test_permission/test.txt ls -l ~/test_permission/ rm -rf ~/test_permission/ total 0 -rw-r--r--. 1 xie186 zt-bioi611 0 Sep 8 22:52 test.txt Here, the first character represents the type of file (e.g., - for a regular file or d for a directory), followed by three groups of three characters, each representing the permissions for the user , group , and others , respectively. Examples: -rwxr-xr-- : The owner has read , write , and execute permissions. The group has read and execute permissions, while others can only read the file. drwxr-x--- : A directory where the owner can read, write, and access (execute). The group can only read and access, while others have no permissions. Modify file permissions using the chmod command. Permissions can be set in two ways: Symbolic Mode: In symbolic mode, you modify permissions by referencing the categories (user, group, other) and specifying whether you're adding (+), removing (-), or setting (=) permissions. # Add execute permission for the user: chmod u+x filename # Remove write permission for the group: chmod g-w filename # Set read-only permission for others: chmod o=r filename Symbolic mode is intuitive and flexible, especially when you want to make precise adjustments to permissions without affecting other categories. This is useful for common file-sharing tasks in bioinformatics where you need to tweak access for specific collaborators. Numeric Mode (Octal representation): In numeric mode, file permissions are set using a three-digit number. Each digit represents the permissions for user , group , and other , respectively. The digits are calculated by adding the values of the read , write , and execute` permissions: Read (r) = 4 Write (w) = 2 Execute (x) = 1 Example Permission Breakdown: Read (r), Write (w), and Execute (x) for user = 7 Read (r) and Execute (x) for group = 5 Read (r) only for others = 4 chmod 754 filename An example to help you understand executable : %%bash printf '#!/user/bin/python\\nprint(\"Hello, Welcome to Course BIOI611!\")' > ~/test.py %%bash ls -l ~/test.py python ~/test.py -rw-r--r--. 1 xie186 zt-bioi611 61 Sep 8 23:06 /home/xie186/test.py Hello, Welcome to Course BIOI611! Error message below will be thrown out if you consider ~/test.py as a program: bash: line 1: /home/xie186/test.py: No such file or directory %%bash chmod u+x ~/test.py ls -l ~/test.py python ~/test.py rm ~/test.py -rwxr--r--. 1 xie186 zt-bioi611 61 Sep 8 23:06 /home/xie186/test.py Hello, Welcome to Course BIOI611! Disk Usage of Files and Directories The Linux du (short for Disk Usage) is a standard Unix/Linux command, used to check the information of disk usage of files and directories on a machine. The du command has many parameter options that can be used to get the results in many formats. The du command also displays the files and directory sizes in a recursively manner. %%bash du -h ~/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref 2.5G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref %%bash du -ah ~/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref 2.9M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbList.fromGTF.out.tab 7.5K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/Log.out 936M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/SA 1.5G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/SAindex 3.0M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/transcriptInfo.tab 2.3M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbList.out.tab 1.5M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/geneInfo.tab 1.0K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/genomeParameters.txt 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrLength.txt 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrNameLength.txt 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrStart.txt 7.6M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/exonGeTrInfo.tab 3.1M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/exonInfo.tab 2.8M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbInfo.txt 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrName.txt 119M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/Genome 2.5G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref %%bash du -csh /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/* 19G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/raw_data 0 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/raw_data_smart_seq 1.5K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_data.sub 575K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq-7478223-xie186.err 0 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq-7478223-xie186.out 8.5K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq.sub 2.5K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s2_star.sub 34G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_align 2.5G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/test.sub 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/test.txt 55G total Symbolic link Symbolic link, similar to shortcuts, can point to another file/folder. ln -s ls -l unlink File Management and Data Handling Compressing and decompressing files (gzip, gunzip, tar). Compress one file: %%bash perl -e 'for($i=0; $i<10000; ++$i){ print \"test\\n\";}' > test.txt du -h test.txt gzip test.txt du -h test.txt.gz gunzip test.txt ls test.txt rm test.txt 52K test.txt 4.0K test.txt.gz test.txt Compress multiple files: %%bash perl -e 'for($i=0; $i<10000; ++$i){ print \"test\\n\";}' > test1.txt perl -e 'for($i=0; $i<10000; ++$i){ print \"test\\n\";}' > test2.txt du -h test1.txt test2.txt tar zcvf test.tar.gz test1.txt test2.txt du -sh test.tar.gz ls test1.txt test2.txt 52K test1.txt 52K test2.txt test1.txt test2.txt 4.0K test.tar.gz test1.txt test2.txt z : This option tells tar to compress the archive using gzip. The resulting archive will have a .gz extension to indicate that it has been compressed with the gzip utility. c : This option stands for create. It instructs tar to create a new archive. v : This stands for verbose. When used, tar will display detailed information about the files being added to the archive, such as their names. f : This stands for file. It tells tar that the next argument (test.tar.gz) is the name of the archive file to create. %%bash tar tvf test.tar.gz rm test.tar.gz test1.txt test2.txt -rw-r--r-- xie186/zt-bioi611 50000 2024-08-25 21:52 test1.txt -rw-r--r-- xie186/zt-bioi611 50000 2024-08-25 21:52 test2.txt t : List the contents of archive.tar. v : Display additional details about each file (like file permissions, size, and modification date). f : Specifies that archive.tar is the archive file to operate on. To uncompress a tar.gz file, use tar zxvf : tar zxvf test.tar.gz Transferring files within the network Basic Syntax of scp : scp [options] source destination Copy a Local File to a Remote Server scp file.txt username@remote_host:/path/to/destination/ Alternative command is rsync . File searching, filtering, and text processing Command find The find command is designed for comprehensive file and directory sesarches. find [path] [options] [expression] %%bash find /home/xie186/scratch/bioi611/bulk_RNAseq -name \"*.fastq.gz\" /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep3.fastq.gz /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep3.fastq.gz /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep1.fastq.gz /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep1.fastq.gz /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep2.fastq.gz /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep2.fastq.gz Text data counts wc %%bash find /home/xie186/scratch/bioi611/bulk_RNAseq -name \"*.fastq.gz\" |wc -l 6 Pipe | In Linux and Unix-based systems, the pipe ( | ) is used in the command line to redirect the output of one command as the input to another command. This allows you to chain commands together and perform more complex tasks in a single line. %%bash grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa |wc -l 7 Column filering Command cut can be used to print selected parts of lines from each FILE to standard output. %%bash wget -O GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz \"https://ncbi.nlm.nih.gov/geo/download/?type=rnaseq_counts&acc=GSE102537&format=file&file=GSE102537_raw_counts_GRCh38.p13_NCBI.tsv.gz\" --2024-08-25 21:08:03-- https://ncbi.nlm.nih.gov/geo/download/?type=rnaseq_counts&acc=GSE102537&format=file&file=GSE102537_raw_counts_GRCh38.p13_NCBI.tsv.gz Resolving ncbi.nlm.nih.gov (ncbi.nlm.nih.gov)... 2607:f220:41e:4290::110, 130.14.29.110 Connecting to ncbi.nlm.nih.gov (ncbi.nlm.nih.gov)|2607:f220:41e:4290::110|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 349584 (341K) [application/octet-stream] Saving to: \u2018GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz\u2019 0K .......... .......... .......... .......... .......... 14% 6.66M 0s 50K .......... .......... .......... .......... .......... 29% 16.9M 0s 100K .......... .......... .......... .......... .......... 43% 27.5M 0s 150K .......... .......... .......... .......... .......... 58% 10.1M 0s 200K .......... .......... .......... .......... .......... 73% 17.2M 0s 250K .......... .......... .......... .......... .......... 87% 37.6M 0s 300K .......... .......... .......... .......... . 100% 10.5M=0.02s 2024-08-25 21:08:04 (13.4 MB/s) - \u2018GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz\u2019 saved [349584/349584] %%bash zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |head GeneID GSM2740270 GSM2740272 GSM2740273 GSM2740274 GSM2740275 100287102 9 17 14 14 19 653635 336 470 467 310 370 102466751 8 56 46 31 31 107985730 0 2 2 3 3 100302278 0 1 0 0 2 645520 0 3 8 4 7 79501 0 2 2 1 4 100996442 16 25 34 20 28 729737 19 39 33 22 26 %%bash zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |cut -f1,2,3 |head GeneID GSM2740270 GSM2740272 100287102 9 17 653635 336 470 102466751 8 56 107985730 0 2 100302278 0 1 645520 0 3 79501 0 2 100996442 16 25 729737 19 39 Row filtering %%bash grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa >I dna:chromosome chromosome:WBcel235:I:1:15072434:1 REF >II dna:chromosome chromosome:WBcel235:II:1:15279421:1 REF >III dna:chromosome chromosome:WBcel235:III:1:13783801:1 REF >IV dna:chromosome chromosome:WBcel235:IV:1:17493829:1 REF >V dna:chromosome chromosome:WBcel235:V:1:20924180:1 REF >X dna:chromosome chromosome:WBcel235:X:1:17718942:1 REF >MtDNA dna:chromosome chromosome:WBcel235:MtDNA:1:13794:1 REF %%bash zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |wc -l zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |awk '$2>500' |wc -l zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |awk '$2>500 && $3>500' |wc -l 39377 8773 3820 Text processing %%bash grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa |sed 's/>//' |sed 's/ .*//' I II III IV V X MtDNA Regular Expressions Regular expressions are sequences of characters that define search patterns. They are commonly used for string matching, searching, and text processing. Regex is used in text editors, programming languages, command-line tools (like grep and sed ), and many bioinformatics tools to search, replace, or extract data from text. Metacharacters: Special characters that have specific meanings in regex syntax. . (dot): Matches any single character except a newline. Example: A.G matches \"AAG\", \"ATG\", \"ACG\", etc. ^ : Matches the start of a line. Example: ^A matches any line starting with \"A\". $ : Matches the end of a line. Example: end$ matches any line ending with \"end\". * : Matches 0 or more occurrences of the preceding character. Example: ca*t matches \"ct\", \"cat\", \"caat\", \"caaat\", etc. + : Matches 1 or more occurrences of the preceding character. Example: ca+t matches \"cat\", \"caat\", \"caaat\", etc. ? : Matches 0 or 1 occurrence of the preceding character. Example: colou?r matches both \"color\" and \"colour\". [] : Matches any one of the characters inside the brackets. Example: [aeiou] matches any vowel. | : Alternation (OR) operator. Example: cat|dog matches either \"cat\" or \"dog\". Character Classes: Represents a set of characters. \\d : Matches any digit (equivalent to [0-9]). \\w : Matches any word character (alphanumeric or underscore). \\s : Matches any whitespace character (spaces, tabs, etc.). \\D : Matches any non-digit character. \\W : Matches any non-word character. \\S : Matches any non-whitespace character. Quantifiers: Specify the number of occurrences to match {n} : Matches exactly n occurrences. Example: A{3} matches \"AAA\". {n,} : Matches n or more occurrences. Example: T{2,} matches \"TT\", \"TTT\", \"TTTT\", etc. {n,m} : Matches between n and m occurrences. Example: G{1,3} matches \"G\", \"GG\", or \"GGG\". An example of the command line used %%bash grep -v '#' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.111.gtf \\ |awk '$3==\"gene\"' \\ |sed 's/.*gene_biotype \"//' \\ |sed 's/\";//'|sort |uniq -c \\ | sort -k1,1n 22 rRNA 100 antisense_RNA 129 snRNA 194 lincRNA 261 miRNA 346 snoRNA 634 tRNA 2128 pseudogene 7764 ncRNA 15363 piRNA 19985 protein_coding Environment variables Environment variables are dynamic values that affect the behavior of processes and programs in Linux. They are commonly used to store configuration data and are essential in bioinformatics workflows for defining paths to software, libraries, and datasets. Commonly Used Environment Variables: PATH : The PATH variable specifies directories where the system looks for executable files when a command is run. %%bash echo $PATH /cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/texlive/bin/x86_64-linux:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/imagemagick/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/graphviz/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/ghostscript/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/ffmpeg/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/mpi-nocuda/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/nompi-nocuda/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/linux-rhel8-x86_64/gcc-rh8-8.5.0/gcc-11.3.0-oedkmii7vhd6rbnqm6xufmg7d3jx4w6l/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/linux-rhel8-zen2/gcc-11.3.0/py-jupyter-1.0.0-trwwgzwljql55mhmaygcuxb3nvaevjsu/bin:/software/acigs-utilities/bin:/home/xie186/miniforge3/bin:/home/xie186/miniforge3/condabin:/home/xie186/SHELL.bioi611/software/STAR_2.7.11b/Linux_x86_64_static:/home/xie186/.local/bin:/home/xie186/bin:/software/acigs-utilities/bin:/usr/share/Modules/bin:/usr/lib/heimdal/bin:/usr/local/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/opt/symas/bin:/opt/dell/srvadmin/bin HOME : The HOME variable stores the path to the user\u2019s home directory. %%bash echo $HOME /home/xie186 %%bash echo $SHELL /bin/bash Setting Environment Variables: Temporarily setting a variable (valid only for the current shell session): export PATH=value:PATH Permanently setting a variable: To make the environment variable persistent across sessions, it needs to be added to configuration files like .bashrc or .bash_profile . Example: Add the following line to .bashrc : Software installation Installation via Conda Conda is a popular package management system, especially in bioinformatics, due to its ability to create isolated environments. This is crucial when working with tools that have conflicting dependencies. Install conda/miniforge Go to: https://github.com/conda-forge/miniforge/releases Download the corresponding installtion file %%bash uname -m x86_64 wget https://github.com/conda-forge/miniforge/releases/download/24.7.1-0/Mambaforge-24.7.1-0-Linux-x86_64.sh Create conda environment and install software conda create -n bioi611 conda activate bioi611 conda install bioconda::fastqc==0.11.8 Installation via Source Code (Manual Compilation) git clone https://github.com/lh3/bwa.git cd bwa; make ./bwa index ref.fa Using Container for Bioinformatics Tools https://hub.docker.com/r/biocontainers/bwa/ module load singularity singularity build bwa_v0.7.17_cv1.sif docker://biocontainers/bwa:v0.7.17_cv1 Text editor in Linux In Linux, we sometimes need to create or edit a text file like writing a new perl script. So we need to use text editor. As a newbie, someone would prefer a basic, GUI-based text editor with menus and traditional CUA key bindings. Here we recommend Sublime , ATOM and Notepad++ . But GUI-based text editor is not always available in Linux. A powerful screen text editor vi (pronounced \u201cvee-eye\u201d) is available on nearly all Linux system. We highly recommend vi as a text editor, because something we\u2019ll have to edit a text file on a system without a friendlier text editor. Once we get familiar with vi , we\u2019ll find that it\u2019s very fast and powerful. But remember, it\u2019s OK if you think this part is too difficult at the beginning. You can use either Sublime , ATOM or Notepad++ . If you are connecting to a Linux system without Sublime , ATOM and Notepad++ , you can write the file in a local computer and then upload the file onto Linux system. Basic vi skills As vi uses a lot of combination of keystrokes, it may be not easy for newbies to remember all the combinations in one fell swoop. Considering this, we\u2019ll first introduce the basic skills someone needs to know to use vi . We need to first understand how three modes of vi work and then try to remember a few basic vi commonds. Then we can use these skills to write Perl or R scripts in the following chaptors for Perl and R (Figure \\@ref(fig:workingModeVi)). Three modes of vi : Create new text file with vi mkdir test_vi ## generate a new folder cd test_vi ## go into the new folder echo \"Using \\`ls\\` we don't expect files in this folder.\" ls echo \"No file displayed!\" Using the code above, we made a new directory named test_vi . We didn't see any file. If we type vi test.py , an empty file and screen are created into which you may enter text because the file does not exist((Figure \\@ref(fig:ViNewFile))). vi test.py A screentshot of the vi test.py . Now if you are in vi mode . To go to Input mode , you can type i , 'a' or 'o' (Figure \\@ref(fig:ViInpuMode)). A screentshot of the vi test.py . Now you can type the content (codes or other information) (\\@ref(fig:ViInpuType)). Once you are done typing. You need to go to Command mode (Figure \\@ref(fig:workingModeVi)) if you want to save and exit the file. To do this, you need to press ESC button on the keyboard. Now we just wrote a Perl script. We can run this script. python test.py High-Performance Computing (HPC) for Bioinformatics HPC resources enable bioinformatics analyses that require significant computational power and memory. Basics of HPC clusters and job schedulers (SLURM). An example of an job file ( s1_star.sh ): #!/bin/bash #SBATCH --partition=standard #SBATCH -t 40:00:00 #SBATCH -n 1 #SBATCH -c 20 #SBATCH --job-name=s1_star_aln #SBATCH --mail-type=FAIL,BEGIN,END #SBATCH --error=%x-%J-%u.err #SBATCH --output=%x-%J-%u.out conda activate bioi611 mkdir -p STAR_align/ STAR --genomeDir STAR_ref \\ --outSAMtype BAM SortedByCoordinate \\ --twopassMode Basic \\ --quantMode TranscriptomeSAM GeneCounts \\ --readFilesCommand zcat \\ --outFileNamePrefix STAR_align/N2_day1_rep1. \\ --runThreadN 20 \\ --readFilesIn raw_data/N2_day1_rep1.fastq.gz To submit this job, run: sbatch s1_star.sh Check quota infomation %%bash scratch_quota # shell_quota # Group quotas Group name Space used Space quota % quota used zt-bioi611 285.811 MB 4.000 TB 0.01% zt-bioi611_mgr 98.163 GB unlimited 0 total 98.449 GB unlimited 0 # User quotas User name Space used Space quota % quota used % of GrpTotal xie186 98.449 GB unlimited 0 100.00% View information about Slurm nodes and partitions. %%bash sinfo PARTITION AVAIL TIMELIMIT NODES STATE NODELIST debug up 15:00 1 maint compute-b8-60 debug up 15:00 1 drng compute-b8-57 debug up 15:00 1 mix compute-b8-59 debug up 15:00 1 alloc compute-b8-58 scavenger up 14-00:00:0 1 inval compute-b8-48 scavenger up 14-00:00:0 4 drain$ compute-b8-[53-56] scavenger up 14-00:00:0 84 maint compute-a7-[5,9,14-16,28,49],compute-a8-[2-4,8-9,15,18,22,24,29,37,44,51],compute-b5-[4,16,26,29-30,33,44,51-52],compute-b6-[7,12,21,28-29,32,34,43-46,50-51,59],compute-b7-[12-13,19-22,25,27,29,31,35,37,39,42,45-46,49-50,54,56-59],compute-b8-[16,19,21,23-24,29,32,35-37,39-45,60] scavenger up 14-00:00:0 2 drain* compute-a7-[13,43] scavenger up 14-00:00:0 13 drng compute-a8-[7,14],compute-b7-[14-15,18,38,43-44],compute-b8-[2,20,51,57],gpu-b9-5 scavenger up 14-00:00:0 2 drain compute-a7-8,gpu-b10-5 scavenger up 14-00:00:0 182 mix bigmem-a9-[1-2,4-5],compute-a5-[3-11],compute-a7-[2-3,6-7,10,12,17-19,21-22,30,38-40,45-46,48,54-56,60],compute-a8-[5-6,10-12,16-17,19-21,25,28,31-35,39,41,45,47,50,52,54,57-59],compute-b5-[1-3,5-8,11,13-15,17-25,27-28,31-32,34-43,45-50,53-55,57-58],compute-b6-[1-5,14-15,17-20,22-24,35-36,48-49,52,54],compute-b7-[1,7-8,16-17,23-24,26,28,30,32-34,36,40-41,47-48,51-52,55,60],compute-b8-[1,15,17-18,22,25-27,30-31,33,46-47,49-50,59],gpu-b9-[1-4,6-7],gpu-b10-[1-3,6-7],gpu-b11-[1-6] scavenger up 14-00:00:0 93 alloc bigmem-a9-[3,6],compute-a7-[1,4,11,20,23-27,29,31-37,41-42,44,47,50-53,57-59],compute-a8-[1,13,23,26-27,30,36,38,40,42-43,46,48-49,53,55-56,60],compute-b5-[9-10,12,56,59-60],compute-b6-[6,8-11,13,16,27,30-31,58,60],compute-b7-[2-6,9-11,53],compute-b8-[3-14,28,34,38,52,58],gpu-b10-4 scavenger up 14-00:00:0 14 idle compute-b6-[25-26,33,37-42,47,53,55-57] standard* up 7-00:00:00 1 inval compute-b8-48 standard* up 7-00:00:00 4 drain$ compute-b8-[53-56] standard* up 7-00:00:00 82 maint compute-a7-[5,9,14-16,28,49],compute-a8-[2-4,8-9,15,18,22,24,29,37,44,51],compute-b5-[4,16,26,29-30,33,44,51-52],compute-b6-[7,12,21,28-29,32,34,43-46,50-51],compute-b7-[12-13,19-22,25,27,29,31,35,37,39,42,45-46,49-50,54,56-59],compute-b8-[16,19,21,23-24,29,32,35-37,39-45] standard* up 7-00:00:00 2 drain* compute-a7-[13,43] standard* up 7-00:00:00 11 drng compute-a8-[7,14],compute-b7-[14-15,18,38,43-44],compute-b8-[2,20,51] standard* up 7-00:00:00 1 drain compute-a7-8 standard* up 7-00:00:00 159 mix compute-a5-[3-11],compute-a7-[2-3,6-7,10,12,17-19,21-22,30,38-40,45-46,48,54-56,60],compute-a8-[5-6,10-12,16-17,19-21,25,28,31-35,39,41,45,47,50,52,54,57-59],compute-b5-[1-3,5-8,11,13-15,17-25,27-28,31-32,34-43,45-50,53-55,57-58],compute-b6-[1-5,14-15,17-20,22-24,35-36,48-49,52],compute-b7-[1,7-8,16-17,23-24,26,28,30,32-34,36,40-41,47-48,51-52,55,60],compute-b8-[1,15,17-18,22,25-27,30-31,33,46-47,49-50] standard* up 7-00:00:00 87 alloc compute-a7-[1,4,11,20,23-27,29,31-37,41-42,44,47,50-53,57-59],compute-a8-[1,13,23,26-27,30,36,38,40,42-43,46,48-49,53,55-56,60],compute-b5-[9-10,12,56,59-60],compute-b6-[6,8-11,13,16,27,30-31],compute-b7-[2-6,9-11,53],compute-b8-[3-14,28,34,38,52] standard* up 7-00:00:00 10 idle compute-b6-[25-26,33,37-42,47] serial up 14-00:00:0 1 maint compute-b6-59 serial up 14-00:00:0 1 mix compute-b6-54 serial up 14-00:00:0 2 alloc compute-b6-[58,60] serial up 14-00:00:0 4 idle compute-b6-[53,55-57] gpu up 7-00:00:00 1 down$ gpu-a6-3 gpu up 7-00:00:00 1 drng gpu-b9-5 gpu up 7-00:00:00 1 drain gpu-b10-5 gpu up 7-00:00:00 19 mix gpu-a6-[6,8],gpu-b9-[1-4,6-7],gpu-b10-[1-3,6-7],gpu-b11-[1-6] gpu up 7-00:00:00 1 alloc gpu-b10-4 gpu up 7-00:00:00 6 idle gpu-a5-1,gpu-a6-[2,4-5,7,9] bigmem up 7-00:00:00 4 mix bigmem-a9-[1-2,4-5] bigmem up 7-00:00:00 2 alloc bigmem-a9-[3,6] Check partitial information %%bash scontrol show partition standard PartitionName=standard AllowGroups=ALL AllowAccounts=ALL AllowQos=ALL AllocNodes=ALL Default=YES QoS=N/A DefaultTime=00:15:00 DisableRootJobs=NO ExclusiveUser=NO GraceTime=0 Hidden=NO MaxNodes=UNLIMITED MaxTime=7-00:00:00 MinNodes=0 LLN=NO MaxCPUsPerNode=UNLIMITED MaxCPUsPerSocket=UNLIMITED Nodes=compute-a5-[3-11],compute-a7-[1-60],compute-a8-[1-60],compute-b5-[1-60],compute-b6-[1-52],compute-b7-[1-60],compute-b8-[1-56] PriorityJobFactor=1 PriorityTier=1 RootOnly=NO ReqResv=NO OverSubscribe=YES:4 OverTimeLimit=NONE PreemptMode=REQUEUE State=UP TotalCPUs=45696 TotalNodes=357 SelectTypeParameters=NONE JobDefaults=(null) DefMemPerNode=UNLIMITED MaxMemPerNode=UNLIMITED TRES=cpu=45696,mem=178500G,node=357,billing=45696 TRESBillingWeights=CPU=1.0,Mem=0.25G Display node config information %%bash scontrol show node compute-a5-3 NodeName=compute-a5-3 Arch=x86_64 CoresPerSocket=64 CPUAlloc=71 CPUEfctv=128 CPUTot=128 CPULoad=68.89 AvailableFeatures=rhel8,amd,epyc_7702,ib ActiveFeatures=rhel8,amd,epyc_7702,ib Gres=(null) NodeAddr=compute-a5-3 NodeHostName=compute-a5-3 Version=23.11.9 OS=Linux 4.18.0-553.5.1.el8_10.x86_64 #1 SMP Tue May 21 03:13:04 EDT 2024 RealMemory=512000 AllocMem=296960 FreeMem=326630 Sockets=2 Boards=1 State=MIXED ThreadsPerCore=1 TmpDisk=300000 Weight=1 Owner=N/A MCS_label=N/A Partitions=scavenger,standard BootTime=2024-08-08T18:32:48 SlurmdStartTime=2024-08-12T17:43:23 LastBusyTime=2024-08-12T17:43:19 ResumeAfterTime=None CfgTRES=cpu=128,mem=500G,billing=128 AllocTRES=cpu=71,mem=290G CapWatts=n/a CurrentWatts=630 AveWatts=294 ExtSensorsJoules=n/a ExtSensorsWatts=0 ExtSensorsTemp=n/a CPU Details: * Total CPUs: 128 * Allocated CPUs: 71 Memory: * Total Memory: 500 GB * Allocated Memory: 290 GB * Free Memory: ~319 GB View information about jobs located in the Slurm scheduling queue. %%bash squeue -u $USER JOBID PARTITION NAME USER ST TIME NODES NODELIST(REASON) 7563417 standard sys/dash xie186 R 48:15 1 compute-a5-5 Cancel a job %%bash scancel ","title":"Basic Linux"},{"location":"basic_linux/#linux-for-bioinformatics","text":"","title":"Linux for Bioinformatics"},{"location":"basic_linux/#navigating-in-linux-file-system","text":"You are in your home directory after you log into the system and are directed to the shell command prompt. This section will show you hot to explore Linux file system using shell commands.","title":"Navigating in Linux file system"},{"location":"basic_linux/#path","text":"To understand Linux file system, you can image it as a tree structure. In Linux, a path is a unique location of a file or a directory in the file system. For convenience, Linux file system is usually thought of in a tree structure. On a standard Linux system you will find the layout generally follows the scheme presented below. The tree of the file system starts at the trunk or slash, indicated by a forward slash ( / ). This directory, containing all underlying directories and files, is also called the root directory or \u201cthe root\u201d of the file system. %%bash ## In your account, you will see a folder ## with you account ID as the name cd ~ echo $HOME /home/xie186","title":"Path"},{"location":"basic_linux/#relative-and-absolute-path","text":"Absolute path An absolute path is defined as the location of a file or directory from the root directory(/). An absolute path starts from the root of the tree ( / ). Here are some examples: /home/xie186 /home/xie186/.bashrc Relative path Relative path is a path related to the present working directory: data/sample1/ and ../doc/ . If you want to get the absolute path based on relative path , you can use readlink with parameter -f : pwd readlink -f ../ Once we enter into a Linux file system, we need to 1) know where we are; 2) how to get where we want; 3) how to know what files or directories we have in a particular path.","title":"Relative and absolute path"},{"location":"basic_linux/#check-where-you-are-using-command-pwd","text":"In order to know where we are, we need to use pwd command. The command pwd is short for \u201cprint name of current/working directory\u201d. It will return the full path of current directory. Command pwd is almost always used by itself. This means you only need to type pwd and press ENTER %%bash pwd","title":"Check where you are using command pwd"},{"location":"basic_linux/#listing-the-contents-using-command-ls","text":"After you know where you are, then you want to know what you have in that directory, we can use command ls to list directory contents Its syntax is: ls [option]... [file]... ls with no option will list files and directories in bare format. Bare format means the detailed information (type, size, modified date and time, permissions and links etc) won\u2019t be viewed. When you use ls by itself, it will list files and directories in the current directory. ls ~/ ls -a ls -ld Linux command options can be combined without a space between them and with a single - (dash). The following command is a faster way to use the l and a options and gives the same output as the Linux command shown above. ls -lt ~/.bashrc -rw-r--r--. 1 xie186 zt-bioi611 1067 Aug 22 22:27 /home/xie186/.bashrc","title":"Listing the contents using command ls"},{"location":"basic_linux/#change-directory-using-command-cd","text":"Unlike pwd , when you use cd you usually need to provide the path (either absolute or relative path) which we want to enter. If you didn\u2019t provide any path information, you will change to home directory by default. Path Shortcuts Description Single dot . The current folder Double dots .. The folder above the current folder Tilde character ~ Home directory (normally the directory:/home/my_login_name) Dash - Your last working directory Here are some examples: cd ~ pwd ls ls ../ ## pwd cd ../ pwd cd ./ pwd Each directory has two entries in it at the start, with names . (a link to itself) and .. (a link to its parent directory). The exception, of course, is the root directory, where the .. directory also refers to the root directory. Sometimes you go to a new directory and do something, then you remember that you need to go to the previous working direcotry. To get back instantly, use a dash. %%bash # This is our current directory pwd # Let us go our home diretory cd ~ # Check where we are pwd # Let us go to your previous working directory cd - # Check where we are now pwd /home/xie186/BIOI611_lab/docs /home/xie186 /home/xie186/BIOI611_lab/docs /home/xie186/BIOI611_lab/docs","title":"Change directory using command cd"},{"location":"basic_linux/#manipulations-of-files-and-directories","text":"In Linux, manipulations of files and directories are the most frequent work. In this section, you will learn how to copy, rename, remove, and create files and directories.","title":"Manipulations of files and directories"},{"location":"basic_linux/#command-line-cp","text":"In Linux, command cp can help you copy files and directories into a target directory.","title":"Command line cp"},{"location":"basic_linux/#command-line-mv","text":"Move files/folders and rename file/folders using mv : # move file from one location to another mv file1 target_direcotry/ # rename mv file1 file2 mv file1 file2 file3 target_direcotry/","title":"Command line mv"},{"location":"basic_linux/#command-mkdir","text":"The syntax is shown as below: mkdir [OPTION ...] DIRECTORY ... Multiple directories can be specified when calling mkdir mkdir directory1 directory2 mkdir -p foo/bar/baz How to defining complex directory trees with one command: mkdir -p project/{software,results,doc/{html,info,pdf},scripts} Then you can view the directory using tree .","title":"Command mkdir"},{"location":"basic_linux/#command-rm","text":"You can use rm to remove both files and directories. ## You can remove one file. rm file1 ## `rm` can remove multiple files simutaneously rm file2 file3 You can also use 'rm' to remove a folder. If a folder is empty, you can remove it using rm with -r . rm -r FOLDER If a folder is not empty, you can remove it using rm with -r and -f . mkdir test_folder rm -r test_folder","title":"Command rm"},{"location":"basic_linux/#view-text-files-in-linux","text":"","title":"View text files in Linux"},{"location":"basic_linux/#commands-cat-more-and-less","text":"The command cat is short for concatenate files and print on the standard output. The syntax is shown as below: cat [OPTION]... [FILE]... For small text file, cat can be used to view the files on the standard output. The command more is old utility. When the text passed to it is too large to fit on one screen, it pages it. You can scroll down but not up. The syntaxt of more is shown below: more [options] file [...] The command less was written by a man who was fed up with more\u2019s inability to scroll backwards through a file. He turned less into an open source project and over time, various individuals added new features to it. less is massive now. That\u2019s why some small embedded systems have more but not less. For comparison, less\u2019s source is over 27000 lines long. more implementations are generally only a little over 2000 lines long. The syntaxt of less is shown below: less [options] file [...]","title":"Commands cat, more and less"},{"location":"basic_linux/#command-head-and-tail","text":"The command head is used to output the first part of files. By default, it outputs the first 10 lines of the file. head [OPTION]... [FILE]... Here is an exmaple of printing the first 5 files of the file: head -n 5 code_perl/variable_assign.pl In fact, the letter n does not even need to be used at all. Just the hyphen and the integer (with no intervening space) are sufficient to tell head how many lines to return. Thus, the following would produce the same result as the above commands: head -5 target_file.txt The command tail is used to output the last part of files. By default, it prints the last 10 lines of the file to standard output. The syntax is shown below: tail [OPTION]... [FILE]... Here is an exmaple of printing the last 5 files of the file: tail -5 target_file.txt To view lines from a specific point in a file, you can use -n +NUMBER with the tail command. For example, here is an example of viewing the file from the 2nd line of the line. tail -n +2 target_file.txt","title":"Command head and tail"},{"location":"basic_linux/#auto-completion","text":"In most Shell environment, programmable completion feature will also improve your speed of typing. It permits typing a partial name of command or a partial file (or directory), then pressing TAB key to auto-complete the command. If there are more than one possible completions, then TAB will list all of them. A handy autocomplete feature also exists. Type one or more letters, press the Tab key twice, and then a list of functions starting with these letters appears. For example: type so , press the Tab key twice, and then you get the list as: soelim sort sotruss soundstretch source Demonstration of programmable completion feature.","title":"Auto-completion"},{"location":"basic_linux/#file-permissions","text":"In Linux, file permissions are a vital aspect of system security and resource management. This is particularly important in bioinformatics, where large datasets and scripts are often shared across teams. Permissions determine who can read, write, or execute a file, ensuring that critical data is not accidentally modified or deleted. Three Permission Categories : User (u): The owner of the file. Group (g): A group of users who share access to the file. Other (o): All other users on the system. Permission Types : Read (r): Ability to view the contents of a file. Write (w): Ability to modify or delete the file. Execute (x): Ability to run the file as a program (for scripts or executables). %%bash groups $USER animako eunal gstewar1 mjames17 mjeakle nmilza rahooper xie186 : zt-bioi611 zt-bioi611_mgr animako : zt-bioi611 eunal : zt-bioi611 gstewar1 : zt-bioi611 mjames17 : zt-bioi611 mjeakle : zt-bioi611 nmilza : zt-bioi611 rahooper : zt-bioi611 %%bash mkdir -p ~/test_permission/ touch ~/test_permission/test.txt ls -l ~/test_permission/ rm -rf ~/test_permission/ total 0 -rw-r--r--. 1 xie186 zt-bioi611 0 Sep 8 22:52 test.txt Here, the first character represents the type of file (e.g., - for a regular file or d for a directory), followed by three groups of three characters, each representing the permissions for the user , group , and others , respectively. Examples: -rwxr-xr-- : The owner has read , write , and execute permissions. The group has read and execute permissions, while others can only read the file. drwxr-x--- : A directory where the owner can read, write, and access (execute). The group can only read and access, while others have no permissions. Modify file permissions using the chmod command. Permissions can be set in two ways: Symbolic Mode: In symbolic mode, you modify permissions by referencing the categories (user, group, other) and specifying whether you're adding (+), removing (-), or setting (=) permissions. # Add execute permission for the user: chmod u+x filename # Remove write permission for the group: chmod g-w filename # Set read-only permission for others: chmod o=r filename Symbolic mode is intuitive and flexible, especially when you want to make precise adjustments to permissions without affecting other categories. This is useful for common file-sharing tasks in bioinformatics where you need to tweak access for specific collaborators. Numeric Mode (Octal representation): In numeric mode, file permissions are set using a three-digit number. Each digit represents the permissions for user , group , and other , respectively. The digits are calculated by adding the values of the read , write , and execute` permissions: Read (r) = 4 Write (w) = 2 Execute (x) = 1 Example Permission Breakdown: Read (r), Write (w), and Execute (x) for user = 7 Read (r) and Execute (x) for group = 5 Read (r) only for others = 4 chmod 754 filename An example to help you understand executable : %%bash printf '#!/user/bin/python\\nprint(\"Hello, Welcome to Course BIOI611!\")' > ~/test.py %%bash ls -l ~/test.py python ~/test.py -rw-r--r--. 1 xie186 zt-bioi611 61 Sep 8 23:06 /home/xie186/test.py Hello, Welcome to Course BIOI611! Error message below will be thrown out if you consider ~/test.py as a program: bash: line 1: /home/xie186/test.py: No such file or directory %%bash chmod u+x ~/test.py ls -l ~/test.py python ~/test.py rm ~/test.py -rwxr--r--. 1 xie186 zt-bioi611 61 Sep 8 23:06 /home/xie186/test.py Hello, Welcome to Course BIOI611!","title":"File permissions"},{"location":"basic_linux/#disk-usage-of-files-and-directories","text":"The Linux du (short for Disk Usage) is a standard Unix/Linux command, used to check the information of disk usage of files and directories on a machine. The du command has many parameter options that can be used to get the results in many formats. The du command also displays the files and directory sizes in a recursively manner. %%bash du -h ~/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref 2.5G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref %%bash du -ah ~/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref 2.9M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbList.fromGTF.out.tab 7.5K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/Log.out 936M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/SA 1.5G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/SAindex 3.0M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/transcriptInfo.tab 2.3M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbList.out.tab 1.5M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/geneInfo.tab 1.0K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/genomeParameters.txt 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrLength.txt 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrNameLength.txt 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrStart.txt 7.6M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/exonGeTrInfo.tab 3.1M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/exonInfo.tab 2.8M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/sjdbInfo.txt 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/chrName.txt 119M /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref/Genome 2.5G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref %%bash du -csh /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/* 19G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/raw_data 0 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/raw_data_smart_seq 1.5K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_data.sub 575K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq-7478223-xie186.err 0 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq-7478223-xie186.out 8.5K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s1_download_smart_seq.sub 2.5K /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/s2_star.sub 34G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_align 2.5G /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/STAR_ref 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/test.sub 512 /home/xie186/scratch.bioi611/Analysis/bulk_RNAseq/test.txt 55G total","title":"Disk Usage of Files and Directories"},{"location":"basic_linux/#symbolic-link","text":"Symbolic link, similar to shortcuts, can point to another file/folder. ln -s ls -l unlink ","title":"Symbolic link"},{"location":"basic_linux/#file-management-and-data-handling","text":"","title":"File Management and Data Handling"},{"location":"basic_linux/#compressing-and-decompressing-files-gzip-gunzip-tar","text":"Compress one file: %%bash perl -e 'for($i=0; $i<10000; ++$i){ print \"test\\n\";}' > test.txt du -h test.txt gzip test.txt du -h test.txt.gz gunzip test.txt ls test.txt rm test.txt 52K test.txt 4.0K test.txt.gz test.txt Compress multiple files: %%bash perl -e 'for($i=0; $i<10000; ++$i){ print \"test\\n\";}' > test1.txt perl -e 'for($i=0; $i<10000; ++$i){ print \"test\\n\";}' > test2.txt du -h test1.txt test2.txt tar zcvf test.tar.gz test1.txt test2.txt du -sh test.tar.gz ls test1.txt test2.txt 52K test1.txt 52K test2.txt test1.txt test2.txt 4.0K test.tar.gz test1.txt test2.txt z : This option tells tar to compress the archive using gzip. The resulting archive will have a .gz extension to indicate that it has been compressed with the gzip utility. c : This option stands for create. It instructs tar to create a new archive. v : This stands for verbose. When used, tar will display detailed information about the files being added to the archive, such as their names. f : This stands for file. It tells tar that the next argument (test.tar.gz) is the name of the archive file to create. %%bash tar tvf test.tar.gz rm test.tar.gz test1.txt test2.txt -rw-r--r-- xie186/zt-bioi611 50000 2024-08-25 21:52 test1.txt -rw-r--r-- xie186/zt-bioi611 50000 2024-08-25 21:52 test2.txt t : List the contents of archive.tar. v : Display additional details about each file (like file permissions, size, and modification date). f : Specifies that archive.tar is the archive file to operate on. To uncompress a tar.gz file, use tar zxvf : tar zxvf test.tar.gz","title":"Compressing and decompressing files (gzip, gunzip, tar)."},{"location":"basic_linux/#transferring-files-within-the-network","text":"Basic Syntax of scp : scp [options] source destination Copy a Local File to a Remote Server scp file.txt username@remote_host:/path/to/destination/ Alternative command is rsync .","title":"Transferring files within the network"},{"location":"basic_linux/#file-searching-filtering-and-text-processing","text":"","title":"File searching, filtering, and text processing"},{"location":"basic_linux/#command-find","text":"The find command is designed for comprehensive file and directory sesarches. find [path] [options] [expression] %%bash find /home/xie186/scratch/bioi611/bulk_RNAseq -name \"*.fastq.gz\" /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep3.fastq.gz /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep3.fastq.gz /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep1.fastq.gz /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep1.fastq.gz /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day1_rep2.fastq.gz /home/xie186/scratch/bioi611/bulk_RNAseq/raw_data/N2_day7_rep2.fastq.gz","title":"Command find"},{"location":"basic_linux/#text-data-counts-wc","text":"%%bash find /home/xie186/scratch/bioi611/bulk_RNAseq -name \"*.fastq.gz\" |wc -l 6","title":"Text data counts wc"},{"location":"basic_linux/#pipe","text":"In Linux and Unix-based systems, the pipe ( | ) is used in the command line to redirect the output of one command as the input to another command. This allows you to chain commands together and perform more complex tasks in a single line. %%bash grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa |wc -l 7","title":"Pipe |"},{"location":"basic_linux/#column-filering","text":"Command cut can be used to print selected parts of lines from each FILE to standard output. %%bash wget -O GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz \"https://ncbi.nlm.nih.gov/geo/download/?type=rnaseq_counts&acc=GSE102537&format=file&file=GSE102537_raw_counts_GRCh38.p13_NCBI.tsv.gz\" --2024-08-25 21:08:03-- https://ncbi.nlm.nih.gov/geo/download/?type=rnaseq_counts&acc=GSE102537&format=file&file=GSE102537_raw_counts_GRCh38.p13_NCBI.tsv.gz Resolving ncbi.nlm.nih.gov (ncbi.nlm.nih.gov)... 2607:f220:41e:4290::110, 130.14.29.110 Connecting to ncbi.nlm.nih.gov (ncbi.nlm.nih.gov)|2607:f220:41e:4290::110|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 349584 (341K) [application/octet-stream] Saving to: \u2018GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz\u2019 0K .......... .......... .......... .......... .......... 14% 6.66M 0s 50K .......... .......... .......... .......... .......... 29% 16.9M 0s 100K .......... .......... .......... .......... .......... 43% 27.5M 0s 150K .......... .......... .......... .......... .......... 58% 10.1M 0s 200K .......... .......... .......... .......... .......... 73% 17.2M 0s 250K .......... .......... .......... .......... .......... 87% 37.6M 0s 300K .......... .......... .......... .......... . 100% 10.5M=0.02s 2024-08-25 21:08:04 (13.4 MB/s) - \u2018GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz\u2019 saved [349584/349584] %%bash zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |head GeneID GSM2740270 GSM2740272 GSM2740273 GSM2740274 GSM2740275 100287102 9 17 14 14 19 653635 336 470 467 310 370 102466751 8 56 46 31 31 107985730 0 2 2 3 3 100302278 0 1 0 0 2 645520 0 3 8 4 7 79501 0 2 2 1 4 100996442 16 25 34 20 28 729737 19 39 33 22 26 %%bash zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |cut -f1,2,3 |head GeneID GSM2740270 GSM2740272 100287102 9 17 653635 336 470 102466751 8 56 107985730 0 2 100302278 0 1 645520 0 3 79501 0 2 100996442 16 25 729737 19 39","title":"Column filering"},{"location":"basic_linux/#row-filtering","text":"%%bash grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa >I dna:chromosome chromosome:WBcel235:I:1:15072434:1 REF >II dna:chromosome chromosome:WBcel235:II:1:15279421:1 REF >III dna:chromosome chromosome:WBcel235:III:1:13783801:1 REF >IV dna:chromosome chromosome:WBcel235:IV:1:17493829:1 REF >V dna:chromosome chromosome:WBcel235:V:1:20924180:1 REF >X dna:chromosome chromosome:WBcel235:X:1:17718942:1 REF >MtDNA dna:chromosome chromosome:WBcel235:MtDNA:1:13794:1 REF %%bash zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |wc -l zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |awk '$2>500' |wc -l zcat GSE164073_raw_counts_GRCh38.p13_NCBI.tsv.gz |awk '$2>500 && $3>500' |wc -l 39377 8773 3820","title":"Row filtering"},{"location":"basic_linux/#text-processing","text":"%%bash grep '>' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa |sed 's/>//' |sed 's/ .*//' I II III IV V X MtDNA","title":"Text processing"},{"location":"basic_linux/#regular-expressions","text":"Regular expressions are sequences of characters that define search patterns. They are commonly used for string matching, searching, and text processing. Regex is used in text editors, programming languages, command-line tools (like grep and sed ), and many bioinformatics tools to search, replace, or extract data from text. Metacharacters: Special characters that have specific meanings in regex syntax. . (dot): Matches any single character except a newline. Example: A.G matches \"AAG\", \"ATG\", \"ACG\", etc. ^ : Matches the start of a line. Example: ^A matches any line starting with \"A\". $ : Matches the end of a line. Example: end$ matches any line ending with \"end\". * : Matches 0 or more occurrences of the preceding character. Example: ca*t matches \"ct\", \"cat\", \"caat\", \"caaat\", etc. + : Matches 1 or more occurrences of the preceding character. Example: ca+t matches \"cat\", \"caat\", \"caaat\", etc. ? : Matches 0 or 1 occurrence of the preceding character. Example: colou?r matches both \"color\" and \"colour\". [] : Matches any one of the characters inside the brackets. Example: [aeiou] matches any vowel. | : Alternation (OR) operator. Example: cat|dog matches either \"cat\" or \"dog\". Character Classes: Represents a set of characters. \\d : Matches any digit (equivalent to [0-9]). \\w : Matches any word character (alphanumeric or underscore). \\s : Matches any whitespace character (spaces, tabs, etc.). \\D : Matches any non-digit character. \\W : Matches any non-word character. \\S : Matches any non-whitespace character. Quantifiers: Specify the number of occurrences to match {n} : Matches exactly n occurrences. Example: A{3} matches \"AAA\". {n,} : Matches n or more occurrences. Example: T{2,} matches \"TT\", \"TTT\", \"TTTT\", etc. {n,m} : Matches between n and m occurrences. Example: G{1,3} matches \"G\", \"GG\", or \"GGG\".","title":"Regular Expressions"},{"location":"basic_linux/#an-example-of-the-command-line-used","text":"%%bash grep -v '#' ~/scratch/bioi611/reference/Caenorhabditis_elegans.WBcel235.111.gtf \\ |awk '$3==\"gene\"' \\ |sed 's/.*gene_biotype \"//' \\ |sed 's/\";//'|sort |uniq -c \\ | sort -k1,1n 22 rRNA 100 antisense_RNA 129 snRNA 194 lincRNA 261 miRNA 346 snoRNA 634 tRNA 2128 pseudogene 7764 ncRNA 15363 piRNA 19985 protein_coding","title":"An example of the command line used"},{"location":"basic_linux/#environment-variables","text":"Environment variables are dynamic values that affect the behavior of processes and programs in Linux. They are commonly used to store configuration data and are essential in bioinformatics workflows for defining paths to software, libraries, and datasets.","title":"Environment variables"},{"location":"basic_linux/#commonly-used-environment-variables","text":"PATH : The PATH variable specifies directories where the system looks for executable files when a command is run. %%bash echo $PATH /cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/texlive/bin/x86_64-linux:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/imagemagick/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/graphviz/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/ghostscript/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/ffmpeg/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/mpi-nocuda/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/nompi-nocuda/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/views/2023/linux-rhel8-zen2/gcc@11.3.0/python-3.10.10/compiler/linux-rhel8-zen2/gcc/11.3.0/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/linux-rhel8-x86_64/gcc-rh8-8.5.0/gcc-11.3.0-oedkmii7vhd6rbnqm6xufmg7d3jx4w6l/bin:/cvmfs/hpcsw.umd.edu/spack-software/2023.11.20/linux-rhel8-zen2/gcc-11.3.0/py-jupyter-1.0.0-trwwgzwljql55mhmaygcuxb3nvaevjsu/bin:/software/acigs-utilities/bin:/home/xie186/miniforge3/bin:/home/xie186/miniforge3/condabin:/home/xie186/SHELL.bioi611/software/STAR_2.7.11b/Linux_x86_64_static:/home/xie186/.local/bin:/home/xie186/bin:/software/acigs-utilities/bin:/usr/share/Modules/bin:/usr/lib/heimdal/bin:/usr/local/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/opt/symas/bin:/opt/dell/srvadmin/bin HOME : The HOME variable stores the path to the user\u2019s home directory. %%bash echo $HOME /home/xie186 %%bash echo $SHELL /bin/bash","title":"Commonly Used Environment Variables:"},{"location":"basic_linux/#setting-environment-variables","text":"Temporarily setting a variable (valid only for the current shell session): export PATH=value:PATH Permanently setting a variable: To make the environment variable persistent across sessions, it needs to be added to configuration files like .bashrc or .bash_profile . Example: Add the following line to .bashrc :","title":"Setting Environment Variables:"},{"location":"basic_linux/#software-installation","text":"","title":"Software installation"},{"location":"basic_linux/#installation-via-conda","text":"Conda is a popular package management system, especially in bioinformatics, due to its ability to create isolated environments. This is crucial when working with tools that have conflicting dependencies. Install conda/miniforge Go to: https://github.com/conda-forge/miniforge/releases Download the corresponding installtion file %%bash uname -m x86_64 wget https://github.com/conda-forge/miniforge/releases/download/24.7.1-0/Mambaforge-24.7.1-0-Linux-x86_64.sh Create conda environment and install software conda create -n bioi611 conda activate bioi611 conda install bioconda::fastqc==0.11.8","title":"Installation via Conda"},{"location":"basic_linux/#installation-via-source-code-manual-compilation","text":"git clone https://github.com/lh3/bwa.git cd bwa; make ./bwa index ref.fa","title":"Installation via Source Code (Manual Compilation)"},{"location":"basic_linux/#using-container-for-bioinformatics-tools","text":"https://hub.docker.com/r/biocontainers/bwa/ module load singularity singularity build bwa_v0.7.17_cv1.sif docker://biocontainers/bwa:v0.7.17_cv1","title":"Using Container for Bioinformatics Tools"},{"location":"basic_linux/#text-editor-in-linux","text":"In Linux, we sometimes need to create or edit a text file like writing a new perl script. So we need to use text editor. As a newbie, someone would prefer a basic, GUI-based text editor with menus and traditional CUA key bindings. Here we recommend Sublime , ATOM and Notepad++ . But GUI-based text editor is not always available in Linux. A powerful screen text editor vi (pronounced \u201cvee-eye\u201d) is available on nearly all Linux system. We highly recommend vi as a text editor, because something we\u2019ll have to edit a text file on a system without a friendlier text editor. Once we get familiar with vi , we\u2019ll find that it\u2019s very fast and powerful. But remember, it\u2019s OK if you think this part is too difficult at the beginning. You can use either Sublime , ATOM or Notepad++ . If you are connecting to a Linux system without Sublime , ATOM and Notepad++ , you can write the file in a local computer and then upload the file onto Linux system.","title":"Text editor in Linux"},{"location":"basic_linux/#basic-vi-skills","text":"As vi uses a lot of combination of keystrokes, it may be not easy for newbies to remember all the combinations in one fell swoop. Considering this, we\u2019ll first introduce the basic skills someone needs to know to use vi . We need to first understand how three modes of vi work and then try to remember a few basic vi commonds. Then we can use these skills to write Perl or R scripts in the following chaptors for Perl and R (Figure \\@ref(fig:workingModeVi)). Three modes of vi :","title":"Basic vi skills"},{"location":"basic_linux/#create-new-text-file-with-vi","text":"mkdir test_vi ## generate a new folder cd test_vi ## go into the new folder echo \"Using \\`ls\\` we don't expect files in this folder.\" ls echo \"No file displayed!\" Using the code above, we made a new directory named test_vi . We didn't see any file. If we type vi test.py , an empty file and screen are created into which you may enter text because the file does not exist((Figure \\@ref(fig:ViNewFile))). vi test.py A screentshot of the vi test.py . Now if you are in vi mode . To go to Input mode , you can type i , 'a' or 'o' (Figure \\@ref(fig:ViInpuMode)). A screentshot of the vi test.py . Now you can type the content (codes or other information) (\\@ref(fig:ViInpuType)). Once you are done typing. You need to go to Command mode (Figure \\@ref(fig:workingModeVi)) if you want to save and exit the file. To do this, you need to press ESC button on the keyboard. Now we just wrote a Perl script. We can run this script. python test.py","title":"Create new text file with vi"},{"location":"basic_linux/#high-performance-computing-hpc-for-bioinformatics","text":"HPC resources enable bioinformatics analyses that require significant computational power and memory.","title":"High-Performance Computing (HPC) for Bioinformatics"},{"location":"basic_linux/#basics-of-hpc-clusters-and-job-schedulers-slurm","text":"An example of an job file ( s1_star.sh ): #!/bin/bash #SBATCH --partition=standard #SBATCH -t 40:00:00 #SBATCH -n 1 #SBATCH -c 20 #SBATCH --job-name=s1_star_aln #SBATCH --mail-type=FAIL,BEGIN,END #SBATCH --error=%x-%J-%u.err #SBATCH --output=%x-%J-%u.out conda activate bioi611 mkdir -p STAR_align/ STAR --genomeDir STAR_ref \\ --outSAMtype BAM SortedByCoordinate \\ --twopassMode Basic \\ --quantMode TranscriptomeSAM GeneCounts \\ --readFilesCommand zcat \\ --outFileNamePrefix STAR_align/N2_day1_rep1. \\ --runThreadN 20 \\ --readFilesIn raw_data/N2_day1_rep1.fastq.gz To submit this job, run: sbatch s1_star.sh","title":"Basics of HPC clusters and job schedulers (SLURM)."},{"location":"basic_linux/#check-quota-infomation","text":"%%bash scratch_quota # shell_quota # Group quotas Group name Space used Space quota % quota used zt-bioi611 285.811 MB 4.000 TB 0.01% zt-bioi611_mgr 98.163 GB unlimited 0 total 98.449 GB unlimited 0 # User quotas User name Space used Space quota % quota used % of GrpTotal xie186 98.449 GB unlimited 0 100.00%","title":"Check quota infomation"},{"location":"basic_linux/#view-information-about-slurm-nodes-and-partitions","text":"%%bash sinfo PARTITION AVAIL TIMELIMIT NODES STATE NODELIST debug up 15:00 1 maint compute-b8-60 debug up 15:00 1 drng compute-b8-57 debug up 15:00 1 mix compute-b8-59 debug up 15:00 1 alloc compute-b8-58 scavenger up 14-00:00:0 1 inval compute-b8-48 scavenger up 14-00:00:0 4 drain$ compute-b8-[53-56] scavenger up 14-00:00:0 84 maint compute-a7-[5,9,14-16,28,49],compute-a8-[2-4,8-9,15,18,22,24,29,37,44,51],compute-b5-[4,16,26,29-30,33,44,51-52],compute-b6-[7,12,21,28-29,32,34,43-46,50-51,59],compute-b7-[12-13,19-22,25,27,29,31,35,37,39,42,45-46,49-50,54,56-59],compute-b8-[16,19,21,23-24,29,32,35-37,39-45,60] scavenger up 14-00:00:0 2 drain* compute-a7-[13,43] scavenger up 14-00:00:0 13 drng compute-a8-[7,14],compute-b7-[14-15,18,38,43-44],compute-b8-[2,20,51,57],gpu-b9-5 scavenger up 14-00:00:0 2 drain compute-a7-8,gpu-b10-5 scavenger up 14-00:00:0 182 mix bigmem-a9-[1-2,4-5],compute-a5-[3-11],compute-a7-[2-3,6-7,10,12,17-19,21-22,30,38-40,45-46,48,54-56,60],compute-a8-[5-6,10-12,16-17,19-21,25,28,31-35,39,41,45,47,50,52,54,57-59],compute-b5-[1-3,5-8,11,13-15,17-25,27-28,31-32,34-43,45-50,53-55,57-58],compute-b6-[1-5,14-15,17-20,22-24,35-36,48-49,52,54],compute-b7-[1,7-8,16-17,23-24,26,28,30,32-34,36,40-41,47-48,51-52,55,60],compute-b8-[1,15,17-18,22,25-27,30-31,33,46-47,49-50,59],gpu-b9-[1-4,6-7],gpu-b10-[1-3,6-7],gpu-b11-[1-6] scavenger up 14-00:00:0 93 alloc bigmem-a9-[3,6],compute-a7-[1,4,11,20,23-27,29,31-37,41-42,44,47,50-53,57-59],compute-a8-[1,13,23,26-27,30,36,38,40,42-43,46,48-49,53,55-56,60],compute-b5-[9-10,12,56,59-60],compute-b6-[6,8-11,13,16,27,30-31,58,60],compute-b7-[2-6,9-11,53],compute-b8-[3-14,28,34,38,52,58],gpu-b10-4 scavenger up 14-00:00:0 14 idle compute-b6-[25-26,33,37-42,47,53,55-57] standard* up 7-00:00:00 1 inval compute-b8-48 standard* up 7-00:00:00 4 drain$ compute-b8-[53-56] standard* up 7-00:00:00 82 maint compute-a7-[5,9,14-16,28,49],compute-a8-[2-4,8-9,15,18,22,24,29,37,44,51],compute-b5-[4,16,26,29-30,33,44,51-52],compute-b6-[7,12,21,28-29,32,34,43-46,50-51],compute-b7-[12-13,19-22,25,27,29,31,35,37,39,42,45-46,49-50,54,56-59],compute-b8-[16,19,21,23-24,29,32,35-37,39-45] standard* up 7-00:00:00 2 drain* compute-a7-[13,43] standard* up 7-00:00:00 11 drng compute-a8-[7,14],compute-b7-[14-15,18,38,43-44],compute-b8-[2,20,51] standard* up 7-00:00:00 1 drain compute-a7-8 standard* up 7-00:00:00 159 mix compute-a5-[3-11],compute-a7-[2-3,6-7,10,12,17-19,21-22,30,38-40,45-46,48,54-56,60],compute-a8-[5-6,10-12,16-17,19-21,25,28,31-35,39,41,45,47,50,52,54,57-59],compute-b5-[1-3,5-8,11,13-15,17-25,27-28,31-32,34-43,45-50,53-55,57-58],compute-b6-[1-5,14-15,17-20,22-24,35-36,48-49,52],compute-b7-[1,7-8,16-17,23-24,26,28,30,32-34,36,40-41,47-48,51-52,55,60],compute-b8-[1,15,17-18,22,25-27,30-31,33,46-47,49-50] standard* up 7-00:00:00 87 alloc compute-a7-[1,4,11,20,23-27,29,31-37,41-42,44,47,50-53,57-59],compute-a8-[1,13,23,26-27,30,36,38,40,42-43,46,48-49,53,55-56,60],compute-b5-[9-10,12,56,59-60],compute-b6-[6,8-11,13,16,27,30-31],compute-b7-[2-6,9-11,53],compute-b8-[3-14,28,34,38,52] standard* up 7-00:00:00 10 idle compute-b6-[25-26,33,37-42,47] serial up 14-00:00:0 1 maint compute-b6-59 serial up 14-00:00:0 1 mix compute-b6-54 serial up 14-00:00:0 2 alloc compute-b6-[58,60] serial up 14-00:00:0 4 idle compute-b6-[53,55-57] gpu up 7-00:00:00 1 down$ gpu-a6-3 gpu up 7-00:00:00 1 drng gpu-b9-5 gpu up 7-00:00:00 1 drain gpu-b10-5 gpu up 7-00:00:00 19 mix gpu-a6-[6,8],gpu-b9-[1-4,6-7],gpu-b10-[1-3,6-7],gpu-b11-[1-6] gpu up 7-00:00:00 1 alloc gpu-b10-4 gpu up 7-00:00:00 6 idle gpu-a5-1,gpu-a6-[2,4-5,7,9] bigmem up 7-00:00:00 4 mix bigmem-a9-[1-2,4-5] bigmem up 7-00:00:00 2 alloc bigmem-a9-[3,6]","title":"View information about Slurm nodes and partitions."},{"location":"basic_linux/#check-partitial-information","text":"%%bash scontrol show partition standard PartitionName=standard AllowGroups=ALL AllowAccounts=ALL AllowQos=ALL AllocNodes=ALL Default=YES QoS=N/A DefaultTime=00:15:00 DisableRootJobs=NO ExclusiveUser=NO GraceTime=0 Hidden=NO MaxNodes=UNLIMITED MaxTime=7-00:00:00 MinNodes=0 LLN=NO MaxCPUsPerNode=UNLIMITED MaxCPUsPerSocket=UNLIMITED Nodes=compute-a5-[3-11],compute-a7-[1-60],compute-a8-[1-60],compute-b5-[1-60],compute-b6-[1-52],compute-b7-[1-60],compute-b8-[1-56] PriorityJobFactor=1 PriorityTier=1 RootOnly=NO ReqResv=NO OverSubscribe=YES:4 OverTimeLimit=NONE PreemptMode=REQUEUE State=UP TotalCPUs=45696 TotalNodes=357 SelectTypeParameters=NONE JobDefaults=(null) DefMemPerNode=UNLIMITED MaxMemPerNode=UNLIMITED TRES=cpu=45696,mem=178500G,node=357,billing=45696 TRESBillingWeights=CPU=1.0,Mem=0.25G","title":"Check partitial information"},{"location":"basic_linux/#display-node-config-information","text":"%%bash scontrol show node compute-a5-3 NodeName=compute-a5-3 Arch=x86_64 CoresPerSocket=64 CPUAlloc=71 CPUEfctv=128 CPUTot=128 CPULoad=68.89 AvailableFeatures=rhel8,amd,epyc_7702,ib ActiveFeatures=rhel8,amd,epyc_7702,ib Gres=(null) NodeAddr=compute-a5-3 NodeHostName=compute-a5-3 Version=23.11.9 OS=Linux 4.18.0-553.5.1.el8_10.x86_64 #1 SMP Tue May 21 03:13:04 EDT 2024 RealMemory=512000 AllocMem=296960 FreeMem=326630 Sockets=2 Boards=1 State=MIXED ThreadsPerCore=1 TmpDisk=300000 Weight=1 Owner=N/A MCS_label=N/A Partitions=scavenger,standard BootTime=2024-08-08T18:32:48 SlurmdStartTime=2024-08-12T17:43:23 LastBusyTime=2024-08-12T17:43:19 ResumeAfterTime=None CfgTRES=cpu=128,mem=500G,billing=128 AllocTRES=cpu=71,mem=290G CapWatts=n/a CurrentWatts=630 AveWatts=294 ExtSensorsJoules=n/a ExtSensorsWatts=0 ExtSensorsTemp=n/a CPU Details: * Total CPUs: 128 * Allocated CPUs: 71 Memory: * Total Memory: 500 GB * Allocated Memory: 290 GB * Free Memory: ~319 GB","title":"Display node config information"},{"location":"basic_linux/#view-information-about-jobs-located-in-the-slurm-scheduling-queue","text":"%%bash squeue -u $USER JOBID PARTITION NAME USER ST TIME NODES NODELIST(REASON) 7563417 standard sys/dash xie186 R 48:15 1 compute-a5-5","title":"View information about jobs located in the Slurm scheduling queue."},{"location":"basic_linux/#cancel-a-job","text":"%%bash scancel ","title":"Cancel a job"},{"location":"bulkRNAseq_lab/","text":"# @hidden_cell import os os.chdir('/') Download reference genome To download the reference for this lab, we use ENSEMBL database . In ENSEMBL database, each species may have different releases of genome build. We use release-111 in this project. The genome sequences can be obtained from the link below: https://ftp.ensembl.org/pub/release-111/fasta/caenorhabditis_elegans/dna/ The genoe anntation file in gtf format can be obtained here: https://ftp.ensembl.org/pub/release-111/gtf/caenorhabditis_elegans/ %%bash wget -O Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz https://ftp.ensembl.org/pub/release-111/fasta/caenorhabditis_elegans/dna/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz gunzip Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz %%bash ## A *fai file will be generated samtools faidx ref/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa %%bash wget -O Caenorhabditis_elegans.WBcel235.111.gtf.gz -nv https://ftp.ensembl.org/pub/release-111/gtf/caenorhabditis_elegans/Caenorhabditis_elegans.WBcel235.111.gtf.gz gunzip Caenorhabditis_elegans.WBcel235.111.gtf.gz In this course, the reference files have been downloaded and stored in shared folder for BIOI611: /scratch/zt1/project/bioi611/shared/reference/ As you already leart, you can create a symbolic link for you to use in your scratch folder: %%bash cd /scratch/zt1/project/bioi611/user/$USER ln -s /scratch/zt1/project/bioi611/shared/reference/ . How many chromsomes there are %%bash cd /scratch/zt1/project/bioi611/user/$USER grep '>' reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa >I dna:chromosome chromosome:WBcel235:I:1:15072434:1 REF >II dna:chromosome chromosome:WBcel235:II:1:15279421:1 REF >III dna:chromosome chromosome:WBcel235:III:1:13783801:1 REF >IV dna:chromosome chromosome:WBcel235:IV:1:17493829:1 REF >V dna:chromosome chromosome:WBcel235:V:1:20924180:1 REF >X dna:chromosome chromosome:WBcel235:X:1:17718942:1 REF >MtDNA dna:chromosome chromosome:WBcel235:MtDNA:1:13794:1 REF How many genes there are %%bash cd /scratch/zt1/project/bioi611/user/$USER grep -v '#' reference/Caenorhabditis_elegans.WBcel235.111.gtf \\ |awk '$3==\"gene\"' \\ |sed 's/.*gene_biotype \"//' \\ |sed 's/\";//'|sort |uniq -c \\ | sort -k1,1n 22 rRNA 100 antisense_RNA 129 snRNA 194 lincRNA 261 miRNA 346 snoRNA 634 tRNA 2128 pseudogene 7764 ncRNA 15363 piRNA 19985 protein_coding Source: https://useast.ensembl.org/Help/Faq?id=468eudogene Download raw fastq files %%bash mkdir -p raw_data/ curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/002/SRR15694102/SRR15694102.fastq.gz -o raw_data/N2_day7_rep1.fastq.gz curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/001/SRR15694101/SRR15694101.fastq.gz -o raw_data/N2_day7_rep2.fastq.gz curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/000/SRR15694100/SRR15694100.fastq.gz -o raw_data/N2_day7_rep3.fastq.gz curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/099/SRR15694099/SRR15694099.fastq.gz -o raw_data/N2_day1_rep1.fastq.gz curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/098/SRR15694098/SRR15694098.fastq.gz -o raw_data/N2_day1_rep2.fastq.gz curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/097/SRR15694097/SRR15694097.fastq.gz -o raw_data/N2_day1_rep3.fastq.gz Quality control Use FastQC to check the quality of fastq files: %%bash cd /scratch/zt1/project/bioi611/user/$USER sbatch ../../shared/scripts/bulkRNA_s1_fastqc.sub Use trim galore to remove adaptors, low quality bases and low quality reads. %%bash cd /scratch/zt1/project/bioi611/user/$USER sbatch ../../shared/scripts/bulkRNA_s2_trim_galore.sub","title":"Prepare data"},{"location":"bulkRNAseq_lab/#download-reference-genome","text":"To download the reference for this lab, we use ENSEMBL database . In ENSEMBL database, each species may have different releases of genome build. We use release-111 in this project. The genome sequences can be obtained from the link below: https://ftp.ensembl.org/pub/release-111/fasta/caenorhabditis_elegans/dna/ The genoe anntation file in gtf format can be obtained here: https://ftp.ensembl.org/pub/release-111/gtf/caenorhabditis_elegans/ %%bash wget -O Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz https://ftp.ensembl.org/pub/release-111/fasta/caenorhabditis_elegans/dna/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz gunzip Caenorhabditis_elegans.WBcel235.dna.toplevel.fa.gz %%bash ## A *fai file will be generated samtools faidx ref/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa %%bash wget -O Caenorhabditis_elegans.WBcel235.111.gtf.gz -nv https://ftp.ensembl.org/pub/release-111/gtf/caenorhabditis_elegans/Caenorhabditis_elegans.WBcel235.111.gtf.gz gunzip Caenorhabditis_elegans.WBcel235.111.gtf.gz In this course, the reference files have been downloaded and stored in shared folder for BIOI611: /scratch/zt1/project/bioi611/shared/reference/ As you already leart, you can create a symbolic link for you to use in your scratch folder: %%bash cd /scratch/zt1/project/bioi611/user/$USER ln -s /scratch/zt1/project/bioi611/shared/reference/ .","title":"Download reference genome"},{"location":"bulkRNAseq_lab/#how-many-chromsomes-there-are","text":"%%bash cd /scratch/zt1/project/bioi611/user/$USER grep '>' reference/Caenorhabditis_elegans.WBcel235.dna.toplevel.fa >I dna:chromosome chromosome:WBcel235:I:1:15072434:1 REF >II dna:chromosome chromosome:WBcel235:II:1:15279421:1 REF >III dna:chromosome chromosome:WBcel235:III:1:13783801:1 REF >IV dna:chromosome chromosome:WBcel235:IV:1:17493829:1 REF >V dna:chromosome chromosome:WBcel235:V:1:20924180:1 REF >X dna:chromosome chromosome:WBcel235:X:1:17718942:1 REF >MtDNA dna:chromosome chromosome:WBcel235:MtDNA:1:13794:1 REF","title":"How many chromsomes there are"},{"location":"bulkRNAseq_lab/#how-many-genes-there-are","text":"%%bash cd /scratch/zt1/project/bioi611/user/$USER grep -v '#' reference/Caenorhabditis_elegans.WBcel235.111.gtf \\ |awk '$3==\"gene\"' \\ |sed 's/.*gene_biotype \"//' \\ |sed 's/\";//'|sort |uniq -c \\ | sort -k1,1n 22 rRNA 100 antisense_RNA 129 snRNA 194 lincRNA 261 miRNA 346 snoRNA 634 tRNA 2128 pseudogene 7764 ncRNA 15363 piRNA 19985 protein_coding Source: https://useast.ensembl.org/Help/Faq?id=468eudogene","title":"How many genes there are"},{"location":"bulkRNAseq_lab/#download-raw-fastq-files","text":"%%bash mkdir -p raw_data/ curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/002/SRR15694102/SRR15694102.fastq.gz -o raw_data/N2_day7_rep1.fastq.gz curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/001/SRR15694101/SRR15694101.fastq.gz -o raw_data/N2_day7_rep2.fastq.gz curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/000/SRR15694100/SRR15694100.fastq.gz -o raw_data/N2_day7_rep3.fastq.gz curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/099/SRR15694099/SRR15694099.fastq.gz -o raw_data/N2_day1_rep1.fastq.gz curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/098/SRR15694098/SRR15694098.fastq.gz -o raw_data/N2_day1_rep2.fastq.gz curl -L ftp://ftp.sra.ebi.ac.uk/vol1/fastq/SRR156/097/SRR15694097/SRR15694097.fastq.gz -o raw_data/N2_day1_rep3.fastq.gz","title":"Download raw fastq files"},{"location":"bulkRNAseq_lab/#quality-control","text":"Use FastQC to check the quality of fastq files: %%bash cd /scratch/zt1/project/bioi611/user/$USER sbatch ../../shared/scripts/bulkRNA_s1_fastqc.sub Use trim galore to remove adaptors, low quality bases and low quality reads. %%bash cd /scratch/zt1/project/bioi611/user/$USER sbatch ../../shared/scripts/bulkRNA_s2_trim_galore.sub","title":"Quality control"},{"location":"general-questions/","text":"To be added","title":"To be added"},{"location":"general-questions/#to-be-added","text":"","title":"To be added"},{"location":"license/","text":"To be added","title":"To be added"},{"location":"license/#to-be-added","text":"","title":"To be added"},{"location":"ref/","text":"","title":"Ref"},{"location":"troubleshooting/","text":"To be added","title":"To be added"},{"location":"troubleshooting/#to-be-added","text":"","title":"To be added"}]} \ No newline at end of file diff --git a/search/worker.js b/search/worker.js new file mode 100644 index 0000000..8628dbc --- /dev/null +++ b/search/worker.js @@ -0,0 +1,133 @@ +var base_path = 'function' === typeof importScripts ? '.' : '/search/'; +var allowSearch = false; +var index; +var documents = {}; +var lang = ['en']; +var data; + +function getScript(script, callback) { + console.log('Loading script: ' + script); + $.getScript(base_path + script).done(function () { + callback(); + }).fail(function (jqxhr, settings, exception) { + console.log('Error: ' + exception); + }); +} + +function getScriptsInOrder(scripts, callback) { + if (scripts.length === 0) { + callback(); + return; + } + getScript(scripts[0], function() { + getScriptsInOrder(scripts.slice(1), callback); + }); +} + +function loadScripts(urls, callback) { + if( 'function' === typeof importScripts ) { + importScripts.apply(null, urls); + callback(); + } else { + getScriptsInOrder(urls, callback); + } +} + +function onJSONLoaded () { + data = JSON.parse(this.responseText); + var scriptsToLoad = ['lunr.js']; + if (data.config && data.config.lang && data.config.lang.length) { + lang = data.config.lang; + } + if (lang.length > 1 || lang[0] !== "en") { + scriptsToLoad.push('lunr.stemmer.support.js'); + if (lang.length > 1) { + scriptsToLoad.push('lunr.multi.js'); + } + if (lang.includes("ja") || lang.includes("jp")) { + scriptsToLoad.push('tinyseg.js'); + } + for (var i=0; i < lang.length; i++) { + if (lang[i] != 'en') { + scriptsToLoad.push(['lunr', lang[i], 'js'].join('.')); + } + } + } + loadScripts(scriptsToLoad, onScriptsLoaded); +} + +function onScriptsLoaded () { + console.log('All search scripts loaded, building Lunr index...'); + if (data.config && data.config.separator && data.config.separator.length) { + lunr.tokenizer.separator = new RegExp(data.config.separator); + } + + if (data.index) { + index = lunr.Index.load(data.index); + data.docs.forEach(function (doc) { + documents[doc.location] = doc; + }); + console.log('Lunr pre-built index loaded, search ready'); + } else { + index = lunr(function () { + if (lang.length === 1 && lang[0] !== "en" && lunr[lang[0]]) { + this.use(lunr[lang[0]]); + } else if (lang.length > 1) { + this.use(lunr.multiLanguage.apply(null, lang)); // spread operator not supported in all browsers: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_operator#Browser_compatibility + } + this.field('title'); + this.field('text'); + this.ref('location'); + + for (var i=0; i < data.docs.length; i++) { + var doc = data.docs[i]; + this.add(doc); + documents[doc.location] = doc; + } + }); + console.log('Lunr index built, search ready'); + } + allowSearch = true; + postMessage({config: data.config}); + postMessage({allowSearch: allowSearch}); +} + +function init () { + var oReq = new XMLHttpRequest(); + oReq.addEventListener("load", onJSONLoaded); + var index_path = base_path + '/search_index.json'; + if( 'function' === typeof importScripts ){ + index_path = 'search_index.json'; + } + oReq.open("GET", index_path); + oReq.send(); +} + +function search (query) { + if (!allowSearch) { + console.error('Assets for search still loading'); + return; + } + + var resultDocuments = []; + var results = index.search(query); + for (var i=0; i < results.length; i++){ + var result = results[i]; + doc = documents[result.ref]; + doc.summary = doc.text.substring(0, 200); + resultDocuments.push(doc); + } + return resultDocuments; +} + +if( 'function' === typeof importScripts ) { + onmessage = function (e) { + if (e.data.init) { + init(); + } else if (e.data.query) { + postMessage({ results: search(e.data.query) }); + } else { + console.error("Worker - Unrecognized message: " + e); + } + }; +} diff --git a/sitemap.xml b/sitemap.xml new file mode 100644 index 0000000..0f8724e --- /dev/null +++ b/sitemap.xml @@ -0,0 +1,3 @@ + + + \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz new file mode 100644 index 0000000..50cb469 Binary files /dev/null and b/sitemap.xml.gz differ diff --git a/troubleshooting.ipynb b/troubleshooting.ipynb new file mode 100644 index 0000000..1d75263 --- /dev/null +++ b/troubleshooting.ipynb @@ -0,0 +1,41 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "id": "164ae4c1-5c1d-4053-bcfb-d1c35d64d245", + "metadata": {}, + "source": [ + "# To be added" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "0d3d59c1-1918-4de5-b3ae-b4021e7ad327", + "metadata": {}, + "outputs": [], + "source": [] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.10.12" + } + }, + "nbformat": 4, + "nbformat_minor": 5 +} diff --git a/troubleshooting/index.html b/troubleshooting/index.html new file mode 100644 index 0000000..c37fb71 --- /dev/null +++ b/troubleshooting/index.html @@ -0,0 +1,127 @@ + + + + + + + + To be added - Lab note for UMD BIOI611 + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+
+
+ +

To be added

+

+
+ +
+
+ +
+
+ +
+ +
+ +
+ + + + Bix4UMD/BIOI611_lab + + + + + +
+ + + + + + + + +