Skip to main content

kpdvdb: KayPENTAX Disordered Voice Database Reader

PyPI PyPI - Status PyPI - Python Version GitHub

This Python module provides functions to interact with KayPENTAX Disordered Voice Database

This module DOES NOT provide the database itself. KayPENTAX Disordered Voice Database is a (discontinued) commercial product, an addon option to KayPENTAX’s Computerized Speech Lab (CSL).

For faster access to the data, copying the database files from the CD-ROM to a local hard drive is highly recommended.

Install

pip install kpdvdb

Use

from kpdvdb import KPDVDB

# to initialize (must call this once in every Python session)
kpdvdb = KPDVDB('<path to CDROM drive or root directory of the database>')

# to list all the data fields
print(kpdvdb.get_fields())

# to list categorical fields' unique values
print(kpdvdb.get_sexes()) # genders
print(kpdvdb.get_locations()) # pathology sites
print(kpdvdb.get_natlangs()) # native languages
print(kpdvdb.get_origins()) # races
print(kpdvdb.get_diagnoses()) # diagnoses

# to get a copy of the full database
df = kpdvdb.query(include_diagnoses=True)

# to get age, gender, diagnoses, and MDVP measures of non-smoking
# subjects with polyp or paralysis, F0 between 100 and 300 Hz
df = kpdvdb.query(["AGE","SEX","DIAGNOSES","MDVP"],
                  DIAGNOSES=["vocal fold polyp","paralysis"],
                  Fo=[100,300],
                  SMOKE=False)

# to get the list of AH NSP files of normal subjects
nspfiles = kpdvdb.get_files('ah',NORM=True)

# to iterate over 'rainbow passage' acoustic data of female pathological subjects
for fs, x, info in kpdvdb.iter_data('rainbow',
                                    auxdata_fields=["AGE","SEX"],
                                    NORM=False, SEX="F"):
  # run the acoustic data through your analysis function, get measurements
  params = my_analysis_function(fs, x)

  # log the measurements along with the age and gender info
  my_logger.log_outcome(*info, *params)

NOTE

Because the database is not public, this module cannot be tested for various platforms via GitHub Action. If you encounter any issues, please post it on GitHub.

Metadata

Release files for kpdvdb 0.6.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kpdvdb 0.6.3
File Size Uploaded Provenance Actions
kpdvdb-0.6.3.tar.gz 15.6 kB Without provenance Details for kpdvdb-0.6.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for kpdvdb 0.6.3
File Interpreter ABI Platform Actions
kpdvdb-0.6.3-py3-none-any.whl Python 3 none any Details for kpdvdb-0.6.3-py3-none-any.whl

Total release size: 29.9 kB

Release files / kpdvdb-0.6.3.tar.gz

Download URL kpdvdb-0.6.3.tar.gz
Size 15.6 kB
Tags Source
SHA-256 checksum
How to use checksums
54bdb97a94c3ff1ecc8089f720d54020695c976ea73c0644c2e09395f9121bc2
BLAKE2b-256 checksum
How to use checksums
22d4adcd831ec5c10ca4a67498a109bca4be74dff39b6d6e2846b5505640aeeb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.9.22

Release files / kpdvdb-0.6.3-py3-none-any.whl

Download URL kpdvdb-0.6.3-py3-none-any.whl
Size 14.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
58d5ff609df0497f597d18d1986a732816f72791b5e63478f6fa90b271285f36
BLAKE2b-256 checksum
How to use checksums
b33c4a1086db00b4eef7460411a8783c466c16cf33b79aadc546ea128d9ded35
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.9.22

Security for kpdvdb 0.6.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page