parshift

Python package based on Gibson's framework (2003) for turn-taking in group conversation analysis.

https://github.com/bdfsaraiva/parshift

Science Score: 57.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (17.3%) to scientific vocabulary

Keywords

conversation-analysis participation-shifts python turn-taking
Last synced: 6 months ago · JSON representation ·

Repository

Python package based on Gibson's framework (2003) for turn-taking in group conversation analysis.

Basic Info
Statistics
  • Stars: 4
  • Watchers: 3
  • Forks: 3
  • Open Issues: 0
  • Releases: 6
Topics
conversation-analysis participation-shifts python turn-taking
Created over 3 years ago · Last pushed 6 months ago
Metadata Files
Readme License Citation

README.md

Tests Codecov Docs License: MIT PyPI Code style: black

ParShift

ParShift is a python package based on Gibson's framework for the analysis of conversational sequences.

The framework is established on the concept of participation shift, which refers to the shifting of individuals between the positions of speaker, target (addressee), and non-addressee (everyone else), in a group conversation.

Installation

From PyPI

bash pip install parshift

From source

Directly using pip:

bash pip install git+https://github.com/bdfsaraiva/parshift.git#egg=parshift

Or each step at a time:

bash git clone https://github.com/bdfsaraiva/parshift cd parshift pip install .

Getting Started

For an in-depth overview of the features of ParShift please check the documentation or follow along the provided example:

| Name | Link | |---|---| | Participation Shifts with ParShift | Open In Colab |

Features/Improvements

We're open to any idea or suggestion to further improve this package. If you have an idea or a feature request, just open an issue.

For developers

After you cloned the repo head into the parshift base directory, cd into it, create a virtual environment and then install ParShift in development mode:

bash pip install -e .[dev]

Make sure that all tests pass and that there aren't any issues:

bash pytest

Now you are ready to start developing the project! Don't forget to add tests for every new change or feature!

Reference

If you use this software, please cite the following reference:

  • Ferreira-Saraiva, B.D., Matos-Carvalho, J.P., Fachada, N. & Pita, M. (2023). ParShift: a Python package to study order and differentiation in group conversations. SoftwareX, 24. 101554. https://doi.org/10.1016/j.softx.2023.101554

License

MIT License

Owner

  • Name: Bruno Saraiva
  • Login: bdfsaraiva
  • Kind: user
  • Location: Lisbon, Portugal
  • Company: Lusófona University

Assistant Lecturer | PhD candidate Complex Networks, Data Analysis

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: parshift
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Bruno
    family-names: Ferreira-Saraiva
    email: bruno.saraiva@ulusofona.pt
    affiliation: 'Lusófona University, COPELABS'
    orcid: 'https://orcid.org/0000-0001-8839-7222'
  - given-names: João P.
    family-names: Matos-Carvalho
    email: joao.matos.carvalho@ulusofona.pt
    affiliation: 'Lusófona University, COPELABS'
    orcid: 'https://orcid.org/0000-0001-9409-7736'
  - given-names: Nuno
    family-names: Fachada
    email: nuno.fachada@ulusofona.pt
    affiliation: 'Lusófona University, COPELABS'
    orcid: 'https://orcid.org/0000-0002-8487-5837'
  - given-names: Manuel
    family-names: Pita
    email: manuel.pita@ulusofona.pt
    affiliation: 'Lusófona University, CICANT'
    orcid: 'https://orcid.org/0000-0003-2180-6823'
repository-code: 'https://github.com/bdfsaraiva/parshift'
abstract: >-
  Python package based on Gibson's framework (2003) for turn-taking in group
  conversation analysis.
keywords:
  - small groups
  - social interaction
  - participation shifts
  - interpersonal coordination
  - turn-taking
  - emergent social behaviour
license: MIT
preferred-citation:
  type: article
  authors:
    - given-names: Bruno
      family-names: Ferreira-Saraiva
      email: bruno.saraiva@ulusofona.pt
      affiliation: 'Lusófona University, COPELABS'
      orcid: 'https://orcid.org/0000-0001-8839-7222'
    - given-names: João P.
      family-names: Matos-Carvalho
      email: joao.matos.carvalho@ulusofona.pt
      affiliation: 'Lusófona University, COPELABS'
      orcid: 'https://orcid.org/0000-0001-9409-7736'
    - given-names: Nuno
      family-names: Fachada
      email: nuno.fachada@ulusofona.pt
      affiliation: 'Lusófona University, COPELABS'
      orcid: 'https://orcid.org/0000-0002-8487-5837'
    - given-names: Manuel
      family-names: Pita
      email: manuel.pita@ulusofona.pt
      affiliation: 'Lusófona University, CICANT'
      orcid: 'https://orcid.org/0000-0003-2180-6823'
  title: >-
    ParShift: a Python package to study order and differentiation in
    group conversations
  journal: SoftwareX
  doi: 10.1016/j.softx.2023.101554
  volume: 24
  start: 101554
  month: 12
  year: 2023
  url: 'https://doi.org/10.1016/j.softx.2023.101554'
  publisher:
    name: Elsevier

GitHub Events

Total
  • Release event: 1
  • Watch event: 1
  • Issue comment event: 1
  • Push event: 1
  • Create event: 1
Last Year
  • Release event: 1
  • Watch event: 1
  • Issue comment event: 1
  • Push event: 1
  • Create event: 1

Committers

Last synced: almost 3 years ago

All Time
  • Total Commits: 170
  • Total Committers: 5
  • Avg Commits per committer: 34.0
  • Development Distribution Score (DDS): 0.535
Top Committers
Name Email Commits
Bruno Saraiva b****a@h****m 79
Bruno Saraiva 4****a@u****m 57
Nuno Fachada n****a@u****t 28
Nuno Fachada f****n@f****m 4
jmcarvalho j****o@p****m 2
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 0
  • Total pull requests: 17
  • Average time to close issues: N/A
  • Average time to close pull requests: 2 days
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.71
  • Merged pull requests: 17
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: about 2 hours
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
  • nunofachada (15)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 19 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 5
  • Total maintainers: 1
pypi.org: parshift

Python package based on Gibson's framework (2003) for turn-taking in group conversation analysis.

  • Versions: 5
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 19 Last month
Rankings
Dependent packages count: 6.6%
Average: 25.0%
Forks count: 30.5%
Dependent repos count: 30.6%
Stargazers count: 32.3%
Maintainers (1)
Last synced: 6 months ago

Dependencies

.github/workflows/cov.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • codecov/codecov-action v3 composite
.github/workflows/docs.yml actions
  • JamesIves/github-pages-deploy-action v4 composite
  • actions/checkout v3 composite
.github/workflows/publish.yml actions
  • actions/checkout v3 composite
  • pypa/gh-action-pypi-publish release/v1 composite
.github/workflows/tests.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
pyproject.toml pypi
  • matplotlib *
  • pandas *
  • squarify *