Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update readme (installation section) #740

Merged
merged 7 commits into from
Sep 6, 2023
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 15 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,11 +35,11 @@ to use any of the available tasks and is encouraged to improve the, develop new

## Package Overview

**`eo-learn`** package is structured into several topical subfolders according to different functionalities. Some subfolders contain extension modules under `extra` subfolder. Those modules typically require additional package dependencies which don't get installed by default, since they are usually very specific to the task.
**`eo-learn`** package is structured into several modules according to different functionalities. Some modules contain extensions under the `extra` subfolder. Those modules typically require additional package dependencies which don't get installed by default, since they are usually very specific to the task.

The subfolders are:
The modules are:

- **`core`** - The main folder which implements basic building blocks (`EOPatch`, `EOTask` and `EOWorkflow`) and commonly used functionalities.
- **`core`** - The main module which implements basic building blocks (`EOPatch`, `EOTask` and `EOWorkflow`) and commonly used functionalities.
- **`coregistration`** - Tasks which deal with image co-registration.
- **`features`** - A collection of utilities for extracting data properties and feature manipulation.
- **`geometry`** - Geometry-related tasks used for transformation and conversion between vector and raster data.
Expand All @@ -52,11 +52,14 @@ The subfolders are:

### Requirements

#### Linux / Mac OS

Before installing `eo-learn` on **Linux** it is recommended to install the following system libraries:
mlubej marked this conversation as resolved.
Show resolved Hide resolved

```bash
sudo apt-get install gcc libgdal-dev graphviz proj-bin libproj-dev libspatialindex-dev
```
#### Windows

Before installing `eo-learn` on **Windows** it is recommended to install the following packages from [Unofficial Windows wheels repository](https://www.lfd.uci.edu/~gohlke/pythonlibs/):

Expand All @@ -71,13 +74,20 @@ One of the `[MASK_EXTRA]` dependencies is the `lightgbm` package. On Windows it

### PyPi distribution

The package requires Python version **>=3.8** . It can be installed with:
The package requires Python version **>=3.8** . If this is your first time installing `eo-learn`, or you aren't sure what kind of installation you require, than feel free to install it with:

```bash
pip install "eo-learn[ALL]"
```

This will install the package and all the default modules. Otherwise, if you're interested in a super light, core-only installation of `eo-learn`, then install it via:

```bash
pip install eo-learn
# pip install "eo-learn[CORE]" # this does the same thing
mlubej marked this conversation as resolved.
Show resolved Hide resolved
```

In order to avoid heavy package dependencies it is possible to install various scopes of package dependencies. Dependencies for each of the subfolders above (or their extra dependencies) can be installed via e.g.:
In order to avoid heavy environments, it is possible to install various scopes of package dependencies. Dependencies for each of the subfolders above (or their extra dependencies) can be installed via e.g.:

```bash
pip install "eo-learn[FEATURES]"
Expand Down
Loading