Geração de pares questão-sparql
Project description
O módulo QApedia
foi desenvolvido em python e realiza a geração de pares de
questões-sparql com base em um template previamente estabelecido. Para saber
mais sobre o funcionamento do pacote, você pode ler sobre ele na documentação.
⚙️ Instalando
Caso deseje, você pode realizar a instalação do módulo do QApedia
,
primeiramente, dentro da pasta do projeto, você pode executar o
pip install .
.
foo@bar:~/QApedia$ pip install .
O Download do projeto se encontra disponível na aba release do repositório atual nos formatos tar.gz e zip.
📚 Documentação
A documentação do QApedia
se encontra disponível em qapedia.rtfd.io.
Esse pacote contempla as seguintes operações:
- Permite a busca de uma consulta SPARQL em um endpoint especificado.
- Realiza a geração de pares de questões-sparql sobre a dbpedia a partir de um template previamente estabelecido.
📝 Exemplo inicial
Após ter instalado o QApedia, é possível executar um exemplo disponível no pacote para a geração de pares questão-sparql. No console abaixo, é definido uma quantidade máxima de dez pares por template e esse conjunto gerado é salvo no arquivo chamado "pares.csv".
foo@bar:~$ qapedia -n 10 -v True -o pares.csv
Executando template da linha 0
Executando template da linha 1
Executando template da linha 2
Executando template da linha 3
Executando template da linha 4
foo@bar:~$
Para verificar as opções disponíveis no comando qapedia
, apenas coloque -h
ou --help
como argumento. Caso deseje criar um conjunto de pares para um arquivo específico, informe o caminho do arquivo contendo o conjunto de templates.
foo@bar:~$ qapedia -tfile templates.csv -n 10 -v True -o pares.csv
Você pode encontrar alguns exemplos de uso do QApedia nesse link.
🚧 Informações importantes
-
Os pares gerados podem apresentar problemas de concordância.
- Por exemplo, em <Fulana foi autor de que?>, há o problema com o feminino, para resolver isso defina uma pergunta no feminino (autora) e filtre a busca pelo gênero.
-
Consultas com problemas na estrutura, por exemplo, falta de "?" antes da variável retornarão a exceção
"QueryBadFormed"
. -
Consultas que demandam um longo tempo de resposta no servidor serão automaticamente abortadas e uma exceção será capturada.
-
A generator_query possui o formato SELECT ... WHERE, caso não esteja nesse formato, uma exceção é gerada informando que a consulta não é do tipo SELECT.
- Não importa o que se encontra dentro do WHERE, contanto que esteja num formato válido.
- As variáveis do tipo ?a ?b ?c .. ?y ?z são utilizadas no preenchimento das lacunas do par "questão-sparql", sendo elas equivalentes as campos <A> <B> <C> ... <Y> <Z> presente nesses pares.
📏 Testes
Os testes do pacote foram construídos utilizando o pytest e é possível verificá-los executando os seguintes comandos dentro da pasta do QApedia.
foo@bar:~/QApedia$ pip install pytest
foo@bar:~/QApedia$ pytest
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for QA_pedia-0.0.0a0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fe06cd4bd94b611596088b0c579d26db2d65dcc71ac6232d0ea3fb38e8f82c0a |
|
MD5 | fd7a5468f696df5f21d9104fb9539fd1 |
|
BLAKE2b-256 | cc63fb87b35d8904055e5b6bffcc3bbf9163024926fdfc1b4db36638742f9f63 |