Nuc Frames Transfer Plan 5Frame Guide

Plan a nuc frame transfer against caller class requests and slots, taking donor order as explicit priority; no fixed five-frame recipe, queen relocation or actual hive modification.

Description

A nuc transfer plan matches an ordered donor inventory with requested frame classes and available recipient slots.

A nuc transfer plan matches an ordered donor inventory with requested frame classes and available recipient slots. The donor order supplies selection priority rather than an embedded five-frame recipe.^[1]

Plan a nuc frame transfer against caller class requests and slots, taking donor order as explicit priority; no fixed five-frame recipe, queen relocation or actual hive modification.

When to use Nuc Frames Transfer Plan 5Frame Guide

Use this tool to plan a nuc frame transfer against caller class requests and slots, taking donor order as explicit priority; no fixed five-frame recipe, queen relocation or actual hive modification.

Prepare the hive, sample or operating measurements and any supplied target values. Confirm units, timing and whether counts or masses refer to the same population or batch.

How to use Nuc Frames Transfer Plan 5Frame Guide and understand its results

Prepare the hive, sample or operating measurements and any supplied target values. Confirm units, timing and whether counts or masses refer to the same population or batch.
Enter donorFrameIds, frameClassIds, requestedCountsByClass, recipientSlotCapacity using the field table and calculation rules, then run the tool.
Read transferredFrameIds, retainedFrameIds. The explanation below defines the units, signs, ordering and any flags or placeholder values.
If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.

Input field	Meaning	Value type; see rules below	Requirement
donorFrameIds	Donor frame ids	list of number	Required
frameClassIds	Frame class ids	list of number	Required
requestedCountsByClass	Requested counts by class	list of number	Required
recipientSlotCapacity	Recipient slot capacity	integer	Required

Pair unique nonnegative integer donor IDs with class IDs starting at one, supply 1–128 nonnegative integer requested class counts and nonnegative integer recipient capacity. Requested total must fit the slots. Scan donor order, selecting frames while a class is needed and retaining others; reject insufficient class inventory. Return transferred and retained IDs in donor order.

Paired lists must be nonempty and have equal lengths.

transfer each donor frame while its requested class still has unmet count

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output field	Meaning	Value type
transferredFrameIds	Transferred frame ids	list of number
retainedFrameIds	Retained frame ids	list of number

json

{
  "input": {
    "donorFrameIds": [
      10,
      20,
      30,
      40
    ],
    "frameClassIds": [
      1,
      2,
      2,
      3
    ],
    "requestedCountsByClass": [
      1,
      1,
      1
    ],
    "recipientSlotCapacity": 3
  },
  "output": {
    "transferredFrameIds": [
      10,
      20,
      40
    ],
    "retainedFrameIds": [
      30
    ]
  }
}

Limitations and assumptions

Despite the route name, recipient capacity is caller supplied. The tool does not move frames, relocate a queen or establish biological adequacy.

Numeric inputs must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Numeric lists are limited to 100,000 entries; the rules above may require smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.

Alternative or Complementary methods

Use Split Ratio Colony Divider: Apportion integer adults/brood frames by largest remainders and continuous feed by caller split weights; input order breaks integer ties, and biological adequacy is not inferred. For a complementary task, use Mating Nuc Resource Allocation Split: Plan whole mating nucs against disjoint brood, bee, feed and queen resources with caller per-nuc needs; not a biological adequacy or colony-splitting recommendation.

References

Nuc Frames Transfer Plan 5Frame Guide — tool.io

Similar or alternative tools

Split Ratio Colony Divider
Apportion integer adults/brood frames by largest remainders and continuous feed by caller split weights; input order breaks integer ties, and biological adequacy is not inferred.
Mating Nuc Resource Allocation Split
Plan whole mating nucs against disjoint brood, bee, feed and queen resources with caller per-nuc needs; not a biological adequacy or colony-splitting recommendation.