Skip to content

Commit

Permalink
Update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
folmos-at-orange committed Oct 13, 2023
1 parent 92fabda commit 5a84114
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 51 deletions.
70 changes: 19 additions & 51 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,59 +1,27 @@
# Khiops project
<img src=https://github.com/khiopsML/khiops/blob/93-update-the-readme-for-the-beta-release/packaging/common/images/new_khiops_logo.svg width=100 />
<!--<img src=https://github.com/khiopsML/khiops/blob/main/packaging/common/images/new_khiops_logo.svg width=100 />-->

# Compilation
# Khiops
Khiops is an AutoML suite for supervised and unsupervised learning

```bash
mkdir build
cmake -B build -S . -DMPI=ON -DFULL=OFF -DBUILD_JARS=ON -DTESTING=OFF -DCMAKE_BUILD_TYPE=Release
cmake --build build/ --parallel
```
# Installation
For the installation instructions [go to Khiops website][khiops-install].

# Packaging
# Documentation
See the documentation [at the Khiops website][khiops-web]

## CPack: deb, rpm and zip
# Development
See the [developer's documentation wiki][wiki-dev].

The different packages are built with cpack. The used generators are:
# License
This software is distributed under the BSD 3-Clause-clear License, the text of which is available at
https://spdx.org/licenses/BSD-3-Clause-Clear.html or see the [LICENSE](./LICENSE) for more
details.

- DEB for debian
- ZIP for KNI on windows
- RPM for redhat
# Help Contact
[email protected]

Run the following command to launch the packaging. The resulting packages are located on `build/packages`.

```bash
cd build
cpack -G DEB
```

On Fedora-like distro, the environment module mpi must be loaded before configure, build and package processes:

```bash
source /etc/profile.d/modules.sh
module load mpi/mpich-x86_64
mkdir build && cd build
cmake -B . -S .. -DMPI=ON -DFULL=OFF -DBUILD_JARS=ON -DTESTING=OFF -DCMAKE_BUILD_TYPE=Release
cmake --build . --parallel
cpack -G RPM
```

### CPack TODOs

- test packaging on macOS with `cpack -G FreeBSD`. It should work (we just have to get kni and khiops-sample out from the install)
- test NSIS on windows (`cpack -G NSIS64`)
- rewiew the KNI doc (the same one for Linux and Windows)
- change the package name to include the disto version on DEB and RPM
- Questions:
- remove packaging/common/khiops/doc/*.docx
- remove packaging/common/khiops/doc/KhiopsTutorial.pptx
- remove packaging/common/khiops/whatsnewV9.0.1.txt

## Conda

The package version is not imported from the source (TODO) then, we have to set the environment variable `KHIOPS_VERSION` before building the package.

```bash
# extract package version from sources
set KHIOPS_VERSION=$(grep "KHIOPS_VERSION" src/Learning/KWUtils/KWKhiopsVersion.h | cut -d"(" -f2 | cut -d")" -f1)
# build package
conda-build packaging/conda/
```
[khiops-web]: https://khiops.org
[khiops-install]: https://khiops.org/setup/installation
[wiki-dev]: https://github.com/KhiopsML/khiops/wiki
1 change: 1 addition & 0 deletions packaging/common/images/new_khiops_logo.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 5a84114

Please sign in to comment.