How do I use YMTreeMap with a UICollectionView for a scrolling treemap?

You can create a custom UICollectionViewLayout that uses YMTreeMap to calculate cell frames. The library outputs CGRects, which you can map to collection view items, but you'll need to handle cell rendering and recycling yourself.

YMTreeMap or Charts framework for iOS treemaps – which is better?

YMTreeMap is better for custom, high-performance layouts where you need control over rendering. Charts framework offers pre-built, interactive treemaps but may be heavier and less flexible. Choose YMTreeMap for lightweight, bespoke visualizations; Charts for out-of-the-box features.

Can I update the treemap layout dynamically with new data in YMTreeMap?

Yes, you can recompute the layout by calling tessellate with new values, but there's no built-in animation or smooth transitions. You'll need to manage UI updates manually, which can be performance-intensive for frequent changes.

How to add custom colors and text labels to YMTreeMap rectangles?

YMTreeMap only provides rectangle geometries. You must implement coloring and labeling in your rendering code, such as in drawRect for CoreGraphics or in UICollectionViewCell subclasses, using the output CGRects.

Is YMTreeMap fast enough for live financial data feeds?

With performance under 4ms for 1,000 items, it's suitable for real-time updates. However, you need to ensure efficient rendering and data handling, as the library itself only handles layout computation.

How to install YMTreeMap using Swift Package Manager?

The README only mentions CocoaPods installation. For SPM, you might need to check if the repository supports it or manually integrate the source files, as there's no explicit SPM support documented.

Open-Awesome

YMTreeMap

MITSwift1.1.0

High-performance Swift treemap layout engine for iOS and macOS using the squarified algorithm.

GitHub

164 stars13 forks0 contributors

What is YMTreeMap?

YMTreeMap is a high-performance treemap layout engine for iOS and macOS, written in Swift. It transforms a list of numerical values into a set of layout rectangles where each rectangle's size represents the relative weight of its corresponding value. The library uses the squarified treemap algorithm to generate rectangles with low aspect ratios, making them visually appealing and efficient for rendering.

Target Audience

iOS and macOS developers who need to integrate treemap visualizations into their applications, particularly those working with data-heavy interfaces like financial dashboards, analytics tools, or hierarchical data displays.

Value Proposition

Developers choose YMTreeMap for its exceptional performance, handling up to 1,000 items in milliseconds, and its flexibility—output rectangles work with CoreGraphics, OpenGL, or custom UICollectionView layouts. Its focused design avoids unnecessary bloat while providing a robust, algorithmically sound layout engine.

Overview

High performance Swift treemap layout engine for iOS and macOS.

Use Cases

Best For

Creating financial data visualizations like stock market heatmaps
Building analytics dashboards with hierarchical data representation
Implementing performance-sensitive treemaps in scrolling table views
Developing custom data visualization components for iOS/macOS apps
Integrating treemaps with CoreGraphics or OpenGL rendering pipelines
Displaying large datasets (up to 1,000 items) with minimal layout latency

Not Ideal For

Projects requiring interactive treemaps with out-of-the-box hover effects or click handling
Cross-platform applications that need treemap visualizations on web, Android, or other non-Apple platforms
Use cases involving hierarchical data with nested categories, as it only accepts flat value lists

Pros & Cons

Pros

Blazing Fast Layout

Benchmarks demonstrate rendering 1,000 items in under 4ms on an iPhone 7 Plus, enabling smooth performance in scrolling table views and real-time applications.

Visually Optimized Output

Implements the squarified treemap algorithm to generate rectangles with low aspect ratios, making treemaps as square as possible for better visual appeal and readability.

Rendering Agnostic

Outputs raw CGRect rectangles, allowing developers to use CoreGraphics, OpenGL, or custom UICollectionView layouts without being locked into a specific rendering pipeline.

Order-Aware Layout

Preserves the input order of values, so when data is sorted before passing it in, the treemap maintains that order for meaningful visual hierarchies.

Cons

Bare-Bones Engine

Only provides layout rectangles with no built-in rendering, styling, or interactivity, requiring significant additional code to create a complete, user-friendly visualization.

Flat Data Model

Accepts a flat list of numerical values and does not natively support hierarchical data structures, which limits its use for complex nested treemaps without manual preprocessing.

Platform Lock-In

Exclusively designed for iOS and macOS with Swift/Objective-C, making it unsuitable for projects targeting other platforms or requiring cross-platform compatibility.

Frequently Asked Questions

Related Projects

SkeletonView

☠️ An elegant way to show users that something is happening and also prepare them to which contents they are awaiting

Stars12,890

Forks1,122

Last commit4 months ago

Material

A UI/UX framework for creating beautiful applications.

Stars12,017

Forks1,260

Last commit4 years ago

NVActivityIndicatorView

A collection of awesome loading animations

Stars10,700

Forks1,153

Last commit7 months ago

Macaw

Powerful and easy-to-use vector graphics Swift library with SVG support

Stars6,046

Forks567

Last commit2 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub