BundleAdjustmentModels

Julia repository of bundle adjustment problems

https://github.com/juliasmoothoptimizers/bundleadjustmentmodels.jl

Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

✓
CITATION.cff file
Found CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
○
DOI references
✓
Academic publication links
Links to: zenodo.org
○
Committers with academic emails
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (12.4%) to scientific vocabulary

Keywords

bundle-adjustment julia least-squares nlpmodels nlsmodels

Keywords from Contributors

ipopt nonlinear-programming

Last synced: 6 months ago · JSON representation ·

Repository

Julia repository of bundle adjustment problems

Basic Info

Host: GitHub
Owner: JuliaSmoothOptimizers
License: mpl-2.0
Language: Julia
Default Branch: main
Homepage:
Size: 1.38 MB

Statistics

Stars: 9
Watchers: 4
Forks: 6
Open Issues: 6
Releases: 9

Topics

bundle-adjustment julia least-squares nlpmodels nlsmodels

Created over 4 years ago · Last pushed 6 months ago

Metadata Files

Readme License Citation

BundleAdjustmentModels

| Documentation | CI | Coverage | Release | DOI | |:-----------------:|:------:|:------------:|:-----------:|:-------:| | | | | | |

Julia repository of bundle adjustment problems from the repository Bundle Adjustment in the Large.

How to Cite

If you use BundleAdjustmentModels.jl in your work, please cite using the format given in CITATION.cff.

Bug Reports and Discussions

If you think you found a bug, feel free to open an issue. Focused suggestions and requests can also be opened as issues. Before opening a pull request, please start an issue or a discussion on the topic.

If you want to ask a question not suited for a bug report, feel free to start a discussion here.

Examples

Loading and Exploring Problems

```julia using BundleAdjustmentModels, DataFrames

Get a DataFrame with all problems

df = problems_df()

Show first few rows

first(df, 5) julia 5×5 DataFrame Row │ name group nequ nvar nnzj
│ String String Int64 Int64 Int64
─────┼───────────────────────────────────────────────────────── 1 │ problem-16-22106 dubrovnik 167436 66462 2009232 2 │ problem-88-64298 dubrovnik 767874 193686 9214488 3 │ problem-135-90642 dubrovnik 1106672 273141 13280064 4 │ problem-142-93602 dubrovnik 1131216 282084 13574592 5 │ problem-150-95821 dubrovnik 1136238 288813 13634856 ```

The DataFrame has the following columns:

name: Problem name.
group: Group to which the problem belongs.
nequ: Number of equations (rows).
nvar: Number of variables (columns).
nnzj: Number of non-zero elements in the Jacobian.

Filtering problems

You can filter problems based on specific criteria. For instance:

```julia

Select problems with more than 50000 equations and less than 34000 variables

filterdf = filter(pb -> pb.nequ >= 50000 && pb.nvar <= 34_000, df) ```

Accessing problem names

Extract the name of the first problem in the filtered DataFrame:

julia name = filter_df[1, :name]

Fetching artifacts

Download the problem artifact for the given name:

julia path = fetch_ba_name(name)

Nonlinear least-squares models

Create a nonlinear least-squares model:

julia using NLPModels model = BundleAdjustmentModel(name)

You can evaluate residuals and Jacobians using functions from NLPModels.

julia residuals = residual(model, model.meta.x0)

Compute the Jacobian structure:

julia rows = Vector{Int}(undef, model.nls_meta.nnzj) cols = Vector{Int}(undef, model.nls_meta.nnzj) jac_structure_residual!(model, rows, cols)

Evaluate Jacobian values:

julia vals = Vector{Float64}(undef, length(rows)) jac_coord_residual!(model, model.meta.x0, vals)

Cleaning up artifacts

Delete specific or all downloaded artifacts:

julia delete_ba_artifact!(name) # Delete one artifact delete_all_ba_artifacts!() # Delete all artifacts

Special thanks to Célestine Angla for her initial work on this project during her internship.

License

Licensed under the MPL-2.0 License.

Owner

Name: JuliaSmoothOptimizers
Login: JuliaSmoothOptimizers
Kind: organization
Location: DOI: 10.5281/zenodo.2655082

Website: https://juliasmoothoptimizers.github.io
Repositories: 63
Profile: https://github.com/JuliaSmoothOptimizers

Infrastructure and Solvers for Continuous Optimization in Julia

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
type: software
authors:
  - family-names: "Kenens"
    given-names: "Antonin"
  - family-names: "Orban"
    given-names: "Dominique"
    email: dominique.orban@gerad.ca
    orcid: 'https://orcid.org/0000-0002-8017-7687'
    affiliation: >-
      GERAD and Department of Mathematics and
      Industrial Engineering, Polytechnique Montréal,
      QC, Canada
  - name: "contributors"
title: "BundleAdjustmentModels.jl: Julia repository of bundle adjustment problems"
date-released: '2023-03-29'
version: 0.3.2
license: MPL-2.0
repository-code: "https://github.com/JuliaSmoothOptimizers/BundleAdjustmentModels.jl"
keywords:
  - Least squares
  - Julia
  - Bundle Adjustment
identifiers:
  - description: Zenodo archive
    type: doi
    value: 10.5281/zenodo.5167631

GitHub Events

Total

Create event: 9
Commit comment event: 4
Release event: 1
Issues event: 4
Delete event: 8
Issue comment event: 13
Push event: 49
Pull request review comment event: 2
Pull request review event: 3
Pull request event: 17

Last Year

Create event: 9
Commit comment event: 4
Release event: 1
Issues event: 4
Delete event: 8
Issue comment event: 13
Push event: 49
Pull request review comment event: 2
Pull request review event: 3
Pull request event: 17

Committers

Last synced: almost 3 years ago

All Time

Total Commits: 79
Total Committers: 7
Avg Commits per committer: 11.286
Development Distribution Score (DDS): 0.57

Top Committers

Name	Email	Commits
AntoninKns	a**s@e**r	34
AntoninKns	4**s@u**m	20
Dominique Orban	d**n@g**m	9
tmigot	t**t@g**m	8
dpo	d**o@u**m	4
github-actions[bot]	4**]@u**m	3
AntoninKns	A**s@u**m	1

Committer Domains (Top 20 + Academic)

etu.enseeiht.fr: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time

Total issues: 18
Total pull requests: 82
Average time to close issues: 6 months
Average time to close pull requests: about 2 months
Total issue authors: 7
Total pull request authors: 6
Average comments per issue: 1.61
Average comments per pull request: 1.49
Merged pull requests: 62
Bot issues: 0
Bot pull requests: 21

Past Year

Issues: 3
Pull requests: 14
Average time to close issues: 6 months
Average time to close pull requests: about 4 hours
Issue authors: 1
Pull request authors: 3
Average comments per issue: 0.33
Average comments per pull request: 0.14
Merged pull requests: 10
Bot issues: 0
Bot pull requests: 7

View more stats

Top Authors

Issue Authors

dpo (6)
amontoison (3)
abelsiqueira (3)
tmigot (2)
AntoninKns (2)
github-actions[bot] (1)
farhadrclass (1)
maleadt (1)
JuliaTagBot (1)

Pull Request Authors

AntoninKns (37)
github-actions[bot] (28)
tmigot (21)
amontoison (9)
dpo (4)
Jay-sanjay (2)
farhadrclass (1)

Top Labels

Issue Labels

bug (1) documentation (1) good first issue (1) formatting (1) automated pr (1) no changelog (1)

Pull Request Labels

formatting (23) automated pr (23) no changelog (23) documentation (4)

Packages

Total packages: 1
Total downloads: unknown

Total dependent packages: 0
Total dependent repositories: 0
Total versions: 9

juliahub.com: BundleAdjustmentModels

Documentation: https://docs.juliahub.com/General/BundleAdjustmentModels/stable/
License: mpl-2.0
Latest release: 0.4.0
published 10 months ago

Versions: 9
Dependent Packages: 0
Dependent Repositories: 0

Rankings

Dependent repos count: 9.9%

Forks count: 24.5%

Average: 26.9%

Stargazers count: 34.1%

Dependent packages count: 38.9%

Last synced: 6 months ago

Dependencies

.github/workflows/CompatHelper.yml actions

julia-actions/setup-julia latest composite

.github/workflows/Documentation.yml actions

actions/checkout v2 composite
julia-actions/setup-julia latest composite

.github/workflows/TagBot.yml actions

JuliaRegistries/TagBot v1 composite

.github/workflows/ci.yml actions

actions/cache v1 composite
actions/checkout v2 composite
codecov/codecov-action v1 composite
julia-actions/julia-buildpkg v1 composite
julia-actions/julia-processcoverage v1 composite
julia-actions/julia-runtest v1 composite
julia-actions/setup-julia v1 composite

.github/workflows/fromat_pr.yml actions

actions/checkout v2 composite
peter-evans/create-pull-request v3 composite

BundleAdjustmentModels

Science Score: 54.0%

Keywords

Keywords from Contributors

Repository

Basic Info

Statistics

Topics

Metadata Files

README.md

BundleAdjustmentModels

How to Cite

Bug Reports and Discussions

Examples

Loading and Exploring Problems

Get a DataFrame with all problems

Show first few rows

Filtering problems

Select problems with more than 50000 equations and less than 34000 variables

Accessing problem names

Fetching artifacts

Nonlinear least-squares models

Cleaning up artifacts

License

Owner

Citation (CITATION.cff)

GitHub Events

Total

Last Year

Committers

All Time

Top Committers

Committer Domains (Top 20 + Academic)

Issues and Pull Requests

All Time

Past Year

Top Authors

Issue Authors

Pull Request Authors

Top Labels

Issue Labels

Pull Request Labels

Packages

juliahub.com: BundleAdjustmentModels

Rankings

Dependencies