Referencia para ultralytics/utils/files.py
Nota
Este archivo está disponible en https://github.com/ultralytics/ ultralytics/blob/main/ ultralytics/utils/files .py. Si detectas algún problema, por favor, ayuda a solucionarlo contribuyendo con una Pull Request 🛠️. ¡Gracias 🙏!
ultralytics.utils.files.WorkingDirectory
Bases: ContextDecorator
Utilización: @DirectorioDeTrabajo(dir) decorador o 'con DirectorioDeTrabajo(dir):' gestor de contexto.
Código fuente en ultralytics/utils/files.py
__enter__()
__exit__(exc_type, exc_val, exc_tb)
__init__(new_dir)
ultralytics.utils.files.spaces_in_path(path)
Gestor de contexto para tratar las rutas con espacios en sus nombres. Si una ruta contiene espacios, los sustituye por guiones bajos, copia el archivo/directorio a la nueva ruta, ejecuta el bloque de código de contexto y, a continuación, copia el archivo/directorio a su ubicación original. archivo/directorio a su ubicación original.
Parámetros:
Nombre | Tipo | Descripción | Por defecto |
---|---|---|---|
path |
str | Path
|
El camino original. |
necesario |
Rendimiento:
Tipo | Descripción |
---|---|
Path
|
Ruta temporal con los espacios sustituidos por guiones bajos si había espacios, en caso contrario la ruta original. |
Ejemplo
Código fuente en ultralytics/utils/files.py
ultralytics.utils.files.increment_path(path, exist_ok=False, sep='', mkdir=False)
Incrementa una ruta de archivo o directorio, es decir, runs/exp --> runs/exp{sep}2, runs/exp{sep}3, ... etc.
Si la ruta existe y exist_ok no es Verdadero, se incrementará la ruta añadiendo un número y sep al al final de la ruta. Si la ruta es un archivo, se conservará la extensión del archivo. Si la ruta es un directorio, el número número se añadirá directamente al final de la ruta. Si el valor de mkdir es Verdadero, la ruta se creará como un directorio directorio si aún no existe.
Parámetros:
Nombre | Tipo | Descripción | Por defecto |
---|---|---|---|
path |
(str, Path)
|
Camino hacia el incremento. |
necesario |
exist_ok |
bool
|
Si es True, la ruta no se incrementará y se devolverá tal cual. Por defecto es Falso. |
False
|
sep |
str
|
Separador a utilizar entre la ruta y el número de incremento. Por defecto es ''. |
''
|
mkdir |
bool
|
Crea un directorio si no existe. Por defecto es Falso. |
False
|
Devuelve:
Tipo | Descripción |
---|---|
Path
|
Ruta incrementada. |
Código fuente en ultralytics/utils/files.py
ultralytics.utils.files.file_age(path=__file__)
Devuelve los días transcurridos desde la última actualización del archivo.
ultralytics.utils.files.file_date(path=__file__)
Devuelve una fecha de modificación del archivo legible por humanos, es decir, '2021-3-26'.
ultralytics.utils.files.file_size(path)
Devuelve el tamaño del archivo/directorio (MB).
Código fuente en ultralytics/utils/files.py
ultralytics.utils.files.get_latest_run(search_dir='.')
Devuelve la ruta al 'último.pt' más reciente en /ejecuta (es decir, a --reanudar desde).
Código fuente en ultralytics/utils/files.py
ultralytics.utils.files.update_models(model_names=('yolov8n.pt'), source_dir=Path('.'), update_names=False)
Actualiza y vuelve a guardar los modelos YOLO especificados en un subdirectorio 'modelos_actualizados'.
Parámetros:
Nombre | Tipo | Descripción | Por defecto |
---|---|---|---|
model_names |
tuple
|
Nombres de archivo del modelo a actualizar, por defecto ("yolov8n.pt"). |
('yolov8n.pt')
|
source_dir |
Path
|
Directorio que contiene los modelos y el subdirectorio de destino, por defecto es el directorio actual. |
Path('.')
|
update_names |
bool
|
Actualiza los nombres de los modelos a partir de un YAML de datos. |
False
|