Package: giza-datasets
Giza DatasetsWelcome to the Giza Datasets repository. Here you can find a collection of datasets ready to be used for blockchain ML use cases. Familiarize yourself with the ease of using dataframes through ourDatasetsLoaderclass.Before discovering how our library works, if you want to find detailed information about each dataset provided by Giza, access ourdocumentation! You will find usage examples for each dataset, the schema of each one with descriptions of every field, the relationship between the datasets, potential use cases for them, and much more!Enhanced FeaturesExplore the robust capabilities of the Giza Datasets repository:Streamlined Dataset Access: Instantly connect to a curated collection of blockchain datasets, ready for machine learning applications, with no configuration needed.Effortless Data Loading: Utilize theDatasetsLoaderclass to easily load Parquet files, streamlining your data workflow.Optimized Data Handling: Leverage the integration with thepolars library, designed for efficient manipulation of large datasets. For detailed guidance on using polars for dataset operations, refer to thepolars documentation.Quick StartTo get started with Giza Datasets, follow the steps below:Install thegiza-datasetspackage if you haven't already:pip install giza-datasetsImport theDatasetsLoaderclass and initialize it:fromgiza_datasetsimportDatasetsLoaderloader=DatasetsLoader()Optional: Depending on your device's configuration, it may be necessary to provide SSL certificates to verify the authenticity of HTTPS connections. You can ensure that all these certifications are correct by executing the following line of code:importcertifiimportosos.environ['SSL_CERT_FILE']=certifi.where()Load a dataset using theloadmethod. For example, to loadtvl-fee-per-protocol:df=loader.load('tvl-fee-per-protocol')To view the loaded dataset, simply print the dataframe:print(df)Start exploring the datasets and building your machine learning models with ease!Datasets HubTheDatasetsHubclass provides methods to manage and access datasets. Here are some of its methods:show(): Prints a table of all datasets in the hub.list(): Returns a list of all datasets in the hub.get(dataset_name): Returns a Dataset object with the given name.describe(dataset_name): Prints a table of details for the given dataset.To get started with theDatasetsHubclass, follow the steps below:Import theDatasetsHubclass and initialize it:fromgiza_datasetsimportDatasetsHubhub=DatasetsHub()Use theshowmethod to print a table of all datasets in the hub:hub.show()Use thelistmethod to get a list of all datasets in the hub:datasets=hub.list()print(datasets)Use thegetmethod to get a Dataset object with a given name:dataset=hub.get('tvl-fee-per-protocol')print(dataset)Use thedescribemethod to print a table of details for a given dataset:hub.describe('tvl-fee-per-protocol')Use thelist_tagsmethod to print a list of all tags in the hub.hub.list_tags()Use theget_by_tagmethod to a list of Dataset objects with the given tag.hub.get_by_tag('Liquidity')ContributingWe welcome contributions to the Giza Datasets repository. If you have suggestions for improvements or new features, feel free to open an issue or submit a pull request.LicenseThis project is licensed under the MIT License - see the LICENSE file for details.