# Using Algorithms Directly

All layout algorithms implemented in the Eclipse Layout Kernel can be called directly. To do so, you must have an instance of our ElkGraph data structure that can be fed to the layout algorithm, which will then compute a layout for the graph’s elements.

Warning: This is very low-level stuff. If you want to stay in the pure-Java domain (as opposed to building an Eclipse-based application), you will probably want to use the next layer of abstraction.

## The Entry Point to Layout Algorithms

When using layout algorithms directly, the central most important type you will deal with is the `AbstractLayoutProvider` class. A layout provider basically consists of three methods:

    void initialize(String parameter);
    void layout(KNode layoutGraph, IElkProgressMonitor progressMonitor);
    void dispose();

Each layout algorithm provides a subclass of `AbstractLayoutProvider` that is the entry point to the algorithm. Using it is a matter of doing the following:

1. Create an ElkGraph to be laid out (see our graph documentation for how to do so). The ElkGraph will be based on the diagram you want your application to display.

2. Configure how the layout algorithm should layout your graph by setting layout options on the graph’s elements. Check the documentation of the layout algorithm you want to use for which layout options it supports and what they do, exactly.

3. Obtain an instance of the layout algorithm’s implementation of `AbstractLayoutProvider`. For our layer-based algorithm, for example, this is the `LayeredLayoutProvider`. Be sure to call `initialize(...)` on it. The parameter can be `null` in most cases, unless specified otherwise.

4. Call the `layout(...)` method and pass it the graph to be laid out as well as a progress monitor to track progress. The progress monitor will allow users to see how long layout will take and to cancel the operation. If you do not care to provide your own progress monitor, simply use `BasicProgressMonitor`, which is our default implementation. Once the `layout(...)` method returns, the result will be stored in the layout-related fields of the graph.

5. Either keep your layout provider instance around to be used again for the next layout run, or call `dispose()` on it and throw it away.

- Tool Developers
- Graph Data Structure
- Coordinate System
- Layout Options
- JSON Format
- ELK Text Format
- Using Algorithms Directly
- Using Plain Java Layout
- Using Eclipse Layout
- Connecting to ELK
- Advanced Configuration
- Layout View Support
- Dependency Injection
- Algorithm Developers
- Getting Eclipse Ready
- Creating a New Project
- ELK Metadata Language
- Automatic Builds
- Algorithm Implementation
- Structuring Algorithms
- Algorithm Debugging
- Unit Tests
- ELK Contributors
- Development Setup
- Development Workflow
- Installing With Oomph
- Building ELK