{"id":30426062,"url":"https://github.com/ggupta2005/data.understand","last_synced_at":"2026-04-18T11:03:52.218Z","repository":{"id":177073710,"uuid":"626639664","full_name":"ggupta2005/data.understand","owner":"ggupta2005","description":"Repository for generating insights like value distribution, class imbalance for tabular datasets","archived":false,"fork":false,"pushed_at":"2024-04-18T20:39:15.000Z","size":190,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-13T20:28:36.812Z","etag":null,"topics":["data-science","dataset","jupyter-notebook","pdf-generation"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ggupta2005.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-04-11T21:51:46.000Z","updated_at":"2023-07-14T18:42:30.000Z","dependencies_parsed_at":"2023-11-24T05:20:51.718Z","dependency_job_id":"85959626-336d-4117-a376-403700bf92c4","html_url":"https://github.com/ggupta2005/data.understand","commit_stats":null,"previous_names":["ggupta2005/data.understand"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ggupta2005/data.understand","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggupta2005%2Fdata.understand","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggupta2005%2Fdata.understand/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggupta2005%2Fdata.understand/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggupta2005%2Fdata.understand/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ggupta2005","download_url":"https://codeload.github.com/ggupta2005/data.understand/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggupta2005%2Fdata.understand/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31966218,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-science","dataset","jupyter-notebook","pdf-generation"],"created_at":"2025-08-22T12:16:32.396Z","updated_at":"2026-04-18T11:03:52.197Z","avatar_url":"https://github.com/ggupta2005.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# data-understand\n![PyPI data-understand](https://img.shields.io/pypi/v/data-understand)\n![MIT license](https://img.shields.io/badge/License-MIT-blue.svg)\n![versions](https://img.shields.io/pypi/pyversions/data-understand)\n[![Downloads](https://static.pepy.tech/badge/data-understand)](https://pepy.tech/project/data-understand)\n\n[![Run Python E2E Tests](https://github.com/ggupta2005/data.understand/actions/workflows/python-e2e-tests.yml/badge.svg)](https://github.com/ggupta2005/data.understand/actions/workflows/python-e2e-tests.yml)\n[![Run Python Unit Tests](https://github.com/ggupta2005/data.understand/actions/workflows/python-unit-tests.yml/badge.svg)](https://github.com/ggupta2005/data.understand/actions/workflows/python-unit-tests.yml)\n\n[![CodeFactor](https://www.codefactor.io/repository/github/ggupta2005/data.understand/badge)](https://www.codefactor.io/repository/github/ggupta2005/data.understand)\n\n## Motivation\nAs data scientists and machine learning engineers, we are often required to execute various data science tasks like loading up the dataset into a pandas dataframe, inspecting the columns/rows in the dataset, visualizing the distribution of values, finding feature correlations and determining if there are any sort of imbalances in the dataset. Often these tasks are repetitive and involve creating multiple jupyter notebooks and we have to manage these jupyter notebooks separately with different handles to the location of input dataset. How about you have one tool which could take the directory location of your dataset and generate the boring aforementioned logic for you to execute and learn the same insights about your dataset. All you need to do is to install this tool in your local python environment and then execute the tool from a command line.\n\n## Installation\nYou can install the package `data-understand` from pypi using the following command:-\n\n```\npip install data-understand\n```\n\n## Usage\nOnce you have installed the tool locally, you can then look at the various options of the CLI tool:-\n\n```\ndata_understand -h\n========================================================================================================================\n========================================================================================================================\nusage: data_understand [-h] [-f FILE_NAME] [-t TARGET_COLUMN] [-p] [-j]\n\ndata.understand CLI\n\noptions:\n  -h, --help            show this help message and exit\n  -f FILE_NAME, --file_name FILE_NAME\n                        Directory path to CSV file\n  -t TARGET_COLUMN, --target_column TARGET_COLUMN\n                        Target column name\n  -p, --generate_pdf    Generate PDF file for understanding of data\n  -j, --generate_jupyter_notebook\n                        Generate jupyter notebook file for understanding of data\n```\n\n## Notebook and PDF report generation\nIn order to generate both PDF report and jupyter notebook you can execute the following CLI command:-\n\n```\ndata_understand --file_name adult_dataset.csv --target_column income --generate_pdf --generate_jupyter_notebook\n========================================================================================================================\n========================================================================================================================\nThe parsed arguments are:- \nfile_name: adult_dataset.csv\ntarget_column: income\ngenerate_pdf: True\ngenerate_jupyter_notebook: True\nTime taken: 0.0 min 0.0012356000000863787 sec\n========================================================================================================================\nGenerating PDF report and jupyter notebook\n========================================================================================================================\nGenerating PDF report for the dataset in adult_dataset.csv\nSuccessfully generated PDF report for the dataset in adult_dataset.csv at adult_dataset.csv.pdf\nTime taken: 0.0 min 7.363417799999979 sec\n========================================================================================================================\n========================================================================================================================\nGenerating jupyter notebook for the dataset in adult_dataset.csv\nSuccessfully generated jupyter notebook for the dataset in adult_dataset.csv at adult_dataset.csv.ipynb\nTime taken: 0.0 min 0.053841799999986506 sec\n========================================================================================================================\nSuccessfully generated PDF report and jupyter notebook\nTime taken: 0.0 min 7.485209299999951 sec\n========================================================================================================================\n```\n\nThis would generate the jupyter notebook and PDF report in the same directory location as your dataset. You can execute the cells in the jupyter notebook to generate various insights and graphs on the fly or you can read through the PDF report to learn about various aspects of your dataset.\n\n## Repos using `data-understand` to generate notebooks and PDF reports\n- [understanding-datasets](https://github.com/ggupta2005/understanding-datasets)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fggupta2005%2Fdata.understand","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fggupta2005%2Fdata.understand","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fggupta2005%2Fdata.understand/lists"}