BlyxDocumentation
Browse chapters
Documentation / Workflow recipes

Egret · Compare abundance and diversity in a field survey

Summarize richness, singletons and dominance in an ecological field survey.

Compare abundance and diversity in a field survey

Two surveys can have the same species count and very different abundance patterns. Report diversity alongside observed richness. Two equally abundant taxa give Simpson dominance 0.5 and an effective count of two.

Run the framework with your own input

Install Blyx 0.2.1 and a Rust toolchain with a host linker, then run the versioned project. Each positional argument is a number or a comma-separated numerical vector. The CLI accepts up to 16 entries per vector. The imported module accepts longer inputs.

git clone --depth 1 --branch v0.1.0 https://github.com/Rahulchaube1/blyx-egret.git
cd blyx-egret
blyxc native-run project.blyx -- "2,0,2"

API and return values

Returns [individuals, observed taxa, singletons, dominance, effective taxa]. An entirely empty survey has no diversity estimate. Invalid input returns an empty vector.

ArgumentAccepted input
countsVector of: nonnegative exact integer

Use the libraries independently

The framework vendors the same library source published in these two repositories. Each module has its own package page, input contract and regression suite.

Try the program

Output Ready
Expected output
4
2
0
0.5
2
Open in the full playground →

Practice

Change counts = [1]. Predict the result, then run the program.

Hint

Returns [individuals, observed taxa, singletons, dominance, effective taxa]. An entirely empty survey has no diversity estimate.

Worked solution

The result vector is [1, 1, 1, 1, 1]. Compare its fields with the return layout in the API section.

Find

    let counts = [2, 0, 2];

Replace with

    let counts = [1];

Output after the change

1
1
1
1
1