Skip to content

Commit

Permalink
Add a line surface jacobian white paper
Browse files Browse the repository at this point in the history
  • Loading branch information
beomki-yeo committed Dec 13, 2023
1 parent 636eff4 commit 3dbf7fb
Show file tree
Hide file tree
Showing 3 changed files with 13 additions and 0 deletions.
4 changes: 4 additions & 0 deletions Core/src/Surfaces/LineSurface.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -227,6 +227,10 @@ Acts::BoundToFreeMatrix Acts::LineSurface::boundToFreeJacobian(
jacToGlobal(eFreeDir2, eBoundTheta) = -sinTheta;
jacToGlobal(eFreeQOverP, eBoundQOverP) = 1;

// For the derivative of global position with bound angles, refer the
// following white paper:
// https://acts.readthedocs.io/en/latest/white_papers/line-surface-jacobian.html

// the projection of direction onto ref frame normal
double ipdn = 1. / direction.dot(rframe.col(2));
// build the cross product of d(D)/d(eBoundPhi) components with y axis
Expand Down
9 changes: 9 additions & 0 deletions docs/white_papers.toml
Original file line number Diff line number Diff line change
Expand Up @@ -34,3 +34,12 @@ pdf_url = "https://github.com/felix-russo/billoir-covariances/releases/download/
authors = [ "Felix Russo",]
title = "Cross-Covariance Matrices in the Billoir Vertex Fit"
description = "In this white paper we derive\n\\begin{itemize}\n \\item the 4x4 covariance matrix of the vertex position,\n \\item the 4x3 cross-covariance matrix between the vertex position and the $i$-th particle momentum,\n \\item and the 3x3 cross-covariance matrix between the $i$-th and the $j$-th particle momentum.\n\\end{itemize}"
[[white_papers]]
repository = "https://github.com/beomki-yeo/line_surface"
slug = "line-surface-jacobian"
pdf_url = "https://github.com/beomki-yeo/line_surface/releases/download/v7.0/main.pdf"

[white_papers.metadata]
authors = [ "Beomki Yeo",]
title = "Line Surface Jacobian"
description = "Line surface used for wire measurements or perigee surface is an unique type of surface where the intersections of a track is not defined on a physical plane. Due to this trait, the underlying mathematics gets quite complicated especially with coordinate transform jacobian whose reference was missing in the source code. (Please let the authors know if anyone finds it). In this white paper, thus we attempt to derive the jacobians for both local-to-global and global-to-local transforms."
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 3dbf7fb

Please sign in to comment.