# Benchmarking / profiling helpers for asy. # # Default target runs callgrind on a benchmark script and produces an # annotated, human-readable summary of where asy spends its cycles. # # Usage: # make # build asy with debug symbols, profile, and annotate # make callgrind # produce raw callgrind output only # make annotate # produce annotated text from existing callgrind output # make clean # remove generated profile artifacts # # Parameters (override on the command line, e.g. `make BENCH=set.asy`): # BENCH Asymptote source file to profile (default: map.asy) # BENCH_OPTS -u settings string passed to asy (default: maxOperations=500000) # ASY_ROOT Path to the asymptote source root (default: ../..) # CFLAGS Compiler flags used when (re)building asy # CALLGRIND_EXTRA_OPTS Extra flags passed to valgrind --tool=callgrind # ANNOTATE_OPTS Flags passed to callgrind_annotate # (default: --auto=yes --threshold=99.5) BENCH ?= map.asy BENCH_OPTS ?= maxOperations=500000 ASY_ROOT ?= ../.. CFLAGS ?= -g -O3 CALLGRIND_EXTRA_OPTS ?= ANNOTATE_OPTS ?= --auto=yes --threshold=99.5 ASY := $(ASY_ROOT)/asy ASY_BASE := $(ASY_ROOT)/base BENCH_STEM := $(basename $(BENCH)) CALLGRIND_OUT := callgrind.out.$(BENCH_STEM) ANNOTATED_OUT := callgrind.annotated.$(BENCH_STEM).txt .PHONY: all asy callgrind annotate clean check-tools top-function all: annotate # Build asy via the existing autotools build with debug symbols enabled. # `make` in the project root is a no-op if asy is already up to date. asy: $(MAKE) -C $(ASY_ROOT) CFLAGS="$(CFLAGS)" asy # Raw callgrind profile. Depends on asy and the benchmark source. $(CALLGRIND_OUT): asy $(BENCH) @command -v valgrind >/dev/null 2>&1 || { \ echo "error: valgrind not found in PATH" >&2; exit 1; } rm -f $(CALLGRIND_OUT) valgrind --tool=callgrind \ --callgrind-out-file=$(CALLGRIND_OUT) \ $(CALLGRIND_EXTRA_OPTS) \ $(ASY) -dir $(ASY_BASE) -u '$(BENCH_OPTS)' $(BENCH) callgrind: $(CALLGRIND_OUT) # Human-readable annotated profile. $(ANNOTATED_OUT): $(CALLGRIND_OUT) @command -v callgrind_annotate >/dev/null 2>&1 || { \ echo "error: callgrind_annotate not found in PATH" >&2; exit 1; } callgrind_annotate $(ANNOTATE_OPTS) $(CALLGRIND_OUT) > $(ANNOTATED_OUT) @echo "Annotated profile written to $(ANNOTATED_OUT)" annotate: $(ANNOTATED_OUT) clean: rm -f callgrind.out.* callgrind.annotated.*.txt