Skip to main content

Python version of the DIGNEA code for instance generation

Project description

DIGNEApy


Diverse Instance Generator with Novelty Search and Evolutionary Algorithms

Test Coverage Status License: GPL v3

Repository containing the Python version of DIGNEA, a Diverse Instance Generator with Novelty Search and Evolutionary Algorithms. This framework is an extensible tool for generating diverse and discriminatory instances for any desired domain. The instances obtained generated will be biased to the performance of a target in a specified portfolio of algorithms.

Dependencies

  • Numpy
  • Sklearn
  • Pandas
  • Keras
  • DEAP
  • PyTorch
  • Pybind11
  • Seaborn
  • Matplotlib

Publications

DIGNEA was used in the following publications:

  • Alejandro Marrero, Eduardo Segredo, and Coromoto Leon. 2021. A parallel genetic algorithm to speed up the resolution of the algorithm selection problem. Proceedings of the Genetic and Evolutionary Computation Conference Companion. Association for Computing Machinery, New York, NY, USA, 1978–1981. DOI:https://doi.org/10.1145/3449726.3463160

  • Marrero, A., Segredo, E., León, C., Hart, E. 2022. A Novelty-Search Approach to Filling an Instance-Space with Diverse and Discriminatory Instances for the Knapsack Problem. In: Rudolph, G., Kononova, A.V., Aguirre, H., Kerschke, P., Ochoa, G., Tušar, T. (eds) Parallel Problem Solving from Nature – PPSN XVII. PPSN 2022. Lecture Notes in Computer Science, vol 13398. Springer, Cham. https://doi.org/10.1007/978-3-031-14714-2_16

  • Alejandro Marrero, Eduardo Segredo, Emma Hart, Jakob Bossek, and Aneta Neumann. 2023. Generating diverse and discriminatory knapsack instances by searching for novelty in variable dimensions of feature-space. In Proceedings of the Genetic and Evolutionary Computation Conference (GECCO '23). Association for Computing Machinery, New York, NY, USA, 312–320. https://doi.org/10.1145/3583131.3590504

  • Marrero, A., Segredo, E., León, C., & Hart, E. 2024. Learning Descriptors for Novelty-Search Based Instance Generation via Meta-evolution. In Genetic and Evolutionary Computation Conference (GECCO ’24), July 14–18, 2024, Melbourne, VIC, Australia. https://doi.org/10.1145/3638529.3654028

  • Alejandro Marrero, Eduardo Segredo, Coromoto León, Emma Hart; Synthesising Diverse and Discriminatory Sets of Instances using Novelty Search in Combinatorial Domains. Evolutionary Computation 2024; doi: https://doi.org/10.1162/evco_a_00350

  • Marrero, A. 2024. Evolutionary Computation Methods for Instance Generation in Optimisation Domains. PhD thesis. Universidad de La Laguna. https://riull.ull.es/xmlui/handle/915/37726

How to cite DIGNEA

If you use DIGNEA in your research work, remember to cite:

@article{dignea_23, title = {DIGNEA: A tool to generate diverse and discriminatory instance suites for optimisation domains}, journal = {SoftwareX}, volume = {22}, pages = {101355}, year = {2023}, issn = {2352-7110}, doi = {https://doi.org/10.1016/j.softx.2023.101355}, url = {https://www.sciencedirect.com/science/article/pii/S2352711023000511}, author = {Alejandro Marrero and Eduardo Segredo and Coromoto León and Emma Hart}, keywords = {Instance generation, Novelty search, Evolutionary algorithm, Optimisation, Knapsack problem}, abstract = {To advance research in the development of optimisation algorithms, it is crucial to have access to large test-beds of diverse and discriminatory instances from a domain that can highlight strengths and weaknesses of different algorithms. The DIGNEA tool enables diverse instance suites to be generated for any domain, that are also discriminatory with respect to a set of solvers of the user choice. Written in C++, and delivered as a repository and as a Docker image, its modular and template-based design enables it to be easily adapted to multiple domains and types of solvers with minimal effort. This paper exemplifies how to generate instances for the Knapsack Problem domain.} }

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

digneapy-0.2.5.tar.gz (13.5 MB view details)

Uploaded Source

Built Distributions

digneapy-0.2.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (10.9 MB view details)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64

digneapy-0.2.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (10.9 MB view details)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

digneapy-0.2.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (10.9 MB view details)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

File details

Details for the file digneapy-0.2.5.tar.gz.

File metadata

  • Download URL: digneapy-0.2.5.tar.gz
  • Upload date:
  • Size: 13.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for digneapy-0.2.5.tar.gz
Algorithm Hash digest
SHA256 eef083fc0f7cea97cfa203378f8e5026af83415016b5979f33e6fefba3c35ed6
MD5 dac2b8cf826cde4ccdc95ada6ee8f5f0
BLAKE2b-256 9a57a0b171a38ffa048de8937257b4ac4c54e87335ebb4a940b3c530508c0a4d

See more details on using hashes here.

File details

Details for the file digneapy-0.2.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for digneapy-0.2.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 3d733cc1e9c48f68c1ecbb30337e2b4b29559c0be0c38863556091caa3ba752c
MD5 ea6a3a83ad0459db4f4714f2eded171f
BLAKE2b-256 3c36c4a7591b982f63fcc1d7c43e0dca4af67e4a772854e3807ec83ff4b620ee

See more details on using hashes here.

File details

Details for the file digneapy-0.2.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for digneapy-0.2.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 6d00a2a2c6c322e92610bd58f6e584a985c01f47bc2ad031db43ddaf1058ff4c
MD5 5cf590206b5f01d92a12398d5bc3e225
BLAKE2b-256 66868d8884a674af447fde1f19a49f5f635155b9b1ce53d405bdfee052539305

See more details on using hashes here.

File details

Details for the file digneapy-0.2.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for digneapy-0.2.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 eef7d7bd3318af0baf5cbddf1aeadcc8925be72231940f8f044763e5e4acc7fb
MD5 a64a8a9969139ba8d6ca3fadb8980f1d
BLAKE2b-256 d1da7a229682b1a02ea45f3fec8f2b9dd73402a1b66a6a8e1522dc88f58aaaa1

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page