Package: vega-datasets
vega_datasetsA Python package for offline access tovega datasets.This package has several goals:Provide straightforward access in Python to the datasets made available atvega-datasets.return the results in the form of a Pandas dataframe.wherever dataset size and/or license constraints make it possible, bundle the dataset with the package so that datasets can be loaded in the absence of a web connection.Currently the package bundles a half-dozen datasets, and falls back to using HTTP requests for the others.Installationvega_datasetsis compatible with Python 3.5 or newer. Install with:$ pip install vega_datasetsUsageThe main object in this library isdata:>>>fromvega_datasetsimportdataIt contains attributes that access all available datasets, locally if
available. For example, here is the well-known iris dataset:>>>df=data.iris()>>>df.head()petalLengthpetalWidthsepalLengthsepalWidthspecies01.40.25.13.5setosa11.40.24.93.0setosa21.30.24.73.2setosa31.50.24.63.1setosa41.40.25.03.6setosaIf you're curious about the source data, you can access the URL for any of the available datasets:>>>data.iris.url'https://cdn.jsdelivr.net/npm/vega-datasets@v1.29.0/data/iris.json'For datasets bundled with the package, you can also find their location on disk:>>>data.iris.filepath'/lib/python3.6/site-packages/vega_datasets/data/iris.json'Available DatasetsTo list all the available datsets, uselist_datasets:>>>data.list_datasets()['7zip','airports','anscombe','barley','birdstrikes','budget','budgets','burtin','cars','climate','co2-concentration','countries','crimea','disasters','driving','earthquakes','ffox','flare','flare-dependencies','flights-10k','flights-200k','flights-20k','flights-2k','flights-3m','flights-5k','flights-airport','gapminder','gapminder-health-income','gimp','github','graticule','income','iris','jobs','londonBoroughs','londonCentroids','londonTubeLines','lookup_groups','lookup_people','miserables','monarchs','movies','normal-2d','obesity','points','population','population_engineers_hurricanes','seattle-temps','seattle-weather','sf-temps','sp500','stocks','udistrict','unemployment','unemployment-across-industries','us-10m','us-employment','us-state-capitals','weather','weball26','wheat','world-110m','zipcodes']To list local datasets (i.e. those that are bundled with the package and can be used without a web connection), use thelocal_dataobject instead:>>>fromvega_datasetsimportlocal_data>>>local_data.list_datasets()['airports','anscombe','barley','burtin','cars','crimea','driving','iowa-electricity','iris','seattle-temps','seattle-weather','sf-temps','stocks','us-employment',"wheat"]We plan to add more local datasets in the future, subject to size and licensing constraints. See thelocal datasets issueif you would like to help with this.Dataset InformationIf you want more information about any dataset, you can use thedescriptionproperty:>>>data.iris.description'This classic dataset contains lengths and widths of petals and sepals for 150 iris flowers, drawn from three species. It was introduced by R.A. Fisher in 1936 [1]_.'This information is also part of thedata.irisdoc string.
Descriptions are not yet included for all the datasets in the package; we hope to add more information on this in the future.