csv_to_wfdb docstring has incorrect parameter descriptions

Cerrado Apto para principiantes
#594 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Ya se ha fusionado un pull request relacionado.

  • #600 de @TheNetherWatcher — fusionado

Evaluación

Dificultad
1/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
83/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
python

Línea de trabajo

Busca el docstring de csv_to_wfdb en src/wfdb/io/convert/csv.py y compara las descripciones de sus parámetros con los argumentos y el comportamiento de la función. Comprueba los nombres de señal predeterminados indicados cerca de la línea 323. Corrige las descripciones incorrectas y confirma que el texto describe con precisión los argumentos, incluido que fs es obligatorio y file_name es la ruta del CSV.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Found while reviewing #591, which fixes the summary, record_only, write_dir and return value descriptions. Some other parameter descriptions in the csv_to_wfdb docstring are wrong, mostly because they were copied from elsewhere:

  • file_name is copied from rdrecord. It says the name is given "without any file extensions" and refers to pn_dir, which csv_to_wfdb doesn't have. It should be the path to the CSV file.
  • fs says "if it is missing, a value of 250 is assumed", but it is a required argument.
  • Several other descriptions (e.g. baseline, skew, byte_offset, checksum) are copied from the header file specification and describe header syntax rather than the Python arguments.
  • header says the default signal names are [ch_1, ch_2, ...], but the code produces ch_0, ch_1, ... (https://github.com/MIT-LCP/wfdb-python/blob/b8914e1c9c777c45571c894cb7b6579550a86f13/src/wfdb/io/convert/csv.py#L323).
Lenguaje dominante
Jupyter Notebook
Estrellas
856
Forks
326
Merge medio
1 d 12 h
PR fusionados (30 d)
36

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de MIT-LCP/wfdb-python

Todos los issues de MIT-LCP/wfdb-python

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.