{"id":48791194,"url":"https://github.com/cdcgov/sswsort","last_synced_at":"2026-04-13T20:01:22.348Z","repository":{"id":351127994,"uuid":"1192981066","full_name":"CDCgov/sswsort","owner":"CDCgov","description":"A simple tool for classifying gene segments","archived":false,"fork":false,"pushed_at":"2026-04-13T18:04:19.000Z","size":725,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-13T20:00:16.059Z","etag":null,"topics":["bioinformatics","cdc-influenza-division","ncird","ncird-id"],"latest_commit_sha":null,"homepage":"https://cdcgov.github.io/sswsort","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CDCgov.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.bib","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-26T18:51:58.000Z","updated_at":"2026-04-13T17:54:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/CDCgov/sswsort","commit_stats":null,"previous_names":["cdcgov/sswsort"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/CDCgov/sswsort","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CDCgov%2Fsswsort","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CDCgov%2Fsswsort/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CDCgov%2Fsswsort/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CDCgov%2Fsswsort/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CDCgov","download_url":"https://codeload.github.com/CDCgov/sswsort/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CDCgov%2Fsswsort/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31768649,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T15:25:13.801Z","status":"ssl_error","status_checked_at":"2026-04-13T15:25:09.162Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bioinformatics","cdc-influenza-division","ncird","ncird-id"],"created_at":"2026-04-13T20:00:27.165Z","updated_at":"2026-04-13T20:01:22.342Z","avatar_url":"https://github.com/CDCgov.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SSWSort 2 - simple virus gene segment / genome classification via striped Smith-Waterman\n\nSSWSort 2 is provided as both a Rust library, which can be used as a dependency\nin other projects, and as an executable binary, which can be run via\ncommand-line and replaces SSWSORT. The following documentation discusses usage\nand outputs for the binary, `sswsort`. For information on the library, read\nthe [Rust docs].\n\nClassifies (or sorts) sequences (influenza, SARS-CoV-2, RSV) using presets or\nDBs and a query sequence (FASTA). The classification is a best match criterion,\nand ignores same-strand repeats. SSWSORT will reject sequences that are\nunexpectedly long, chimeric (optional), and beyond the scoring thresholds.\n\n## Usage\n\n```bash\nUses striped Smith-Waterman to classify sequences into a simple compound type\n\nUsage: sswsort [OPTIONS] \u003cMODULE\u003e \u003cFASTA_FILE\u003e [OUTPUT_FILE]\n\nArguments:\n  \u003cMODULE\u003e       Name of the classification module\n  \u003cFASTA_FILE\u003e   Name of the nucleotide sequences to classify in FASTA format\n  [OUTPUT_FILE]  Name of the tab-separated-value file for classifier results. If none are provided, STDOUT is used. If a directory is specified, a default filename of `sswsort_output.tsv`\n\nOptions:\n  -T, --threads \u003cTHREADS\u003e       Number of threads to use. Defaults to number of physical cores otherwise\n  -G, --is-grid-task            Execute as a partitioned task in a grid job, for use with: --submit-grid-job\n  -S, --submit-grid-job \u003cSIZE\u003e  Submits and blocks on a grid job of the specified array size\n  -h, --help                    Print help (see more with '--help')\n  -V, --version                 Print version\n```\n\n### Self-tests\n\n```bash\n./sswsort flu sswsort_res/flu.fasta\n./sswsort cov-beta sswsort_res/cov-beta.fasta\n./sswsort rsv sswsort_res/rsv.fasta\n```\n\n## Installation\n\n### Compile from source\n\nClone this repo and, optionally, check out the latest release tag. You must\ninstall [Rust](https://rust-lang.org) *nightly* as a pre-requisite. You can then\nsimply run the installer script:\n\n```bash\n./install.sh\n```\n\n### Via Archive\n\n1. Download the latest archive via our [releases page](https://github.com/CDCgov/sswsort/releases)\n   for your target platform.\n2. Unzip the archive containing `sswsort`.\n3. Move the package to your desired location and add the folder to your `PATH`\n   - Note: `sswsort_res` and `sswsort` must be in the same folder.\n\n### Via Container\n\nSimply run:\n\n```bash\n## From Github Container Repo\ndocker run --rm -itv $(pwd):/data ghcr.io/cdcgov/sswsort:latest sswsort # more args\n```\n\n## Outputs\n\nSSWSORT will provide output in a tab-separated format, with columns representing:\n\nProgram version, Reference module, Query name, Primary classified taxon, Primary\nclassification score, Sequence length, Primary strand, Secondary classified\ntaxon, Secondary score, Secondary strand\n\nTo receive a classification, the query must align with one of the reference\nsequences with a score greater than or equal to the `score_minimum`, or a\nnormalized score greater than or equal to the `norm_score_minimum`, equal to the\nscore divided by the length of the query. These parameters have default values\nthat can be changed in the `config.toml`.\n\nClassifications fall into the following categories:\n\n| Classification                                    | Description                                                                                                                                                                                                                                         |\n| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| A single taxon                                    | The taxon with the highest score for the provided query                                                                                                                                                                                             |\n| `*Unusually Long` with a single taxon             | The query length is over twice the length of the reference it is matched to                                                                                                                                                                         |\n| `*Chimeric` with a `+`-separated list of taxa     | The query matches to multiple different reference taxa with scores above 800 each. Chimera detection can be disabled in `config.toml`                                                                                                               |\n| `*Unresolvable` with a `,`-separated list of taxa | The query matches to multiple reference taxa with exactly matching scores                                                                                                                                                                           |\n| `UNRECOGNIZABLE`                                  | The query did not match to any reference with a high enough score or normalized score to pass the threshold. Queries with `*Chimeric` or `*Unresolvable` primary classifications are also given `UNRECOGNIZABLE` for their secondary classification |\n\n## Alignment and Scoring\n\nSSWSORT utilizes a Striped Smith-Waterman alignment algorithm to align each\nquery sequence to a list of references before classifying the query with the reference taxa that had the highest alignment score. The alignment uses the following weights for scoring:\n\n| Parameter  | Weight |\n| ---------- | ------ |\n| Match      | 2      |\n| Mismatch   | -5     |\n| Gap open   | -10    |\n| Gap extend | -5     |\n\nAmbiguous nucleotides (`N`) and unrecognized characters are treated as 0-penalty mismatches.\nSo, a query with one or more `N` bases will align with an identical score as a\nquery with those bases missing.\n\nLeading and trailing `N`'s in a query sequence are removed prior to alignment.\nThis will not affect the alignment score, but will affect the sequence length in\nthe output, as well as the normalized score, which uses the edited length.\n\n## Notices\n\n### Contact Info\n\nFor direct correspondence on the project, feel free to contact: [Samuel S. Shepard](mailto:sshepard@cdc.gov), Centers for Disease Control and Prevention or reach out to other [contributors](CONTRIBUTORS.md).\n\n### Public Domain Standard Notice\n\nThis repository constitutes a work of the United States Government and is not subject to domestic copyright protection under 17 USC § 105. This repository is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/).  All contributions to this repository will be released under the CC0 dedication.  By submitting a pull request you are agreeing to comply with this waiver of copyright interest.\n\n### License Standard Notice\n\nThe repository utilizes code licensed under the terms of the Apache Software License and therefore is licensed under ASL v2 or later. This source code in this repository is free: you can redistribute it and/or modify it under the terms of the Apache Software License version 2, or (at your option) any later version. This source code in this repository is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Apache Software License for more details. You should have received a copy of the Apache Software License along with this program. If not, see: \u003chttp://www.apache.org/licenses/LICENSE-2.0.html\u003e. The source code forked from other open source projects will inherit its license.\n\n### Privacy Standard Notice\n\nThis repository contains only non-sensitive, publicly available data and information. All material and community participation is covered by the [Disclaimer](https://github.com/CDCgov/template/blob/main/DISCLAIMER.md). For more information about CDC's privacy policy, please visit \u003chttp://www.cdc.gov/other/privacy.html\u003e.\n\n### Contributing Standard Notice\n\nAnyone is encouraged to contribute to the repository by [forking](https://help.github.com/articles/fork-a-repo) and submitting a pull request. (If you are new to GitHub, you might start with a [basic tutorial](https://help.github.com/articles/set-up-git).) By contributing to this project, you grant a world-wide, royalty-free, perpetual, irrevocable, non-exclusive, transferable license to all users under the terms of the [Apache Software License v2](http://www.apache.org/licenses/LICENSE-2.0.html) or later.\n\nAll comments, messages, pull requests, and other submissions received through CDC including this GitHub page may be subject to applicable federal law, including but not limited to the Federal Records Act, and may be archived. Learn more at [http://www.cdc.gov/other/privacy.html](http://www.cdc.gov/other/privacy.html).\n\n### Records Management Standard Notice\n\nThis repository is not a source of government records, but is a copy to increase collaboration and collaborative potential. All government records will be published through the [CDC web site](http://www.cdc.gov).\n\n## Additional Standard Notices\n\nPlease refer to [CDC's Template Repository](https://github.com/CDCgov/template) for more information about [contributing to this repository](https://github.com/CDCgov/template/blob/main/CONTRIBUTING.md), [public domain notices and disclaimers](https://github.com/CDCgov/template/blob/main/DISCLAIMER.md), and [code of conduct](https://github.com/CDCgov/template/blob/main/code-of-conduct.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdcgov%2Fsswsort","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcdcgov%2Fsswsort","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdcgov%2Fsswsort/lists"}