https://github.com/dendibakh/perf-book

The book "Performance Analysis and Tuning on Modern CPU"
https://github.com/dendibakh/perf-book

Last synced: 6 days ago
JSON representation

The book "Performance Analysis and Tuning on Modern CPU"

• Host: GitHub
• URL: https://github.com/dendibakh/perf-book
• Owner: dendibakh
• License: cc0-1.0
• Created: 2021-12-06T18:45:43.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-02-20T15:43:51.000Z (about 2 months ago)
• Last Synced: 2025-04-10T00:15:19.589Z (6 days ago)
• Language: TeX
• Homepage: https://book.easyperf.net/perf_book
• Size: 119 MB
• Stars: 2,945
• Watchers: 77
• Forks: 204
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-gemm - perf-book by Denis Bakhvalov

README

        
[![X (formerly Twitter) Follow](https://img.shields.io/twitter/follow/dendibakh)](https://twitter.com/dendibakh)

![GitHub Repo stars](https://img.shields.io/github/stars/dendibakh/perf-book)

# "Performance Analysis and Tuning on Modern CPUs" by Denis Bakhvalov, et al.

## Building a book (pdf)

At the moment, building the PDF book only works on Windows and Linux. MacOS requires building some components (e.g. pandoc-crossref) from sources.

Requirements:

 * Python3. Install natsort module: `pip install natsort`.

 * [Pandoc](https://pandoc.org/installing.html). Install [version 2.9](https://github.com/jgm/pandoc/releases/tag/2.9.2.1)

 * `pandoc-fignos` and `pandoc-tablenos`. Run `pip install pandoc-fignos pandoc-tablenos`.

 * `pandoc-crossref`. This one requires manual installation. I just downloaded the binary from [here](https://github.com/lierdakil/pandoc-crossref/releases/tag/v0.3.6.4) and copied it to the same place where `pandoc-fignos` is.

 * [MiKTeX](https://miktex.org/download). Check `Yes` for automatic package installation.

Run:

```bash

# Linux bash and Windows cmd prompt

python export_book.py && pdflatex book.tex && bibtex book && pdflatex book.tex && pdflatex book.tex

# Windows powershell

function Run-Block-With-Error($block) {

    $ErrorActionPreference="Stop"

    Invoke-Command -ScriptBlock $block

}

Run-Block-With-Error {python.exe export_book.py; pdflatex book.tex; bibtex book; pdflatex book.tex; pdflatex book.tex}

```

As a result, `book.pdf` will be generated. The first compilation may be slow.

## License

[Creative Commons Zero v1.0 Universal](LICENSE)