debruijn-sequence-complexity-distribution

Software project on the distribution of de-Bruijn sequences of low complexity over over prime fields.

https://github.com/joannj35/debruijn-sequence-complexity-distribution

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.0%) to scientific vocabulary

Keywords

complexity-distribution de-bruijn-sequences
Last synced: 6 months ago · JSON representation ·

Repository

Software project on the distribution of de-Bruijn sequences of low complexity over over prime fields.

Basic Info
  • Host: GitHub
  • Owner: joannj35
  • License: apache-2.0
  • Language: C++
  • Default Branch: master
  • Homepage:
  • Size: 65.9 MB
Statistics
  • Stars: 1
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 1
Topics
complexity-distribution de-bruijn-sequences
Created over 2 years ago · Last pushed about 2 years ago
Metadata Files
Readme License Citation Codeowners

README.md

Complexity Distribution of de Bruijn Sequence Over Prime Fields

DOI License complexity71 tool

Overview

In this project we continue the study of the linear complexity of de Bruijn sequences over finite fields. Our aim is to establish the integer values of linear complexity for which there exist de Bruijn sequences of given span over finite fields. This repository includes the code developed for calculating these complexity distributions.

Research Domains

Our study is divided into two distinct research domains:

Binary Fields

This section examines de Bruijn sequences within binary fields (prime field 2), focusing on sequences with spans of 6 and 7. The computation of the complexities utilizes multithreading and OpenMP to efficiently handle complex calculations and data processing.

NOTE: Complexity 71 of span 7 is calculated in a different approach under the branch BinarySpan771

Non-Binary Fields

This section examines de Bruijn sequences within non-binary fields (prime fields 3,5,7), particularly focusing on sequences with span 2.

Additional Tools and Visualization

For a more enhanced user experience, we have developed a (humble) GUI tool, housed in a separate repository. This GUI effectively visualizes the result data, providing a more intuitive understanding of the complexity distributions. For access to the GUI and further instructions, please refer to GUI repository.

Citation

If you use this software or the data it produces in your work, please cite it using the following reference:

Etzion, T., Jozen, J., & Dally, R. (2024). debruijn-sequence-complexity-distribution (Version 1.0.0) [Computer software]. https://doi.org/10.5281/zenodo.10685239

Using the Code

Each branch of this repository contains specific instructions and scripts for the respective domain. To simplify running the code, we have introduced a Command Line Interface (CLI) which prompts the user for necessary inputs, streamlining the execution process.

Binary Field Domain Feature

In the binary field domain ONLY, users have the exclusive capability to pause and unpause complexity calculation at command. If the code is paused and later unpaused, it will resume from the exact point where it was halted, thereby conserving valuable computation time and resources.

Contributing

Contributions to this project are highly appreciated. If you have suggestions or improvements, please review the LICENSE file , then fork the appropriate branch of the repository, make your changes, and submit a pull request.

Acknowledgments

Special acknowledgment to Tuvi Etzion, professor of computer science at Technion – Israel Institute of Technology, for his invaluable advice and support throughout this project. His expertise significantly contributed to the successful completion of this work

LICENSE

This project is licensed under Apache License 2.0. For more information, see the LICENSE file in this repository.

Owner

  • Name: Joan Jozen
  • Login: joannj35
  • Kind: user

Computer Engineering student

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software or the data it produces in your work, please cite it using the following metadata"
authors:
- family-names: "Etzion"
  given-names: "Tuvi"
  orcid: "https://orcid.org/0000-0002-4315-4400"
- family-names: "Jozen"
  given-names: "Joan"
  orcid: " https://orcid.org/0009-0001-3292-0587"
- family-names: "Dally"
  given-names: "Razan"
  orcid: "https://orcid.org/0009-0003-3466-2643"
title: "debruijn-sequence-complexity-distribution"
version: 1.0.0
doi: 10.5281/zenodo.10685239
date-released: 2024-02-20
url: "https://doi.org/10.5281/zenodo.10685239"

GitHub Events

Total
Last Year

Dependencies

.github/workflows/block_merge.yml actions