{"id":24437422,"url":"https://github.com/arapov/bird-plot","last_synced_at":"2025-03-13T23:09:29.716Z","repository":{"id":272262889,"uuid":"916006483","full_name":"arapov/bird-plot","owner":"arapov","description":"A Python tool that converts Tick.com.au personality profiling data into quadrant-based radar charts for individual, group, and pairwise comparisons of the four bird personality types (Eagle, Dove, Owl, and Peacock).","archived":false,"fork":false,"pushed_at":"2025-03-03T12:37:47.000Z","size":113704,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-09T18:45:50.479Z","etag":null,"topics":["personality-profiling","tick"],"latest_commit_sha":null,"homepage":"https://github.com/arapov/bird-plot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arapov.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}},"created_at":"2025-01-13T09:24:29.000Z","updated_at":"2025-03-03T12:37:51.000Z","dependencies_parsed_at":"2025-02-21T12:20:15.075Z","dependency_job_id":"2ee6c06f-9bf4-45d9-afa0-3272128443bb","html_url":"https://github.com/arapov/bird-plot","commit_stats":null,"previous_names":["arapov/bird-plot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arapov%2Fbird-plot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arapov%2Fbird-plot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arapov%2Fbird-plot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arapov%2Fbird-plot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arapov","download_url":"https://codeload.github.com/arapov/bird-plot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243495498,"owners_count":20299922,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["personality-profiling","tick"],"created_at":"2025-01-20T18:16:27.730Z","updated_at":"2025-03-13T23:09:29.707Z","avatar_url":"https://github.com/arapov.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bird-Plot\n\n**Bird-Plot** is a Python-based visualization tool for generating quadrant-style plots of [tick.com.au](https://tick.com.au)’s four-bird personality styles (Eagle, Dove, Owl, and Peacock). It takes as input a data file (e.g., CSV) of individual or group personality scores and produces informative charts that help users quickly see:\n\n- **Individual** personality radar plots\n- **Team** or **group** distributions in a quadrant layout\n- **Pairwise** comparisons (overlap of two individuals’ personalities)\n\nThese plots are especially useful for workshops, coaching sessions, and team-building exercises, as they visualize how individuals align or differ on the four “bird” dimensions.\n\n[The Tick personality profiling system](https://tick.com.au) has been appreciated by many in the fields of sales training, leadership coaching, and personal development for its simplicity and ease of communication. Bird-Plot leverages this established framework to provide clear, accessible visualizations that help users understand and compare personality traits quickly. While the tool provides valuable insights and serves as a catalyst for discussion and reflection, users are encouraged to complement these insights with additional information and professional judgment.\n\n---\n\n## Table of Contents\n\n1. [Features](#features)\n2. [Installation](#installation)\n3. [Usage](#usage)\n4. [Input Data Format](#input-data-format)\n5. [Example Outputs](#example-outputs)\n\n---\n\n## Features\n\n- **Radar Plot** for individuals:\n\n  - Shows how a single person’s personality scores map onto the four quadrants.\n  - A polygon connecting each dimension’s score.\n\n- **Team/Group Distribution**:\n\n  - Plots multiple people on a quadrant-based chart, illustrating the distribution of personalities in a single view.\n  - Useful for quickly identifying group strengths, diversity, and potential gaps.\n\n- **Pairwise Comparison**:\n  - Overlays two individuals’ radar polygons on the same chart to highlight similarities and differences.\n  - Displays a percentage overlap for a quick gauge of alignment.\n\n---\n\n## Installation\n\n1. **Clone or Download the Repository**\n\n```bash\ngit clone https://github.com/arapov/bird-plot.git\ncd bird-plot\n```\n\n2. **Install Dependencies with Poetry**\n\nThis project uses [Poetry](https://python-poetry.org/) for dependency management.\n\n```bash\npoetry install\n```\n\n3. **(Optional) Activate the Virtual Environment**\n\n```bash\npoetry shell\n```\n\nOr you can use poetry run ... without activating the shell.\n\n4. **Verify Installation**\n\n```bash\npoetry run bird-plot --help\n```\n\nThis should display a help message with usage instructions.\n\n## Usage\n\n1. **Prepare Your Data**\n   Ensure you have a CSV or similar data file that includes each person’s scores. (See [Input Data Format](#input-data-format) below.)\n\n2. **Run Bird-Plot**\n\n```bash\npoetry run bird-plot --data data.csv --graph radar scatter\n```\n\n- --data Path to the CSV data file (default: data.csv)\n- --graph Type of graph to generate (radar or scatter)\n\n3. **Check Generated Plots**\n\nThe script will create .png files in the charts folder.\n\n_Note: Run `poetry run bird-plot --help` for detailed usage._\n\n## Input Data Format\n\n| Name  | Dove | Eagle | Owl | Peacock | Note |\n| ----- | ---- | ----- | --- | ------- | ---- |\n| Grace | 15   | 12    | 5   | 17      | P/D  |\n| Henry | 4    | 10    | 12  | 0       | O/E  |\n| ...   | ...  | ...   | ... | ...     | ...  |\n\n- **Name**: The individual’s name or identifier.\n- **Dove, Eagle, Owl, Peacock**: Numeric scores representing each “bird” trait.\n- **Note**: Individual's primary and secondary dominant \"bird\" traits, separated by a forward slash.\n\n## Example Outputs\n\n1. **Individual Radar Plot**\n\n- Plots one person’s scores around four axes (Eagle, Dove, Owl, Peacock).\n- The polygon edges connect each axis’s numeric value, visually representing personality strengths.\n\n\u003cimg src=\"https://media.githubusercontent.com/media/arapov/bird-plot/refs/heads/master/charts/Grace/radar_Grace.png\" width=\"555\"\u003e\n\n2. **Group/Team Distribution - Scatter Plot**\n\n- Displays multiple names on a quadrant chart.\n- Each quadrant corresponds to a “bird” style, with positions indicating how strongly each person aligns to one or more dimensions.\n\n\u003cimg src=\"https://media.githubusercontent.com/media/arapov/bird-plot/refs/heads/master/charts/scatter_all.png\" width=\"555\"\u003e\n\n3. **Comparison/Overlap Plot**\n\n- Overlays two radar plots for a side-by-side comparison.\n- Shows an “Overlap” percentage as a measure of similarity.\n\n\u003cimg src=\"https://media.githubusercontent.com/media/arapov/bird-plot/refs/heads/master/charts/Grace/compare/with_Henry.png\" width=\"555\"\u003e\n\n_(Note: The above images are illustrative examples.)_\n\n## License\n\nThis project is licensed under the [Apache 2.0 License](LICENSE). You are free to use, modify, and distribute this software in accordance with the license terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farapov%2Fbird-plot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farapov%2Fbird-plot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farapov%2Fbird-plot/lists"}