mediatechlab/datasetbuilder repository overview

⁠Projeto

Dataset Builder

⁠Descrição

Serviço utilizado para gerar um dataset de imagens únicas a partir de vídeos.

⁠Pré-requisitos

1. Ubuntu 18.04
2. Memória 2Gb
3. Armazenamento 2Gb

⁠Instalação

1. Faça o download da imagem através do comando:

   • docker pull mediatechlab/datasetbuilder

2. Verifique o ID da imagem através do comando: 
   

   Copy
   • docker images

3. Então crie o container para a geração de datasets a partir da imagem baixada:

   • docker run -it -v {path_local_onde_estara_o_video}:{path_onde_o_volume_sera_montado_no_docker} -p {porta_exposta_para_fora_do_container}:8888 {id_da_imagem}

   OBS: A imagem docker foi criada com a pasta /mnt/storage, onde pode ser montado o volume!

⁠Execução

1. Ao inicializar o container com o comando anterior, o serviço será iniciado automaticamente na porta 8888.

   Running on http://0.0.0.0:8888/⁠ (Press CTRL+C to quit)

   OBS: Caso saia do container e deseje retornar, execute os comandos:

   1.1. **docker start <id_do_container>** // Caso esteja parado 
   
   1.2. **sudo docker exec -it <id_do_container> /bin/bash** // Para entrar no container em execução
   

   Copy

⁠API Endpoints

1. /api/v1/dataset

   Metódo: POST

   Ao fazer uma requisição passando um dos playloads abaixo, o serviço inicializará o job para construção do dataset.

   OBS1: Os formatos de vídeo aceitos são: mxf, avi, mp4, mov.

   OBS2: Ao final do processamento, todos os arquivos da pasta de saída especificada são apagados!!!

   Payload 1: Utilizado para criar o dataset a partir de um vídeo local.

    {
        "path_in": "/home/user/storage", **required** 
            # Path onde se encontra o vídeo a ser processado. (Se estiver executando com o docker, passe o path do docker onde o volume foi montado, como mostrado anteriormente)
        "path_out": "/home/user/storage/out", **required** 
            # Path onde será gerado o resultado.
        "resize": [2] // Lista contendo INTs e/ou FLOATs que representem os redimensionamentos que serão feitos nas imagens. Se não for passado o parâmetro, o serviço só retornará o conjunto de imagens previamente processado.
    }
   
    **Retorno: 200**
   
        {
            "message": "Processo Inicializado!"
        }
   
        **OBS: Todos os vídeos presentes na pasta passarão pelo processo de geração do dataset de imagens.**
    
   

   Copy

   Payload 2: Utilizado para criar o dataset a partir de um vídeo hospedado.

    {
        "url": "http://url_to_video/file.mp4",  
            # URL para download do vídeo.
        "path_in": "/home/user/storage", **required** 
            # Path onde será feito o download do vídeo. (Se estiver executando com o docker, passe o path do docker onde o volume foi montado, como mostrado anteriormente)
        "path_out": "/home/user/storage/out", **required** 
            # Path onde será gerado o resultado.
        "resize": [2] // Lista contendo INTs e/ou FLOATs que representem os redimensionamentos que serão feitos nas imagens. Se não for passado o parâmetro, o serviço só retornará o conjunto de imagens previamente processado.
    }
   
    **Retorno:  200**
   
        {
            "message": "Processo Inicializado!"
        }
   

   Copy