{"id":19015277,"url":"https://github.com/americocunhajr/crflowlib","last_synced_at":"2025-04-23T01:44:05.477Z","repository":{"id":80384763,"uuid":"223008918","full_name":"americocunhajr/CRFlowLib","owner":"americocunhajr","description":"CRFlowLib is a collection of computational  libraries to simulate chemically  reacting flows employing ISAT algorithm.","archived":false,"fork":false,"pushed_at":"2025-04-04T19:34:46.000Z","size":31464,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-17T18:23:00.653Z","etag":null,"topics":["c","combustion","computational-chemistry","computational-mechanics","computational-physics","dynamical-systems","isat","numerical-algorithms","thermochemistry"],"latest_commit_sha":null,"homepage":"https://americocunhajr.github.io/CRFlowLib","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/americocunhajr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-20T19:12:53.000Z","updated_at":"2025-04-14T16:24:07.000Z","dependencies_parsed_at":"2024-11-08T19:50:01.089Z","dependency_job_id":null,"html_url":"https://github.com/americocunhajr/CRFlowLib","commit_stats":{"total_commits":121,"total_committers":1,"mean_commits":121.0,"dds":0.0,"last_synced_commit":"358255452185b711bb5f60df260f80bb54807ea4"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/americocunhajr%2FCRFlowLib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/americocunhajr%2FCRFlowLib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/americocunhajr%2FCRFlowLib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/americocunhajr%2FCRFlowLib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/americocunhajr","download_url":"https://codeload.github.com/americocunhajr/CRFlowLib/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250354292,"owners_count":21416749,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["c","combustion","computational-chemistry","computational-mechanics","computational-physics","dynamical-systems","isat","numerical-algorithms","thermochemistry"],"created_at":"2024-11-08T19:36:36.186Z","updated_at":"2025-04-23T01:44:05.470Z","avatar_url":"https://github.com/americocunhajr.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Chemically Reacting Flow Library\n\n**CRFlowLib - Chemically Reacting Flow Library** is a comprehensive collection of computational libraries for simulating chemically reacting flows using the In Situ Adaptive Tabulation (ISAT) algorithm for thermochemistry calculations.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"logo/CrFlowLib-Flowchart.png\" width=\"60%\"\u003e\n\u003c/p\u003e\n\n## Table of Contents\n- [Overview](#overview)\n- [Features](#features)\n- [Compilation](#compilation)\n- [Program execution](#program-execution)\n- [Documentation](#documentation)\n- [External dependencies](#external-dependencies)\n- [Reaction mechanisms](#reaction-mechanisms)\n- [Reproducibility](#reproducibility)\n- [Authors](#authors)\n- [Citing CRFlowLib](#citing-crflowlib)\n- [License](#license)\n- [Institutional support](#institutional-support)\n- [Funding](#funding)\n- [Contact](#contact)\n\n## Overview\n**CRFlowLib** was developed focused on reducing complexity in combustion thermochemistry. It provides a robust framework for simulating chemically reacting flows, leveraging the ISAT algorithm for efficient thermochemistry calculations. The package includes routines that are well-documented and easy to use, making it accessible for both educational and research purposes.\n\nThis library is the result of a master's thesis:\n- **A. Cunha Jr**, *Reduction of Complexity in Combustion Thermochemistry*, PUC-Rio, Master Thesis, 2010 \u003ca href=\"https://doi.org/10.17771/PUCRio.acad.17685\" target=\"_blank\"\u003eDOI\u003c/a\u003e\n \nThe PDF of this thesis is also available \u003ca href=\"https://hal.archives-ouvertes.fr/tel-01541173\" target=\"_blank\"\u003ehere\u003c/a\u003e.\n\nThe results of this thesis were disclosed in the following publication:\n- **A. Cunha Jr and L. F. Figueira da Silva**, *Assessment of a transient homogeneous reactor through in situ adaptive tabulation*, Journal of the Brazilian Society of Mechanical Sciences and Engineering, v. 36, pp. 377-391, 2014 \u003ca href=\"http://dx.doi.org/10.1007/s40430-013-0080-4 \" target=\"_blank\"\u003eDOI\u003c/a\u003e \n \nPreprint available \u003ca href=\"https://hal.archives-ouvertes.fr/hal-01438646\" target=\"_blank\"\u003ehere\u003c/a\u003e.\n\n### Features\n- Simulates chemically reacting flows using the ISAT algorithm\n- Includes routines for thermochemistry calculations\n- Well-documented code with detailed comments\n- Example scripts for representative benchmark tests\n- Compatible with both GNU Scientific Library and CVODE\n\n### Compilation\nTo get started with **CRFlowLib**, follow these steps:\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/americocunhajr/CRFlowLib.git\n   ```\n2. Navigate to the code directory:\n   ```bash\n   cd CRFlowLib/CRFlowLib-2.0\n   ```\n3. Compile all modules using the Makefile:\n   ```bash\n   make\n   ```\n4. To compile a specific program type:\n   ```bash\n   make program-title.exe # e.g., pmsr-isat.exe\n   ```\nSee the Makefile for further details.\n\nUsers can use the file 'main__pmsr-isat.c' as a baseline to define their own simulation problems.\n\n### Program execution\nAll programs depend on the ‘chem.bin’ file generated by ‘chem.exe’ program.\n\n1. To obtain the ‘chem.bin’ file type:\n   ```bash\n   make run_chem\n   ```\n2. To compile a specific program type:\n   ```bash\n   make run_program-title # e.g make run_pmsr-isat, make run_pmsr-di etc\n   ```\n\nSee the Makefile for further details.\n\n### Documentation\n**CRFlowLib** routines are thoroughly commented to explain their functionality. Each routine includes a short description of its purpose and a list of inputs and outputs. Users can refer to the example scripts provided to understand how to set up and run their simulations.\n\n### External dependencies\n\n##### CRFlowLib-1.0 - the original implementation\n* \u003ca href=\"https://www.gnu.org/software/gsl\" target=\"_blank\"\u003eGNU Scientific Library 1.12\u003c/a\u003e (open source)  \n* CVODE 2.5.0, which is part of \u003ca href=\"https://computing.llnl.gov/projects/sundials\" target=\"_blank\"\u003eSUNDIALS 2.3.0\u003c/a\u003e (open source)\n* Chenkin-II (proprietary software) --- Once this code is proprietary, you need to obtain its routines by yourself.\n\nThe following Chenkin-II libraries are necessary:\n - cklib.f\n - ckinterp.f\n - ckstrt.h\n\n##### CRFlowLib-2.0 - an updated implementation\n* \u003ca href=\"https://www.gnu.org/software/gsl\" target=\"_blank\"\u003eGNU Scientific Library 2.6\u003c/a\u003e (open source)\n* CVODE 5.0.0, which is part of \u003ca href=\"https://computing.llnl.gov/projects/sundials\" target=\"_blank\"\u003eSUNDIALS 5.0.0\u003c/a\u003e (open source)\n* Chenkin-II (proprietary software) --- Once this code is proprietary, you need to obtain its routines by yourself.\n\nThe following Chenkin-II libraries are necessary:\n- cklib.f\n- ckinterp.f\n- ckstrt.h\n\n### Reaction mechanisms\nThis repository stores a collection of thermochemistry mechanisms in Chemkin-II format. These kinetic mechanisms were developed by several research groups that works in the simulation of chemically reactive flows. This collection is the result of more than 15 years of search. All of these mechanisms were made available, at some time, on the Internet or in specialized literature. \n\nThe repository owner makes them available here with the intention that they may be useful for researchers interested in the topic. Unfortunately, no guarantee can be given regarding the integrity of the files or the accuracy of the mechanisms. Use it at your own risk!\n\n### Reproducibility\nSimulations done with **CRFlowLib** are fully reproducible, as can be seen on this \u003ca href=\"https://codeocean.com/capsule/2804669/tree/v1\" target=\"_blank\"\u003eCodeOcean capsule\u003c/a\u003e\n\n### Authors\n- Americo Cunha (UERJ)\n- Luis Fernando Figueira da Silva (PUC-Rio / Institut Pprime)\n\n### Citing CRFlowLib\nIf you use **CRFlowLib** in your research, please cite the following references:\n- *A. Cunha Jr and L. F. Figueira da Silva, CRFlowLib --- Chemically Reacting Flow Library, Software Impacts, v. 11, pp. 100206, 2022 https://doi.org/10.1016/j.simpa.2021.100206*\n- *A. Cunha Jr and L. F. Figueira da Silva, Assessment of a transient homogeneous reactor through in situ adaptive tabulation, Journal of the Brazilian Society of Mechanical Sciences and Engineering, v. 36, pp. 377-391, 2014 http://dx.doi.org/10.1007/s40430-013-0080-4*  \n- *A. Cunha Jr, Reduction of Complexity in Combustion Thermochemistry, PUC-Rio, Master Thesis, 2010 https://doi.org/10.17771/PUCRio.acad.17685*\n\n```\n@article{CunhaJr2022p100206,\n   author  = {A. {Cunha~Jr} and L. F. {Figueira da Silva}},\n   title   = {CRFlowLib --- Chemically Reacting Flow Library},\n   journal = {Software Impacts},\n   year    = {2022},\n   volume  = {11},\n   pages   = {100206},\n   doi     = {https://doi.org/10.1016/j.simpa.2021.100206},\n}\n```\n\n```\n@article{CunhaJr2014p377,\n   author  = {A. {Cunha~Jr} and L. F. {Figueira da Silva}},\n   title   = {Assessment of a transient homogeneous reactor through in situ adaptive tabulation},\n   journal = {Journal of the Brazilian Society of Mechanical Sciences and Engineering},\n   year    = {2014},\n   volume  = {36},\n   pages   = {377-391},\n   doi     = {http://dx.doi.org/10.1007/s40430-013-0080-4},\n}\n```\n\n```\n@mastersthesis{CunhaJr2010msc,\n   author       = {A. {Cunha~Jr}}, \n   title        = {Reduction of Complexity in Combustion Thermochemistry},\n   school       = {PUC-Rio},\n   year         = {2010},\n   address      = {Rio de Janeiro},\n   note         = {https://doi.org/10.17771/PUCRio.acad.17685},\n}\n```\n\n### License\n**CRFlowLib** is released under the MIT license. See the LICENSE file for details. All new contributions must be made under the MIT license.\n\n\u003cimg src=\"logo/mit_license_red.png\" width=\"10%\"\u003e \n\n### Institutional support\n\n\u003cimg src=\"logo/logo_uerj_color.jpeg\" width=\"10%\"\u003e \u0026nbsp; \u0026nbsp; \u003cimg src=\"logo/logo_pucrio_color.jpg\" width=\"07%\"\u003e \u0026nbsp; \u0026nbsp; \u003cimg src=\"logo/logo_pprime_color.jpeg\" width=\"15%\"\u003e\n\n### Funding\n\n\u003cimg src=\"logo/faperj.png\" width=\"20%\"\u003e \u0026nbsp; \u0026nbsp; \u003cimg src=\"logo/cnpq.png\" width=\"20%\"\u003e \u0026nbsp; \u0026nbsp; \u003cimg src=\"logo/capes.png\" width=\"10%\"\u003e\n\n### Contact\nFor any questions or further information, please contact the first author:\n- Americo Cunha Jr: americo.cunha@uerj.br\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famericocunhajr%2Fcrflowlib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famericocunhajr%2Fcrflowlib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famericocunhajr%2Fcrflowlib/lists"}