Create README.md
This commit is contained in:
parent
4372ca8f4a
commit
e1a06f823d
|
@ -0,0 +1,62 @@
|
||||||
|
# BSSolver
|
||||||
|
|
||||||
|
BSSolver (Bottler Sat Solver) es un sistema que resuelve múltiples fórmulas proposicionales en CNF
|
||||||
|
de forma distribuida.
|
||||||
|
|
||||||
|
|
||||||
|
## Requisitos
|
||||||
|
|
||||||
|
Debe instalar minisat. Este se encuentra disponible en el repositorio de la vasta mayoría de distribuciones de Linux/macOS.
|
||||||
|
|
||||||
|
Debian/Ubuntu: `apt install minisat`\
|
||||||
|
macOS (con [homebrew](https://brew.sh/)): `brew install minisat`
|
||||||
|
|
||||||
|
Si tiene otra distribución consulte cómo hacerlo.
|
||||||
|
|
||||||
|
## Compilación
|
||||||
|
|
||||||
|
Para compilar todos los archivos se debe hacer:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make all
|
||||||
|
```
|
||||||
|
|
||||||
|
## Ejecución
|
||||||
|
|
||||||
|
Ahora, tendrá dos ejecutables: `view` y `solve`.
|
||||||
|
|
||||||
|
Para ejecutar el programa que se encarga de resolver usted debe pasarle los archivos CNF como parámetros.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./solve $(CNF_FILES)
|
||||||
|
```
|
||||||
|
Este enviará por salida estándar la cantidad de archivos a resolver y su PID, los cuales son necesarios para el programa `view`. Por lo tanto, usted tiene dos posibles modos de uso del sistema:
|
||||||
|
|
||||||
|
1) Enviar el output de solve directamente a view (con el uso de pipes):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./solve $(CNF_FILES) | ./view
|
||||||
|
```
|
||||||
|
|
||||||
|
2) Correr primero `solve` y luego en otra terminal (o en la misma si se corrió en background) ejecutar `view` pasándole como argumentos la cantidad de archivos y el PID.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./solve $(CNF_FILES)
|
||||||
|
```
|
||||||
|
```bash
|
||||||
|
./view $(TOTAL_FILES) $(PID)
|
||||||
|
```
|
||||||
|
Debe notar que dispondrá de 5 segundos para correr el programa `view`.
|
||||||
|
|
||||||
|
## Test
|
||||||
|
|
||||||
|
En orden de realizar los testeos usted debe tener instalado [valgrind](https://valgrind.org/), [cppcheck](http://cppcheck.net/) y [pvs-studio](https://pvs-studio.com/). Luego, puede correr los testeos con:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make test
|
||||||
|
```
|
||||||
|
|
||||||
|
# Autores
|
||||||
|
- Barmasch, Juan Martín (61033)
|
||||||
|
- Bellver, Ezequiel (61268)
|
||||||
|
- Lo Coco, Santiago (61301)
|
Loading…
Reference in New Issue