ForHosting KIT · 科学

種の相対優占度計算機

Q: この計算機はシャノンやシンプソンの多様性を求めますか？

いいえ。 それらの指数が使う p ベクトルだけを作ります。指数そのものが必要なら、返された proportions 配列を専用のシャノンまたはシンプソン能力に渡してください。

Q: 個体数の代わりにバイオマスや被度を使えますか？

はい。 個体数、バイオマス、胸高断面積、被度など、有限の非負優占度指標ならどれでも使えます。各行は全行の合計で割られます。

4種の木が40、30、20、10本なら合計は100で、割合は0.4、0.3、0.2、0.1です。生の個体数を、シャノンやシンプソン、均等度の指数に使える割合に変えます。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

群集生態学では、シャノンエントロピー、シンプソン優占度、ピールー均等度を求める前に、野外サンプルを相対優占度へ落とします。

相対優占度とは何か、多様性の作業がここから始まる理由

相対優占度とは、群集サンプルのうちある分類群が占める割合です。N で割らずに生カウントのまま次の指数へ進むと標本サイズが混ざり、踏査距離が違う2地点を比べられません。本計算機はその正規化だけを行い、多様性指数そのものは計算しません。

したがってシンプソンやシャノンのページと競合せず、種の相対優占度という検索に専用の着地です。個体数はポイントカウントの整数でも、バイオマス・胸高断面積・被度の非負実数でもよく、代数は同じです。全ゼロ標本には N がなく拒否されます。

多くのモニタリング報告がシェア表の横に添える、p ベクトルの短い相棒です。

入力する個体数と表示される割合

空でないオブジェクト配列で、各要素は空でない文字列 name と有限の非負数 count を持ちます。各行の count は n、abundance、individuals も受け付けます。この無料パース経路では最大1万行です。

並列配列 proportions と percents も入力順なので、シャノンやシンプソンのスクリプトが名前を解析せずに p ベクトルを使えます。表示と監査用に formula と method の文字列もあります。典型確認：名前付き4樹種の個体数40、30、20、10なら N は100、シェアは 0.4、0.3、0.2、0.1 です。

相対優占度が役立つ場面

生物多様性モニタリングでは、各プロットの生カウントを時系列保存やシャノン・シンプソン・均等度の計算機へ渡す前に p ベクトルへ落とします。環境影響評価や再生スコアカードは、攪乱後の林分がいまだ少数の機会的分類群に優占されていると主張するとき、再現可能な相対優占度を必要とします。Berger-Parker シェアと順位付き累積列がその主張を検証可能にします。

教育実験とオンライン生態学講座は、鳥のポイントカウントや植生方形区の名前付き個体数を入力し、R や vegan を入れずに百分率と順位が更新されるライブ計算機を使います。すでに多様性指数を計算している研究ノートは、p ベクトルを一度標準化して複数の指数に再利用でき、セルごとに N で割り直す必要がありません。

よくある質問

種の個体数を比例優占度へ変換するには？

{ name, count } 行の species 配列を送ってください。

この計算機はシャノンやシンプソンの多様性を求めますか？

いいえ。それらの指数が使う p ベクトルだけを作ります。指数そのものが必要なら、返された proportions 配列を専用のシャノンまたはシンプソン能力に渡してください。

個体数の代わりにバイオマスや被度を使えますか？

はい。個体数、バイオマス、胸高断面積、被度など、有限の非負優占度指標ならどれでも使えます。各行は全行の合計で割られます。

バーガー・パーカー指数とは何ですか？

最も多い種が占める割合です。40、30、20、10本の標本なら最優占種の割合は0.4で、一つの分類群がどれほど優占しているかをすぐに確かめられます。

累積割合からは何が分かりますか？

順位の高い種から割合を足し上げた値です。40、30、20、10本の例では上位2種で0.7、上位3種で0.9となり、少数の種が群集をどれだけ占めているかが分かります。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/bio/species-abundance-proportions

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/bio/species-abundance-proportions \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"species":[{"name":"Quercus alba","count":40},{"name":"Acer saccharum","count":30},{"name":"Fagus grandifolia","count":20},{"name":"Pinus strobus","count":10}]}'

const res = await fetch("https://api.kit.forhosting.com/bio/species-abundance-proportions", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "species": [
      {
        "name": "Quercus alba",
        "count": 40
      },
      {
        "name": "Acer saccharum",
        "count": 30
      },
      {
        "name": "Fagus grandifolia",
        "count": 20
      },
      {
        "name": "Pinus strobus",
        "count": 10
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/bio/species-abundance-proportions",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "species": [
        {
            "name": "Quercus alba",
            "count": 40
        },
        {
            "name": "Acer saccharum",
            "count": 30
        },
        {
            "name": "Fagus grandifolia",
            "count": 20
        },
        {
            "name": "Pinus strobus",
            "count": 10
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/bio/species-abundance-proportions", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"species":[{"name":"Quercus alba","count":40},{"name":"Acer saccharum","count":30},{"name":"Fagus grandifolia","count":20},{"name":"Pinus strobus","count":10}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"species":[{"name":"Quercus alba","count":40},{"name":"Acer saccharum","count":30},{"name":"Fagus grandifolia","count":20},{"name":"Pinus strobus","count":10}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/bio/species-abundance-proportions", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "species": [
    {
      "name": "Quercus alba",
      "count": 40
    },
    {
      "name": "Acer saccharum",
      "count": 30
    },
    {
      "name": "Fagus grandifolia",
      "count": 20
    },
    {
      "name": "Pinus strobus",
      "count": 10
    }
  ]
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "bio.species_abundance_proportions",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

max_items 10000

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

これらの指数が使うのは方形区・トランセクト・カスミ網の生カウントではなく、p_i＝n_i／N です。この種の相対優占度計算機は、名前付き分類群と非負の個体数（またはバイオマス、胸高断面積、被度など非負の優占度指標）の一覧を受け取り、各値を標本合計 N で割り、割合・百分率・順位・累積シェア・Berger-Parker 優占シェアを返します。空リスト、欠落した名前、負の個体数、全ゼロ標本は invalid_input で失敗し、中身のない p ベクトルを公開しません。

相対優占度とは何か、多様性の作業がここから始まる理由

種 i の優占度を n_i、標本の合計をすべての n_i の和 N とすると、比例優占度は p_i＝n_i を N で割った値です。生の集計ではなく、この p_i こそがシャノンエントロピー（p_i と p_i の自然対数の積の和の符号反転）、シンプソンの lambda（p_i の二乗和）、逆シンプソン（lambda の逆数）、ピールー均等度、順位－優占度図や Whittaker 図の入力です。個体数ゼロの行は p_i＝0 のまま残し、種の豊かさには加えません。優占分類群は最大カウントの行で、その p_i が Berger-Parker 優占度指数です。

入力契約、応答フィールド、検証エラー

必須フィールド species を含む JSON 本体を POST してください。一覧の別名は taxa、abundances、community、rows です。欠落フィールド、空リスト、オブジェクトでない行、空白の名前、非数値トークン、負値、全ゼロ合計は invalid_input で失敗し課金されません。成功時は入力順の species 配列を返し、各行は name、count、proportion p_i、percent、rank（1が最多、同点は先に入力した順）、cumulative_proportion（その順位順に沿った p の累積和で、優占曲線に使えます）を持ちます。要約フィールドは species_count（豊かさ：count がゼロより大きい行数）、row_count、total_individuals N、dominant_name、dominant_count、dominant_proportion、dominant_percent、berger_parker（最大の p_i に等しい）、sum_of_proportions（丸め後は1になるはず）です。

種の相対優占度 API が役立つ場面

p_i＝n_i／N を自動化すると、技術者が SUM 式をコピーして N を固定し忘れたときの表計算のずれが消えます。野外モバイルアプリはオフライン同期したカウント一覧から、接続復帰後に同じパースエンドポイントを呼べます。成功したタスクだけが公開の基本料金 $0.002 で課金され、モデルトークンもワーカーからの外向き通信もありません。

連携の活用例

プロットとトランセクトの p ベクトル

植生プロット、鳥のポイントカウント、方形区の名前付き個体数を、シャノンやシンプソンの前に p_i・百分率・順位へ変換します。

影響評価と再生の表

攪乱後も少数分類群が優占しているかを、完全なシェア表の横に Berger-Parker max(p_i) を添えて記録します。

教育実験と野外アプリ

学生や技術者が名前付き群集サンプルを貼り付け、後段分析の API 経路と同じ割合を読めるようにします。

技術的な質問

すべての個体数がゼロだとどうなりますか？

タスクは invalid_input で失敗します。N がゼロになるため p_i = n_i / N は未定義です。空リストと欠落した名前も拒否され、課金されません。

種の相対優占度計算機の料金は？

ブラウザの道具は無料です。API 要求は成功1回あたり $0.002 の前払い KIT 残高を使い、不正な入力は課金されません。

KITの完全なドキュメントを見る →

種の相対優占度計算機

無料で実行

相対優占度とは何か、多様性の作業がここから始まる理由

入力する個体数と表示される割合

相対優占度が役立つ場面

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

制限

エラー

技術的な注記

相対優占度とは何か、多様性の作業がここから始まる理由

入力契約、応答フィールド、検証エラー

種の相対優占度 API が役立つ場面

連携の活用例

プロットとトランセクトの p ベクトル

影響評価と再生の表

教育実験と野外アプリ

技術的な質問

ありがとう