Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Add a white paper for line surface jacobian #2657

Merged
merged 3 commits into from
Dec 14, 2023

Conversation

beomki-yeo
Copy link
Contributor

@beomki-yeo beomki-yeo commented Nov 13, 2023

This PR adds a white paper for line surface jacobian

Abstract:

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. 
In this white paper, we attempt to derive the jacobians for both of local-to-global and global-to-local transforms.

The whitepaper contains the calculation of local-to-global transformation jacobian but it doesn't include global-to-local one, which I left for future authors (I didn't manage to solve it)

Update: global to local jacobian calculation is updated.

@github-actions github-actions bot added the Component - Documentation Affects the documentation label Nov 13, 2023
@beomki-yeo beomki-yeo closed this Nov 13, 2023
@beomki-yeo beomki-yeo reopened this Nov 13, 2023
@github-actions github-actions bot added the Component - Core Affects the Core module label Nov 13, 2023
Copy link

codecov bot commented Nov 13, 2023

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (1b29c4c) 48.62% compared to head (7f5d4c2) 48.62%.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #2657   +/-   ##
=======================================
  Coverage   48.62%   48.62%           
=======================================
  Files         480      480           
  Lines       28033    28033           
  Branches    13263    13263           
=======================================
  Hits        13630    13630           
  Misses       4803     4803           
  Partials     9600     9600           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@beomki-yeo beomki-yeo force-pushed the white-paper-1 branch 2 times, most recently from 67a14a1 to 356ce99 Compare November 17, 2023 08:41
@paulgessinger paulgessinger added this to the next milestone Dec 6, 2023
@paulgessinger
Copy link
Member

Sorry, this got held up unfortunately. @beomki-yeo, could you fix the conflict?

@beomki-yeo
Copy link
Contributor Author

beomki-yeo commented Dec 6, 2023

Of course. Meanwhile, I figured out the rest of calculations so I will update with it.

@beomki-yeo
Copy link
Contributor Author

I guess it is good to go now

@beomki-yeo
Copy link
Contributor Author

@andiwand @paulgessinger Any review on this?

andiwand
andiwand previously approved these changes Dec 12, 2023
Copy link
Contributor

@andiwand andiwand left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

haven't read the paper yet but I am happy to put it in as is

@andiwand
Copy link
Contributor

sorry I just took a quick look and I have a few comments but no need to implement this right away

  • the local parameter is hard to read for me as is almost looks like a 1
  • I thought that it might be good make $\phi$ distinguishable in the two representations but I guess it is fine as it is exactly the same thing
  • maybe a full vector representation of the global and local params would help
  • personally I would make the subscript for the jacobian more explicit like L->G and G->L
  • a full matrix representation of the J would be nice

@beomki-yeo
Copy link
Contributor Author

Thanks I will modify the manuscript except this:

a full matrix representation of the J would be nice

It's super painful to write a full matrix representation, and it is not very necessary I suppose

@beomki-yeo
Copy link
Contributor Author

@paulgessinger @andiwand can you merge this?

andiwand
andiwand previously approved these changes Dec 13, 2023
@acts-policybot acts-policybot bot dismissed andiwand’s stale review December 13, 2023 17:54

Invalidated by push of b9a81fc

@beomki-yeo
Copy link
Contributor Author

This got hung up again :/ Shouldn't we have to reduce the threads in gitlab CI as we did for traccc?

@paulgessinger
Copy link
Member

The job that fails is the most important one, and it's because of OOM.

I think we increased our build memory consumption again in the recent weeks.

@paulgessinger paulgessinger merged commit bbbbf6b into acts-project:main Dec 14, 2023
52 checks passed
@acts-project-service
Copy link
Collaborator

acts-project-service commented Dec 14, 2023

✅ Athena integration test results [bbbbf6b]

✅ All tests successful

status job report
🟢 run_unit_tests
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsBenchmarkWithSpot.sh 8 100
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsWorkflow.sh
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsValidateAmbiguityResolution.sh
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsValidateResolvedTracks.sh
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsValidateTracks.sh
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsValidateActsCoreSpacePoints.sh
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsValidateActsSpacePoints.sh
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsValidateSeeds.sh
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsValidateOrthogonalSeeds.sh
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsValidateClusters.sh
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsPersistifyEDM.sh
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsGSFRefitting.sh
🟢 run_ci_tests: ../athena/AtlasTest/CITest/test/ActsKfRefitting.sh
🟢 run_ci_tests: python3 ../athena/Tracking/Acts/ActsGeometry/test/ActsExtrapolationAlgTest.py
🟢 run_ci_tests: python3 ../athena/Tracking/Acts/ActsGeometry/test/ActsITkTest.py
🟢 run_workflow_tests_run4_mc
🟢 run_workflow_tests_run2_mc
🟢 run_workflow_tests_run2_data
🟢 run_workflow_tests_run3_mc
🟢 run_workflow_tests_run3_data
🟢 run_art_test: test_data18_13TeV_1000evt
🟢 run_art_test: test_ttbarPU40_reco

@acts-project-service acts-project-service added the Breaks Athena build This PR breaks the Athena build label Dec 14, 2023
@paulgessinger paulgessinger modified the milestones: next, v32.0.0 Jan 19, 2024
@paulgessinger paulgessinger removed the Breaks Athena build This PR breaks the Athena build label Jan 23, 2024
LaraCalic pushed a commit to LaraCalic/acts that referenced this pull request Feb 10, 2024
This PR adds a white paper for line surface jacobian

Abstract:
```
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. 
In this white paper, we attempt to derive the jacobians for both of local-to-global and global-to-local transforms.
```

~~The whitepaper contains the calculation of local-to-global
transformation jacobian but it doesn't include global-to-local one,
which I left for future authors (I didn't manage to solve it)~~

Update: global to local jacobian calculation is updated.

Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Component - Core Affects the Core module Component - Documentation Affects the documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants