ForHosting KIT · 開発者向けツール

個体群の二次生産量計算ツール

二次生産とは、一定期間に個体群が新たに生み出した動物または消費者のバイオマスです。この計算ツールは、個体の成長で増えたバイオマスと繁殖に配分されたバイオマスを合計し、総生産量と時間単位当たりの生産速度を示します。さらに、成長と繁殖が占める割合も分けて表示します。両方の測定値には同じバイオマス単位を使い、研究に適した時間単位を指定してください。単位を自動変換せず、入力した単位関係をそのまま結果に反映します。

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

無料で実行 API仕様を見る

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

この計算が表すもの

二次生産は、個体群内で新しい従属栄養生物のバイオマスが形成されることを指します。コホート、底生生物試料、昆虫個体群、魚類資源、その他の消費者群では、この形成を二つの経路に分けられます。一つは生物の成長によって増えた組織で、もう一つは子や繁殖産物に配分されたバイオマスです。この計算ツールは、測定した二つの量を足して観察期間全体の二次生産量を求め、さらに期間の長さで割って時間について標準化した生産速度を算出します。これはバイオマス収支であり、現存量の推定ではありません。ある調査日の現存量には以前に形成された物質が含まれる場合がありますが、生産量に含めるのは対象期間中に新しく形成されたバイオマスだけです。また、死亡や移出によって観察時の現存量が減っても、すでに起きた生産が取り消されるわけではありません。そのため、入力値には期首と期末の現存量を単純に差し引いた値ではなく、成長と繁殖を評価した値を使用してください。二つのバイオマス値は必ず同じ単位で入力する必要があります。

期間と単位をそろえる方法

成長バイオマスと繁殖バイオマスには、乾燥重量のグラム、炭素量のミリグラム、湿重量のキログラム、エネルギー換算量など、同じ単位を使用してください。期間は、生産速度に使いたい時間単位で正の数として入力します。たとえば、バイオマスをグラム、期間を日で入力すると、二次生産量はグラム、生産速度は一日当たりのグラムになります。期間を十二か月と入力した場合は月当たりの速度となり、年当たりにするには期間をあらかじめ年へ換算する必要があります。生態学的データでは湿重量、乾燥重量、灰分除去乾燥重量、炭素量、エネルギー量など異なる基準が使われるため、このツールは単位を推測したり変換したりしません。異なる基準を混ぜると、数値は精密に見えても無効な結果になります。繁殖バイオマスは研究の集計範囲に従い、二重に数えないでください。生殖腺の成長が体成長や全身の成長にすでに含まれる場合、放出された子または繁殖産物を別の生産項として扱う方法でのみ再度加算します。後の比較でも同じ範囲を使えるよう、この判断を結果とともに記録してください。

総量、速度、割合の読み方

二次生産量は、指定した期間全体で生み出されたバイオマスの総量です。生産速度は同じ総量を期間単位当たりで表すため、標本採取法と単位の定義が共通であれば、長さの異なる観察期間を比較しやすくなります。成長と繁殖の寄与率は、総生産量が二つの経路にどのように配分されたかを示します。成長の割合が高い場合、記録された生産の多くが個体の体を大きくする組織になったことを意味します。繁殖の割合が高い場合は、子や繁殖物質が新しいバイオマスの大きな部分を占めたことを示します。ただし、これらの割合は入力した生産項の配分を示すだけであり、繁殖成功、加入、生存、摂食、または生態効率を測るものではありません。両方の入力値がゼロなら総生産量もゼロであり、配分する生産がないため二つの割合もゼロになります。地点、季節、種を比較する際は、バイオマス基準、期間の定義、生活段階、繁殖の扱いを統一してください。標本誤差が重要な場合は、この決定論的な点推定を不確実性モデルとみなさず、妥当な下限値と上限値を別々に計算してください。

活用例

コホート生産量の集計

季節または生活段階の期間について、測定した体成長と繁殖生産を合算します。

個体群間の配分比較

同じ集計方法を用いて、成長と繁殖に配分された生産割合を個体群間で比較します。

野外調査結果の時間標準化

既知の期間に観察した総生産量を、選択した時間単位当たりの速度に換算します。

よくある質問

二次生産量の計算式は何ですか？

二次生産量は、指定期間中に成長で増えたバイオマスと繁殖に配分されたバイオマスの合計です。生産速度は、その合計を期間の長さで割って求めます。

どのバイオマス単位を使用できますか？

二つの入力で同じ基準を使えば、任意のバイオマス単位またはエネルギー換算単位を使用できます。総量はその単位、生産速度はその単位毎時間で示されます。

死亡量を差し引く必要がありますか？

いいえ。生産量は形成されたバイオマスを測るため、その後に死亡で失われた分も含みます。研究の集計方法に合った成長と繁殖の推定値を使用してください。

二つのバイオマス値がともにゼロの場合はどうなりますか？

総生産量と生産速度はゼロです。配分する生産がないため、成長と繁殖の寄与率も両方ともゼロになります。

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

一回のリクエスト料金は$0.002です。対話的な計算はブラウザでも利用できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/bio/secondary-production

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

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

curl -X POST https://api.kit.forhosting.com/bio/secondary-production \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"growth_biomass":120,"reproductive_biomass":30,"time_interval":12}'

const res = await fetch("https://api.kit.forhosting.com/bio/secondary-production", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "growth_biomass": 120,
    "reproductive_biomass": 30,
    "time_interval": 12
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/bio/secondary-production",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "growth_biomass": 120,
    "reproductive_biomass": 30,
    "time_interval": 12
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/bio/secondary-production", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"growth_biomass":120,"reproductive_biomass":30,"time_interval":12}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"growth_biomass":120,"reproductive_biomass":30,"time_interval":12}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/bio/secondary-production", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "growth_biomass": 120,
  "reproductive_biomass": 30,
  "time_interval": 12
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "bio.secondary_production",
  "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の完全なドキュメントを見る →