ForHosting KIT · 開発者向けツール

植物種の重要度指数を計算

この重要度指数計算ツールは、調査対象の植物群落における種の相対密度、相対頻度、相対優占度という3つの指標を組み合わせます。各成分をパーセントで入力すると、一般的なゼロから300までの尺度で合計を返します。ある種が調査内でどれほど多く、広く分布し、群落構造に影響しているかを要約する際に役立ちます。出力には入力値も表示されるため、計算を確認して再現し、野外調査報告書や分析処理にそのまま組み込めます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

比較可能な3つの相対値を準備します

重要度指数の信頼性は、入力する3つのパーセント値の品質に左右されます。相対密度は全個体数に占める対象種の割合、相対頻度は出現頻度の合計に占める割合、相対優占度は胸高断面積などの構造的指標に占める割合を示します。すべての成分を、同じ調査範囲、標本設計、種の集合から計算してください。小数比ではなくパーセントを入力します。35パーセントなら0.35ではなく35と入力してください。各値はゼロから100まででなければなりません。成分がゼロになる場合はありますが、調査で確認されなかった種について通常はIVIを計算する必要はありません。任意の種名は表示用ラベルにすぎず、計算には影響しません。比較前には、すべての種で優占度の定義が同じであることをご確認ください。森林調査では胸高断面積が一般的で、別の植生調査では被度が適することもありますが、定義を混在させると解釈できなくなります。相対値の算出に使った個体数、区画別出現、断面積、総計も保存してください。本ツールは範囲を検査しますが、前段階の標本計算までは検証しません。

合計方法と尺度を理解します

計算式は明確で、重要度指数は相対密度、相対頻度、相対優占度の合計です。各成分がゼロから100パーセントまでなので、一般的な指数の範囲はゼロから300です。たとえば35.5、42.25、28.75を入力すると、IVIは106.5になります。優占度を胸高断面積や被度から算出していても、入力する3成分はいずれも相対パーセントなので、指数自体に単位はありません。精度設定は最終合計の丸めだけを制御し、応答に再掲される各成分を変更したり丸めたりしません。高い値は、その調査の定義に基づく総合的な卓越性が高いことを示しますが、同じ合計でも生態的な内訳は大きく異なり得ます。非常に個体数が多いものの少数の区画に限られる種もあれば、広く分布していても個体が小さい種もあります。合計だけで完全に説明したと考えず、必ず3成分も併せて確認してください。元の手法がゼロから1の比率を用いる場合や2成分の指数を採用する場合は、正しく換算するか、その手法に合う計算ツールをご利用ください。

結果を過大評価せずに種を比較します

IVIは、調査した群落内で植物種を順位付けし、管理上の注意が必要な候補を見つけ、同じ手順を反復した際の変化を追跡するのに役立ちます。種ごとに結果を計算し、各成分を保持したまま値を並べ替えてください。相対値の分母には群落全体の総計が使われるため、比較は同一データセット内で最も確実です。ある森林のIVIが90でも、区画面積、季節、直径の基準、分類規則、優占度の測定法が異なる別の森林の90と自動的に同等になるわけではありません。また、この指数は生態的適応度、保全価値、侵略性、バイオマス生産、因果的影響を直接測定するものではありません。最終的な加算が正確でも、標本誤差や同定ミスは全成分に影響します。区画配置、調査日、採用基準、頻度の定義、優占度の基礎を記録してください。自動処理向けに、応答では入力値、最大尺度、式を再掲します。APIリクエストは $0.002 から利用でき、決定論的な計算は表計算、野外データ検証、教育、植生表、再現可能な報告書に適しています。

活用例

植生調査の種を順位付けします

記録された各植物種について、密度、出現頻度、構造的優占度を比較可能な1つの指数にまとめます。

群落の変化を追跡します

異なる調査日に同じ計算を繰り返し、生態的な変化を解釈できるよう各成分を保持します。

野外報告書の計算を検査します

報告されたIVIを3つの相対パーセント値と照合し、明示的な式を結果とともに保存します。

よくある質問

この計算ツールではどの式を使いますか？

相対密度、相対頻度、相対優占度を加算します。

IVIの値はどの範囲になりますか？

各成分をゼロから100までのパーセントで入力すると、重要度指数はゼロから300までになります。

パーセントと小数比のどちらを入力しますか？

パーセントを入力してください。たとえば25パーセントの場合、0.25ではなく25と入力します。

相対優占度には何を使えばよいですか？

調査手法で定めた相対的な構造指標をご使用ください。森林調査では胸高断面積、ほかの植生調査では被度がよく使われます。

別々の調査のIVIを比較できますか？

慎重な判断が必要です。手法、採用基準、時期、優占度の定義が共通する調査ほど、比較の妥当性が高まります。

APIの利用料金はいくらですか？

APIリクエストは1件あたり $0.002 からです。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/bio/importance-value-index

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

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

curl -X POST https://api.kit.forhosting.com/bio/importance-value-index \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"relative_density":35.5,"relative_frequency":42.25,"relative_dominance":28.75}'

const res = await fetch("https://api.kit.forhosting.com/bio/importance-value-index", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "relative_density": 35.5,
    "relative_frequency": 42.25,
    "relative_dominance": 28.75
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/bio/importance-value-index",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "relative_density": 35.5,
    "relative_frequency": 42.25,
    "relative_dominance": 28.75
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/bio/importance-value-index", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"relative_density":35.5,"relative_frequency":42.25,"relative_dominance":28.75}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"relative_density":35.5,"relative_frequency":42.25,"relative_dominance":28.75}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/bio/importance-value-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "relative_density": 35.5,
  "relative_frequency": 42.25,
  "relative_dominance": 28.75
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

エラー

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

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