Package: dbcollection
NoteFor the latest source, discussion, etc, please visit theGitHub repositorydbcollectiondbcollectionis a library for downloading/parsing/managing datasets via simple methods.
It was built from the ground up to be cross-platform (Windows,Linux,MacOS) and
cross-language (Python,Lua,Matlab, etc.). This is achieved by using the popularHDF5file format to store (meta)data of manually parsed datasets and the power of Python for
scripting. By doing so, this library can target any platform that supports Python and
any language that has bindings forHDF5.This package allows to easily manage and load datasets by usingHDF5files to store
metadata. By storing all the necessary metadata to disk, managing either big or small
datasets has an equal or very similar impact on the system’s resource usage.
Also, once a dataset is setup, it is setup forever! This means users can reuse any
previously set dataset as many times as needed without having to set it each time they
are used.dbcollectionallows users to focus on more important tasks like prototyping new models
or testing them in different datasets without having to incur the loss of spending time managing
datasets or creating/modyfing scripts to load/fetch data by taking advantage
of the work of the community that shared these resources.Main featuresHere are some of key features dbcollection provides:Simple API to load/download/setup/manage datasets.Simple API to fetch data from a dataset.Store and pull data from disk or from memory, you choose!Datasets only need to be set/processed once, so next time you use it it will load instantly!Cross-platform (Windows,Linux,MacOs).Cross-language (Python,Lua/Torch7,Matlab).Easily extensible to other languages that supportHDF5files format.Concurrent/parallel data access thanks toHDF5.Contains a diverse (and growing!) list of popular datasets for machine-, deep-learning tasks
(object detection,action recognition,human pose estimation, etc.)Supported languagesPython (>=2.7 or >=3.5)Lua/Torch7 (link)Matlab (>=2014a)
(link)Package installationFrom PyPiInstallingdbcollectionusing pip is simple. For that purpose,
simply do the following command:$ pip install dbcollectionFrom sourceTo installdbcollectionfrom source you need to do the following
setps:Clone the repo to your hard drive:$ git clone --recursive https://github.com/dbcollection/dbcollectioncdto the dbcollection folder and do the command$ python setup.py installGetting startedBasic usageUsing the module is pretty straight-forward. To import it just do:>>>importdbcollectionasdbcTo load a dataset, you only need to use a single method that returns a
data loader object which can then be used to fetch data from.>>>mnist=dbc.load('mnist')This data loader object contains information about the dataset’s name,
task, data, cache paths, set splits, and some methods for querying and
loading data from theHDF5metadata file.For example, if you want to know how the data is structured inside the
metadata file, you can simply do the following:>>>mnist.info()>Set:test-classes,shape=(10,2),dtype=uint8-images,shape=(10000,28,28),dtype=uint8,(in'object_ids',position=0)-labels,shape=(10000,),dtype=uint8,(in'object_ids',position=1)-object_fields,shape=(2,7),dtype=uint8-object_ids,shape=(10000,2),dtype=uint8(Pre-orderedlists)-list_images_per_class,shape=(10,1135),dtype=int32>Set:train-classes,shape=(10,2),dtype=uint8-images,shape=(60000,28,28),dtype=uint8,(in'object_ids',position=0)-labels,shape=(60000,),dtype=uint8,(in'object_ids',position=1)-object_fields,shape=(2,7),dtype=uint8-object_ids,shape=(60000,2),dtype=uint8(Pre-orderedlists)-list_images_per_class,shape=(10,6742),dtype=int32To fetch data samples from a field, its is as easy as calling a method
with the set and field names and the row id(s) you want to select. For
example, to retrieve the 10 first images all you need to do is the
following:>>>imgs=mnist.get('train','images',range(10))>>>imgs.shape(10,28,28)Note: For more information about using this module, please check the
documentation or the available notebooks for guidance.NotebooksFor a more pratical introduction todbcollection’smodule for
managing datasets and fetching data, there are some python notebooks
available in thenotebooks/folder for a more hands-on tutorial on
how to use this package.DocumentationThe package documentation is hosted onRead The Docs.It provides a more detailed guide on how to use this package as well as
additional information that you might find relevant about this project.ContributingAll contributions, bug reports, bug fixes, documentation improvements,
enhancements and ideas are welcome. If you would like to see additional
languages being supported, please consider contributing to the project.If you are interested in fixing issues and contributing directly to the
code base, please see the documentHow to Contribute.FeedbackFor now, use theGithub issuesfor requests/bug issues or use ourGitter roomfor any other questions you may have.LicenseMIT License