mkdocs.yml

# Auto-generated by scripts/build_index.py. Do not edit by hand.
site_name: Data Science Field Guide
site_description: Markdown-first field guide for data science and machine learning concepts, organized as flashcards.
site_url: https://example.com

# Docs live in ./docs, which mirrors the repo via symlinks
docs_dir: docs

# Avoid publishing non-doc artifacts
exclude_docs: |
  .DS_Store
  _template/
  relations/
  scripts/
  mkdocs.yml

nav:
  - Home: README.md
  - Index: index/INDEX.md
  - Tags: index/TAGS.md
  - Glossary: index/GLOSSARY.md
  - Cards:
      - Activations:
          - Activation Functions: cards/activations/activations.md
          - ELU (Exponential Linear Unit): cards/activations/elu.md
          - GELU (Gaussian Error Linear Unit): cards/activations/gelu.md
          - Leaky ReLU: cards/activations/leaky-relu.md
          - ReLU (Rectified Linear Unit): cards/activations/relu.md
          - SELU (Scaled ELU): cards/activations/selu.md
          - Sigmoid (Logistic): cards/activations/sigmoid.md
          - Softmax: cards/activations/softmax.md
          - Softplus: cards/activations/softplus.md
          - Swish / SiLU: cards/activations/swish-silu.md
          - Tanh (Hyperbolic Tangent): cards/activations/tanh.md
      - Calculus:
          - Chain Rule: cards/calculus/chain-rule.md
          - Derivative: cards/calculus/derivative.md
          - Gradient: cards/calculus/gradient.md
          - Hessian: cards/calculus/hessian.md
          - Integral: cards/calculus/integral.md
          - Jacobian: cards/calculus/jacobian.md
          - Multivariable Chain Rule: cards/calculus/multivariable-chain-rule.md
          - Partial Derivative: cards/calculus/partial-derivative.md
          - Taylor Expansion: cards/calculus/taylor-expansion.md
      - Deep Learning:
          - Attention: cards/deep-learning/attention.md
          - Backpropagation: cards/deep-learning/backpropagation.md
          - Batch Normalization: cards/deep-learning/batch-normalization.md
          - Cosine Embedding Loss (Metric Learning): cards/deep-learning/cosine-embedding-loss.md
          - Cross-Attention: cards/deep-learning/cross-attention.md
          - Dropout: cards/deep-learning/dropout.md
          - Embedding: cards/deep-learning/embedding.md
          - Feedforward Network (Transformer FFN): cards/deep-learning/feedforward-network-transformer.md
          - Layer Normalization: cards/deep-learning/layer-normalization.md
          - MLP (Multi-Layer Perceptron): cards/deep-learning/mlp.md
          - Multi-Head Attention: cards/deep-learning/multi-head-attention.md
          - Positional Encoding: cards/deep-learning/positional-encoding.md
          - Residual Connection (Skip Connection): cards/deep-learning/residual-connection.md
          - Self-Attention: cards/deep-learning/self-attention.md
          - Transformer: cards/deep-learning/transformer.md
      - Graphs:
          - Adjacency Matrix: cards/graphs/adjacency-matrix.md
          - Augmenting Path: cards/graphs/augmenting-path.md
          - Bellman-Ford Algorithm: cards/graphs/bellman-ford.md
          - Breadth-First Search (BFS): cards/graphs/bfs.md
          - Clustering Coefficient: cards/graphs/clustering-coefficient.md
          - Connected Components: cards/graphs/connected-components.md
          - Degree Matrix: cards/graphs/degree-matrix.md
          - Depth-First Search (DFS): cards/graphs/dfs.md
          - Dijkstra's Algorithm: cards/graphs/dijkstra.md
          - Dinic's Algorithm: cards/graphs/dinic.md
          - Edge Cut vs Vertex Cut: cards/graphs/edge-cut-vs-vertex-cut.md
          - Edmonds-Karp Algorithm: cards/graphs/edmonds-karp.md
          - Flow Network: cards/graphs/flow-network.md
          - Ford-Fulkerson Method: cards/graphs/ford-fulkerson.md
          - Global Minimum Cut: cards/graphs/global-minimum-cut.md
          - Graph Algorithms (Overview): cards/graphs/graph-algorithms.md
          - Graph Fourier Transform: cards/graphs/graph-fourier-transform.md
          - Graph Laplacian: cards/graphs/laplacian.md
          - Graph Motifs: cards/graphs/graph-motifs.md
          - Karger's Algorithm (Min Cut): cards/graphs/karger-min-cut.md
          - Kruskal's Algorithm: cards/graphs/kruskal.md
          - Label Propagation (LPA): cards/graphs/label-propagation.md
          - Max-Flow Min-Cut Theorem: cards/graphs/max-flow-min-cut-theorem.md
          - Maximum Flow: cards/graphs/maximum-flow.md
          - Message Passing (on Graphs): cards/graphs/message-passing.md
          - Minimum Cut: cards/graphs/minimum-cut.md
          - Minimum Spanning Tree (MST): cards/graphs/minimum-spanning-tree.md
          - Modularity (Community Quality): cards/graphs/modularity.md
          - Network Significance Profile: cards/graphs/network-significance-profile.md
          - PageRank: cards/graphs/pagerank.md
          - Prim's Algorithm: cards/graphs/prim.md
          - Residual Graph: cards/graphs/residual-graph.md
          - Shortest Path (Overview): cards/graphs/shortest-path.md
          - Spectral Clustering: cards/graphs/spectral-clustering.md
          - Topological Sort: cards/graphs/topological-sort.md
      - Information Theory:
          - Channel Capacity: cards/info-theory/channel-capacity.md
          - Conditional Entropy: cards/info-theory/conditional-entropy.md
          - Cross Entropy: cards/info-theory/cross-entropy.md
          - Data Processing Inequality: cards/info-theory/data-processing-inequality.md
          - Entropy Rate: cards/info-theory/entropy-rate.md
          - Fisher Information: cards/info-theory/fisher-information.md
          - Jensen-Shannon Divergence: cards/info-theory/js-divergence.md
          - Joint Entropy: cards/info-theory/joint-entropy.md
          - KL Divergence (Relative Entropy): cards/info-theory/kl-divergence.md
          - Mutual Information: cards/info-theory/mutual-information.md
          - Perplexity: cards/info-theory/perplexity.md
          - Shannon Entropy: cards/info-theory/entropy-shannon.md
      - Linear Algebra:
          - Cholesky Decomposition: cards/linear-algebra/cholesky.md
          - Condition Number: cards/linear-algebra/condition-number.md
          - Determinant: cards/linear-algebra/determinant.md
          - Dot Product: cards/linear-algebra/dot-product.md
          - Eigendecomposition: cards/linear-algebra/eigendecomposition.md
          - Eigenvalues and Eigenvectors: cards/linear-algebra/eigenvalues-eigenvectors.md
          - Least Squares: cards/linear-algebra/least-squares.md
          - Linear Independence: cards/linear-algebra/linear-independence.md
          - Matrix Rank: cards/linear-algebra/matrix-rank.md
          - Nuclear Norm (Trace Norm): cards/linear-algebra/nuclear-norm.md
          - Orthogonal Projection: cards/linear-algebra/projection.md
          - Orthonormal Basis: cards/linear-algebra/orthonormal-basis.md
          - PCA Explained Variance Ratio: cards/linear-algebra/pca-explained-variance.md
          - Positive Definite Matrix: cards/linear-algebra/positive-definite-matrix.md
          - Principal Component Analysis (PCA): cards/linear-algebra/pca.md
          - Pseudo-inverse (Moore-Penrose): cards/linear-algebra/pseudoinverse.md
          - QR Decomposition: cards/linear-algebra/qr.md
          - Scree Plot: cards/linear-algebra/scree-plot.md
          - Singular Value Decomposition (SVD): cards/linear-algebra/svd.md
          - Span: cards/linear-algebra/span.md
          - Trace: cards/linear-algebra/trace.md
          - Vector Norms: cards/linear-algebra/norms.md
      - Machine Learning:
          - Bias-Variance Tradeoff: cards/machine-learning/bias-variance-tradeoff.md
          - Categorical Encoding: cards/machine-learning/categorical-encoding.md
          - Class Imbalance: cards/machine-learning/class-imbalance.md
          - Concept Drift: cards/machine-learning/concept-drift.md
          - Cross-Validation: cards/machine-learning/cross-validation.md
          - Data Drift: cards/machine-learning/data-drift.md
          - Data Leakage: cards/machine-learning/data-leakage.md
          - DBSCAN: cards/machine-learning/dbscan.md
          - Decision Tree: cards/machine-learning/decision-tree.md
          - Elastic Net: cards/machine-learning/elastic-net.md
          - Feature Scaling (Standardization vs Normalization): cards/machine-learning/feature-scaling.md
          - Feature Store: cards/machine-learning/feature-store.md
          - Gradient Boosting: cards/machine-learning/gradient-boosting.md
          - Hierarchical Clustering: cards/machine-learning/hierarchical-clustering.md
          - Imputation: cards/machine-learning/imputation.md
          - K-Means Clustering: cards/machine-learning/k-means-clustering.md
          - K-Nearest Neighbors (k-NN): cards/machine-learning/k-nearest-neighbors.md
          - Lasso Regression (L1): cards/machine-learning/lasso-regression.md
          - Linear Regression: cards/machine-learning/linear-regression.md
          - Logistic Regression: cards/machine-learning/logistic-regression.md
          - Machine Learning Pipeline: cards/machine-learning/machine-learning-pipeline.md
          - Missing Data: cards/machine-learning/missing-data.md
          - Model Interpretability: cards/machine-learning/model-interpretability.md
          - Partial Dependence Plot (PDP): cards/machine-learning/partial-dependence-plot.md
          - Permutation Feature Importance: cards/machine-learning/permutation-feature-importance.md
          - Probability Calibration: cards/machine-learning/probability-calibration.md
          - Random Forest: cards/machine-learning/random-forest.md
          - Ridge Regression (L2): cards/machine-learning/ridge-regression.md
          - SHAP Values: cards/machine-learning/shap-values.md
          - Threshold Selection: cards/machine-learning/threshold-selection.md
          - Train/Validation/Test Split: cards/machine-learning/train-validation-test-split.md
      - ML Metrics:
          - Adjusted Rand Index (ARI): cards/ml-metrics/adjusted-rand-index.md
          - Akaike Information Criterion (AIC): cards/ml-metrics/aic.md
          - Average Precision: cards/ml-metrics/average-precision.md
          - Bayesian Information Criterion (BIC): cards/ml-metrics/bic.md
          - Brier Score: cards/ml-metrics/brier-score.md
          - Calibration Error (ECE): cards/ml-metrics/calibration-error.md
          - Calinski-Harabasz Score: cards/ml-metrics/calinski-harabasz-score.md
          - Cohen's Kappa: cards/ml-metrics/cohen-kappa.md
          - Confusion Matrix: cards/ml-metrics/confusion-matrix.md
          - Davies-Bouldin Index: cards/ml-metrics/davies-bouldin-index.md
          - Density-Based Clustering Validation (DBCV): cards/ml-metrics/density-based-clustering-validation.md
          - Dice Coefficient (Sorensen-Dice): cards/ml-metrics/dice.md
          - F1 Score: cards/ml-metrics/f1-score.md
          - Fowlkes-Mallows Index: cards/ml-metrics/fowlkes-mallows-index.md
          - Jaccard Similarity / IoU: cards/ml-metrics/jaccard.md
          - Log Loss (Binary Cross-Entropy): cards/ml-metrics/log-loss.md
          - Matthews Correlation Coefficient: cards/ml-metrics/matthews-corrcoef.md
          - Mean Absolute Error (MAE): cards/ml-metrics/mae.md
          - Mean Squared Error (MSE): cards/ml-metrics/mse.md
          - Negative Log-Likelihood (NLL): cards/ml-metrics/negative-log-likelihood.md
          - Normalized Mutual Information (NMI): cards/ml-metrics/normalized-mutual-information.md
          - Precision: cards/ml-metrics/precision.md
          - Precision-Recall Curve: cards/ml-metrics/pr-curve.md
          - R^2 (Coefficient of Determination): cards/ml-metrics/r2.md
          - Recall: cards/ml-metrics/recall.md
          - ROC AUC: cards/ml-metrics/auc-roc.md
          - ROC Curve: cards/ml-metrics/roc-curve.md
          - Root Mean Squared Error (RMSE): cards/ml-metrics/rmse.md
          - Sensitivity (True Positive Rate): cards/ml-metrics/sensitivity.md
          - Silhouette Score: cards/ml-metrics/silhouette-score.md
          - Specificity (True Negative Rate): cards/ml-metrics/specificity.md
      - NLP:
          - Causal Language Modeling: cards/nlp/causal-language-modeling.md
          - Inverse Document Frequency (IDF): cards/nlp/inverse-document-frequency.md
          - Language Model: cards/nlp/language-model.md
          - Masked Language Modeling (MLM): cards/nlp/masked-language-modeling.md
          - Next-Token Prediction: cards/nlp/next-token-prediction.md
          - Subword Tokenization (BPE / WordPiece): cards/nlp/subword-tokenization.md
          - Temperature (Sampling): cards/nlp/temperature-sampling.md
          - Term Frequency (TF): cards/nlp/term-frequency.md
          - TF-IDF: cards/nlp/tf-idf.md
          - Tokenization: cards/nlp/tokenization.md
          - Top-k Sampling: cards/nlp/top-k-sampling.md
          - Top-p Sampling (Nucleus): cards/nlp/top-p-sampling.md
      - Optimization:
          - Adam Optimizer: cards/optimization/adam.md
          - AdamW Optimizer: cards/optimization/adamw.md
          - Early Stopping: cards/optimization/early-stopping.md
          - Gradient Clipping: cards/optimization/gradient-clipping.md
          - Gradient Descent: cards/optimization/gradient-descent.md
          - KKT Conditions: cards/optimization/kkt-conditions.md
          - Lagrangian: cards/optimization/lagrangian.md
          - Lagrangian Duality: cards/optimization/duality.md
          - Learning Rate Schedule: cards/optimization/learning-rate-schedule.md
          - Learning Rate Warmup: cards/optimization/warmup.md
          - Line Search: cards/optimization/line-search.md
          - Momentum (SGD with Momentum): cards/optimization/momentum.md
          - Newton's Method: cards/optimization/newton-method.md
          - Proximal Operator: cards/optimization/proximal-operator.md
          - Regularization (L1/L2): cards/optimization/regularization.md
          - RMSProp: cards/optimization/rmsprop.md
          - Stochastic Gradient Descent: cards/optimization/stochastic-gradient-descent.md
          - Weight Decay: cards/optimization/weight-decay.md
      - Probability Stats:
          - A/B Testing: cards/probability-stats/ab-testing.md
          - ANOVA (Analysis of Variance): cards/probability-stats/anova.md
          - Bayes' Rule: cards/probability-stats/bayes-rule.md
          - Benjamini-Hochberg Procedure: cards/probability-stats/benjamini-hochberg.md
          - Bernoulli Distribution: cards/probability-stats/bernoulli-distribution.md
          - Bernoulli Trial: cards/probability-stats/bernoulli-trial.md
          - Beta Distribution: cards/probability-stats/beta-distribution.md
          - Binomial Distribution: cards/probability-stats/binomial-distribution.md
          - Bootstrap: cards/probability-stats/bootstrap.md
          - CDF (Cumulative Distribution Function): cards/probability-stats/cdf.md
          - Central Limit Theorem: cards/probability-stats/central-limit-theorem.md
          - Characteristic Function: cards/probability-stats/characteristic-function.md
          - Chebyshev's Inequality: cards/probability-stats/chebyshev-inequality.md
          - Chi-Square Test: cards/probability-stats/chi-square-test.md
          - Cohen's d (Effect Size): cards/probability-stats/cohens-d.md
          - Conditional Expectation: cards/probability-stats/conditional-expectation.md
          - Conditional Probability: cards/probability-stats/conditional-probability.md
          - Confidence Interval: cards/probability-stats/confidence-interval.md
          - Correlation: cards/probability-stats/correlation.md
          - Covariance: cards/probability-stats/covariance.md
          - Expectation: cards/probability-stats/expectation.md
          - Exponential Distribution: cards/probability-stats/exponential-distribution.md
          - False Discovery Rate (FDR): cards/probability-stats/false-discovery-rate.md
          - Gamma Distribution: cards/probability-stats/gamma-distribution.md
          - Geometric Distribution: cards/probability-stats/geometric-distribution.md
          - Independence: cards/probability-stats/independence.md
          - Jensen's Inequality: cards/probability-stats/jensen-inequality.md
          - Joint Probability: cards/probability-stats/joint-probability.md
          - Law of Large Numbers: cards/probability-stats/law-of-large-numbers.md
          - Law of Total Probability: cards/probability-stats/total-probability.md
          - Lognormal Distribution: cards/probability-stats/lognormal-distribution.md
          - Marginal Probability: cards/probability-stats/marginal-probability.md
          - Markov's Inequality: cards/probability-stats/markov-inequality.md
          - Maximum A Posteriori (MAP): cards/probability-stats/maximum-a-posteriori.md
          - Maximum Likelihood Estimation (MLE): cards/probability-stats/maximum-likelihood-estimation.md
          - Mean (Expected Value): cards/probability-stats/mean.md
          - Median: cards/probability-stats/median.md
          - Moment Generating Function: cards/probability-stats/mgf.md
          - Multinomial Distribution: cards/probability-stats/multinomial-distribution.md
          - Multiple Hypothesis Testing: cards/probability-stats/multiple-hypothesis-testing.md
          - Normal Distribution (Gaussian): cards/probability-stats/normal-distribution.md
          - Null Hypothesis: cards/probability-stats/null-hypothesis.md
          - One-Sample t-Test: cards/probability-stats/t-test-one-sample.md
          - P-Value: cards/probability-stats/p-value.md
          - Paired t-Test: cards/probability-stats/t-test-paired.md
          - PDF (Probability Density Function): cards/probability-stats/pdf.md
          - Permutation Test: cards/probability-stats/permutation-test.md
          - PMF (Probability Mass Function): cards/probability-stats/pmf.md
          - Poisson Distribution: cards/probability-stats/poisson-distribution.md
          - Power Analysis (Sample Size Planning): cards/probability-stats/power-analysis.md
          - Probability Distribution: cards/probability-stats/probability-distribution.md
          - Random Variable: cards/probability-stats/random-variable.md
          - Standard Deviation: cards/probability-stats/standard-deviation.md
          - Statistical Power: cards/probability-stats/statistical-power.md
          - Two-Sample t-Test (Welch): cards/probability-stats/t-test-two-sample.md
          - Type I and Type II Errors: cards/probability-stats/type-i-type-ii-errors.md
          - Uniform Distribution: cards/probability-stats/uniform-distribution.md
          - Variance: cards/probability-stats/variance.md
          - Z-Score: cards/probability-stats/z-score.md
      - Signal Processing:
          - Aliasing: cards/signal-processing/aliasing.md
          - Convolution: cards/signal-processing/convolution.md
          - Discrete Fourier Transform: cards/signal-processing/dft.md
          - Fast Fourier Transform: cards/signal-processing/fft.md
          - Fourier Transform: cards/signal-processing/fourier-transform.md
          - Nyquist-Shannon Sampling Theorem: cards/signal-processing/sampling-theorem.md

theme:
  name: material
  features:
    - navigation.instant
    - navigation.sections
    - search.suggest
    - search.highlight

markdown_extensions:
  - admonition
  - footnotes
  - md_in_html
  - tables
  - toc:
      permalink: true
  - pymdownx.arithmatex:
      generic: true

extra_css:
  - assets/styles.css

extra_javascript:
  - assets/mathjax-config.js
  - assets/tag-pills.js
  - assets/formula-of-day.js
  - https://cdn.jsdelivr.net/npm/d3@7/dist/d3.min.js
  - https://cdn.jsdelivr.net/npm/function-plot/dist/function-plot.js
  - assets/plot-blocks.js
  - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-svg.js