From ba4443f0b74e3a7d4649330aa00a95e927881d68 Mon Sep 17 00:00:00 2001 From: remi Date: Sat, 18 Jan 2025 15:56:18 -0500 Subject: [PATCH] fix readme --- README.md | 95 +++++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 85 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index cceadb7..93d5720 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,93 @@ -# MDAF -## install the package with -- pip install git+fullurl - - - if needed to reinstall the package for testing: py -m pip install --upgrade --force-reinstall git+fullurl +Based on the provided code snippets, I'll create a basic README file for the repository. Please note that this is a generated file and might not cover all aspects of the repository. -- use specific versions: python 37 +**MDAF Repository** +====================== -- dependencies: rpy2, scikitlearn, +**Overview** +------------ + +The MDAF (Multi-Disciplinary Analysis Framework) repository provides a collection of tools and functions for performing multi-disciplinary analysis, optimization, and surrogate modeling. + +**Installation** +--------------- + +To install the MDAF package, use the following command: + +```bash +pip install git+fullurl +``` + +**Dependencies** +--------------- + +The MDAF package depends on the following libraries: + +* `rpy2` +* `scikit-learn` +* `numpy` +* `matplotlib` + +**Usage** +----- + +The MDAF package provides several functions and tools for performing multi-disciplinary analysis, optimization, and surrogate modeling. Some examples include: + +* `installFlacco`: Installs the Flacco package and its dependencies. +* `representfunc`: Represents test functions for analysis and optimization. +* `doe`: Performs design of experiments (DOE) for surrogate modeling. + +**Test Functions** +----------------- + +The MDAF package includes a collection of test functions for analysis and optimization, including: + +* `Alpine.py` +* `Bukin4.py` +* `Bukin6.py` +* `Keane.py` +* `Leon.py` +* `Miele_Cantrell.py` +* `Rastriring.py` +* `Step.py` +* `Step2.py` +* `Wayburn.py` +* `Zettle.py` +* `Zirilli.py` + +**Notebooks** +------------ + +The repository includes several Jupyter notebooks that demonstrate the usage of the MDAF package, including: + +* `Analyse_folders_and_description.ipynb` +* `PSO.ipynb` +* `Simulated_Annealing_General.ipynb` + +**Tests** +-------- + +The repository includes a collection of unit tests and integration tests to ensure the correctness of the MDAF package. + +**License** +------- + +The MDAF package is released under the CC0 license. + +Please note that this is a basic README file, and you may want to add more information, such as usage examples, API documentation, and contributing guidelines, to make it more comprehensive. + +## Misc +- reinstall the package for testing: +```bash +py -m pip install --upgrade --force-reinstall git+fullurl +``` + +- use specific versions: `python 37` + +- dependencies: `rpy2, scikitlearn, ` - Windows: install R first - - When using installFlacco please choose to create a new library - -- Please ignore the importlib install error since it is a built in package of python - - Removed the importlib dependency to resolve the issue + - When using installFlacco please choose to create a new library on the first run