AUTIS
library allows parsing combinatorial problem instances for different common formats.
Currently, the following are supported:
- Dimacs CNF
- OPB
- XCSP3 based on the XCSP3-CPP-PARSER
AUTIS
can feed any solver implementing the Universe interface.
The latest release is available here
AUTIS
is developed using C++ 17,
CMake 3.23.
Installing CMake is required if you want to build from source.
To do so, after having installed all the needed tools, you will need to clone
the project:
git clone https://github.com/crillab/autis.git --recursive
cd autis
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=RELEASE
cmake --build .
This library is designed for simplified use in projects using CMake. To use this project, it is possible to create a sub-module in your project with the following commands:
git submodule add https://github.com/crillab/autis libs/autis
git submodule update --remote --recursive --init
And then add the following instructions in your CMakeLists.txt file:
add_subdirectory(libs/autis)
add_executable(your_solver solver.h solver.cpp)
target_link_libraries(your_solver autis)
For each of these examples, we consider that you have your own implementation of the ISolverFactory
interface
from the Universe library.
The paths to the .h files must be adapted.
If you want to parse a CNF file like this one, you may use something similar to the following example.
#include <string>
#include <iostream>
#include "../libs/universe/universe/include/utils/ISolverFactory.hpp"
#include "../autis/core/parser.h"
int main(){
std::string path ="examples/example.cnf";
Universe::ISolverFactory* factory= new YourFactoryImplementation();
auto solver = Autis::parse(path,*factory);
auto result = solver->solve();
auto solution = solver->solution();
switch(result){
case Universe::UniverseSolverResult::SATISFIABLE:
auto solution = solver->solution();
std::cout<<"SATISFIABLE"<<std::endl;
break;
case Universe::UniverseSolverResult::UNSATISFIABLE:
std::cout<<"UNSATISFIABLE"<<std::endl;
break;
case Universe::UniverseSolverResult::UNKNOWN:
std::cout<<"UNKNOWN"<<std::endl;
break;
case Universe::UniverseSolverResult::UNSUPPORTED:
std::cout<<"UNSUPPORTED"<<std::endl;
break;
}
return 0;
}
If you want to parse an OPB file like this one, you may use something similar to the following example.
#include <string>
#include <iostream>
#include "../libs/universe/universe/include/utils/ISolverFactory.hpp"
#include "../autis/core/parser.h"
int main(){
std::string path ="examples/example.opb";
Universe::ISolverFactory* factory= new YourFactoryImplementation();
auto solver = Autis::parse(path,*factory);
auto result = solver->solve();
auto solution = solver->solution();
switch(result){
case Universe::UniverseSolverResult::SATISFIABLE:
auto solution = solver->solution();
std::cout<<"SATISFIABLE"<<std::endl;
break;
case Universe::UniverseSolverResult::UNSATISFIABLE:
std::cout<<"UNSATISFIABLE"<<std::endl;
break;
case Universe::UniverseSolverResult::UNKNOWN:
std::cout<<"UNKNOWN"<<std::endl;
break;
case Universe::UniverseSolverResult::UNSUPPORTED:
std::cout<<"UNSUPPORTED"<<std::endl;
break;
case Universe::UniverseSolverResult::OPTIMUM_FOUND:
auto solution = solver->solution();
std::cout<<"OPTIMUM_FOUND"<<std::endl;
break;
}
return 0;
}
If you want to parse an XCSP3 file like this one, you may use something similar to the following example.
#include <string>
#include <iostream>
#include "../libs/universe/universe/include/utils/ISolverFactory.hpp"
#include "../autis/core/parser.h"
int main(){
std::string path ="examples/example.xml";
Universe::ISolverFactory* factory= new YourFactoryImplementation();
auto solver = Autis::parse(path,*factory);
auto result = solver->solve();
switch(result){
case Universe::UniverseSolverResult::SATISFIABLE:
auto solution = solver->solution();
std::cout<<"SATISFIABLE"<<std::endl;
break;
case Universe::UniverseSolverResult::UNSATISFIABLE:
std::cout<<"UNSATISFIABLE"<<std::endl;
break;
case Universe::UniverseSolverResult::UNKNOWN:
std::cout<<"UNKNOWN"<<std::endl;
break;
case Universe::UniverseSolverResult::UNSUPPORTED:
std::cout<<"UNSUPPORTED"<<std::endl;
break;
case Universe::UniverseSolverResult::OPTIMUM_FOUND:
auto solution = solver->solution();
std::cout<<"OPTIMUM_FOUND"<<std::endl;
break;
}
return 0;
}