AlansCodeLog / photogrammetry-test-sets

Free to use (CC-BY) images for testing photogrammetry software.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

This is an empty dummy repo*, links to the individual repos for each picture set are below.

License

Creative Commons License
This work is licensed under a Creative Commons Attribution 4.0 International License.

Attribution

To make attribution easy, all the repos have an attribution template filled out with/without links ready to copy.

My Test Sets

Other's Test Sets

See below for how you can contribute.


Other External Test Sets (under varying licenses)

Please file an issue if there are any dead links or you would like a link added.

Downloading

For those that are hosted in github repos, for downloading a specific folder you can either use DownGit or there's a chrome extension called GitZip but you will need a Github account you will need to know how to get a github token. It should also be possible to do a [shallow clone with a sparse checkout]((https://stackoverflow.com/questions/600079/how-do-i-clone-a-subdirectory-only-of-a-git-repository/13738951#13738951), but I've never tried it, since the above is 100x easier.

Links


*Why This is an Empty Repo

Initially I was just going to make one giant gitlab repo (since it's above github's 1GB limit), but it's not possible to download single folders from gitlab as far as I know. I considered making a github organization with all the folders as repos but github doesn't really make it easy to group repos the way gitlab does.

So instead all the photo sets are different repos under one gitlab group. Since repos can also be part of multiple groups, this means, should someone want to contribute any picture sets, their repo/project can just be added to the group.

Contributing

Because of the above, to contribute photos you must use a gitlab repo. I will add any repos to the group that contain images licensed under a CC-BY license*.

For other licenses, or if you don't want to host them on github, etc, I can add a link to the "Other External Test Sets " section, just open an issue or send me an email.

I would prefer full sets that allow for the reconstruction of the entire object, but I will accept partial sets as well.

Repos should be structured similar to mine:

  • Only one set per repo to make them easy for people to download.
  • Number the Images with enough Leading Zeros (do not duplicate numbers throughout the repo, e.g. in the case of folders).
  • Use folders if you changed the lighting/camera settings slightly for some section (e.g. like for photographing the bottom of something).
  • Include the plain text CC License File in the repo.
  • "Embed" the license in the README (like I did above).
  • Link to this repo or the gitlab group.
  • Specify a preferred attribution template.

*Please be sure you are free to license them this way, I'm not responsible for any test sets that are not mine. For example, I think it's a bit of a gray area publishing a picture set of something like a toy or a modern sculpture that is still under copyright, especially given they can/will be used to reconstruct the object.

Sharing a Project

Please file an issue HERE on github before sharing a project/repo.

You will need to request access to the group on gitlab.

Then this is how groups are shared, though the labels are now "Invite Group".

About

Free to use (CC-BY) images for testing photogrammetry software.

License:Creative Commons Attribution 4.0 International