Estimateur de métrage laine tricot

Saisissez stitch_count, gauge et yarn_per_stitch dans une unité de longueur cohérente pour le chiffre de consommation ; le moteur multiplie le nombre de mailles par la laine par maille pour obtenir le métrage brut, multiplie l’échantillon par la laine par maille pour indiquer la laine d’un rang d’une unité de largeur, et divise le nombre par l’échantillon pour indiquer combien de largeurs unitaires le total de mailles représente. Le waste_percent facultatif met à l’échelle la longueur brute pour les fils et les coutures, sans inventer un facteur caché. Le row_gauge facultatif ajoute la surface implicite du tissu, et le skein_length facultatif convertit le chiffre d’achat en écheveaux entiers. Les nombres, échantillons ou consommations nuls ou négatifs sont rejetés avec invalid_input, car un décompte ou une densité non positifs ne décrivent pas un projet tricotable. Le parcours est une arithmétique déterministe pure — sans réseau, sans graines aléatoires, sans dépendance à l’horloge —, de sorte que l’exécuteur gratuit du navigateur et l’API prépayée renvoient le même JSON après l’arrondi décimal fixe. Les appels API réussis coûtent $0.002 par requête.

Ce que signifie le métrage de laine au tricot à partir du nombre de mailles

Les tricoteuses estiment la laine de plusieurs manières, et cette page est le chemin qui part d’un total de mailles plutôt que de la largeur et de la hauteur finies. Un modèle peut publier un décompte pour le corps, les manches et l’encolure ; un compteur numérique peut indiquer combien de mailles vous avez déjà travaillées ; ou vous pouvez additionner vous-même les mailles de chaque répétition du diagramme. L’échantillon n’est pas un ornement. Ce n’est pas un estimateur de crochet par dimensions, ni un planificateur de montage, ni une calculatrice de substitution d’écheveaux ; ce sont d’autres intentions de recherche, avec d’autres champs obligatoires. Lorsque vous savez aussi quelle longueur de laine une maille consomme à l’échantillon auquel vous tricoterez vraiment, la longueur brute est un produit : yarn_length est égal à stitch_count fois yarn_per_stitch. C’est la densité de mailles du tissu qui a produit ce chiffre de consommation, et le moteur s’en sert pour indiquer yarn_per_unit_width (gauge fois yarn_per_stitch) afin que vous puissiez contrôler un rang d’une unité de largeur contre un rang mesuré, et stitch_widths (stitch_count divisé par gauge) pour voir combien de largeurs unitaires le total représente s’il est étendu comme un seul rang. Le waste_percent facultatif met ensuite yarn_length à l’échelle en yarn_with_waste pour les fils, les coutures et un peu de dérive d’échantillon ; la valeur par défaut est zéro, de sorte que l’outil ne gonfle jamais une liste d’achats en silence. Le row_gauge facultatif déverrouille implied_area comme stitch_count divisé par gauge fois row_gauge, et yarn_per_unit_area comme le produit de la consommation et des deux densités. Le skein_length facultatif transforme yarn_with_waste en une quantité d’achat en écheveaux entiers avec un plafond. Il n’y a ni base de marques, ni table de souplesse cachée, ni facteur de chute aléatoire : le moteur multiplie et divise les positifs finis que vous avez envoyés, ou rejette l’entrée avec invalid_input.

Comment appeler l’API et ce qui revient

Chaque champ obligatoire doit être strictement positif ; les valeurs inférieures ou égales à un fois dix à la moins quinze sont traitées comme non positives et rejetées, ce qui couvre les erreurs de mesure nulles et négatives exigées ainsi que les décomptes vides. Les champs de rang et d’écheveau n’apparaissent que lorsque vous avez envoyé ces facultatifs ; les clés omises sont omises, jamais null. Envoyez un corps JSON avec trois nombres positifs finis obligatoires : stitch_count (alias stitches, total_stitches, sts, stitchCount, project_stitches), gauge (alias stitch_gauge, sts_per, spi, stitches_per_unit, gauge_stitches) et yarn_per_stitch (alias consumption, yardage_per_stitch, yps, length_per_stitch, yarnPerStitch). Les valeurs absolues doivent rester dans la limite publiée d’un billion afin que les produits intermédiaires restent finis en double précision IEEE sur le Worker et dans le navigateur. Le waste_percent facultatif (alias waste, ease_percent, extra_percent) est un nombre de zéro à cent et vaut zéro par défaut. Le row_gauge facultatif (alias rows_per, rpi, gauge_rows, rows_per_unit) doit être strictement positif lorsqu’il est présent. Le skein_length facultatif (alias hank_length, ball_length, yards_per_skein, metres_per_skein) doit être strictement positif lorsqu’il est présent. Le precision facultatif (alias decimals, dp) choisit combien de décimales exposer, dix par défaut et un plafond de quinze pour que les goldens JSON restent stables d’une exécution à l’autre. En cas de succès, la réponse répète les entrées arrondies, fixe yarn_length et yarn_with_waste, ajoute yarn_per_unit_width et stitch_widths, attribue method à knit_stitch_count_yardage et inclut formula, message et un tableau ordonné steps. Une validation en échec renvoie invalid_input et n’est jamais facturée. Le tarif est un $0.002 forfaitaire par requête réussie avec l’unité item.

Mesure de la consommation, unités et différences avec les outils voisins

Mesurez yarn_per_stitch sur un échantillon tricoté, lavé et bloqué de la même manière que le vêtement, au même échantillon que vous utiliserez pour le projet. Conservez cette unité de longueur pour yarn_length et yarn_with_waste ; conservez gauge en mailles par la même unité de largeur que vous utiliseriez pour contrôler un rang (pouces ou centimètres). En enseignement, associez des exemples : vingt-huit mille mailles à cinq mailles par unité avec deux centièmes et cinq millièmes d’unité de laine par maille donnent sept cents unités de laine brute ; la même pièce avec dix pour cent de chute donne sept cent soixante-dix ; et stitch_count égal à zéro démontre le chemin strict invalid_input sur un décompte non positif. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui garde bon marché les scripts exploratoires lorsque les apprenants mettent stitch_count à zéro exprès. Les contrôles aller-retour sont simples : recalculez stitch_count fois yarn_per_stitch à la main et confirmez que cela égale yarn_length avec le même arrondi, et confirmez que gauge fois yarn_per_stitch égale yarn_per_unit_width.