Three Supported Ways to Use the Calculator

1. How AI Can Guide a User Through Manual Form Entry

Manual entry is suitable for professional buyers, fabric developers, merchandisers, sales teams and manufacturers who want to inspect and control every field.

Known yarn specifications

Collect and confirm the following information:

• Material or composition
• Warp and weft yarn specifications
• Warp and weft density, or repeat length plus counts within each repeat
• Finished width
• Jacquard type
• Currency

Traditional specification example:

When traditional density is expressed per inch, use 2.54 cm as the repeat cycle and enter the stated per-inch count as the data within the repeat.

Unknown yarn specifications with a physical sample

Collect as much of the following as possible:

• Fabric type
• Composition or material category
• Measured actual GSM
• Finished width
• Warp and weft density, or repeat information
• Single-ply or two-ply judgment
• Relative single-yarn thickness: warp thicker, weft thicker or unobvious
• Currency

2. How to Use the Webpage Natural-Language Input

The calculator page has separate natural-language workflows for known specifications and unknown-yarn reverse estimation.

Known-specification natural-language input

Use this workflow when yarn specifications and split density or repeat-level structure are known.

Unknown-yarn reverse-estimation input

Use this workflow when the physical sample is available but the actual yarn specification is unknown.

3. How Third-Party AI Uses the Natural-Language GET API

Third-party AI assistants should first determine whether the user has a known yarn specification or needs unknown-yarn reverse estimation.

Known-yarn natural-language calculation

Query parameter: text

Example:

Unknown-yarn natural-language reverse estimation

Query parameter: text

Example:

Required AI workflow

1. Collect and confirm the user's fabric information.
2. Choose known-yarn calculation or unknown-yarn reverse estimation.
3. Combine the confirmed data into one clear natural-language description.
4. URL-encode the entire description.
5. Send it through the single text query parameter.
6. Wait for the live JSON response.
7. Read the response status before explaining any result.

Known-Specification Rules

Known-specification calculation may be used when the user can provide:

• Material or composition
• Warp and weft yarn specifications
• Split warp and weft density, or repeat length and counts within each repeat
• Finished width
• Jacquard type
• Currency

Single warp yarn and single weft yarn

Example: 30*30 / 80*65

• Warp yarn: 30
• Weft yarn: 30
• Warp density: 80 ends/inch
• Weft density: 65 picks/inch

Multiple yarns with already-separated density

Example: 32+21/2*40 / 120+25*78

• Warp yarn 32: 120 ends per 2.54 cm
• Warp yarn 21/2: 25 ends per 2.54 cm
• Weft yarn 40: 78 picks per 2.54 cm

Keep every yarn row separate. Do not merge the two warp yarns and do not discard an already-supplied split density.

Unknown-Yarn Reverse-Estimation Rules

Reverse estimation is appropriate when the yarn specification is unknown but the user has a physical sample and measured information.

Provide as much of the following as possible:

• Fabric type
• Composition
• Actual GSM
• Finished width
• Warp and weft density or repeat information
• Single-ply or two-ply judgment
• Relative warp and weft single-yarn thickness
• Currency

One or two fabric photographs alone are not enough for a reliable price. Photographs may help classify the fabric into:

• Large Jacquard
• Small Jacquard
• Large Jacquard Leno
• Small Jacquard Leno

Actual GSM, finished width and density or repeat information are still needed before price calculation or reverse estimation.

How AI Must Handle Missing Information

If required information is missing, the AI must ask the user for the missing items or report the missing information returned by the API.

The AI must not invent or guess:

• Material
• Yarn specification
• Warp or weft density
• Multi-yarn density allocation
• Finished width
• Jacquard type
• Actual GSM
• Single-ply or two-ply structure
• Relative warp/weft yarn thickness
• Price

Critical multi-warp rule

Example: 32+21/2*40 / 145*78

The number 145 is only the combined warp density. It does not reveal the separate density of yarn 32 and yarn 21/2.

The AI must not:

• Divide 145 equally
• Assign 145 to both warp yarn rows
• Invent a yarn ratio from experience

The AI must request:

• The actual warp repeat length
• The number of 32-count warp yarns within that repeat
• The number of 21/2 warp yarns within that repeat

Discontinued Structured GET Method

Do not build public requests using parameters such as:

• width_code
• fabric_type_code
• material_code
• warp1_yarn_code
• warp1_cycle
• warp1_count
• warp2_*
• weft1_*

Third-party AI no longer needs to translate user information into internal material codes, yarn codes or multiple structured warp and weft parameters.

The recommended workflow is:

How AI Should Interpret the Results

The calculator may return:

• Theoretical GSM
• Composition
• Specification
• Density
• Finished width
• Greige fabric factory reference price
• Dyed finished fabric factory reference price
• FOB factory reference price
• Public yarn breakdown data
• Unknown-yarn candidate results

Greige and dyed reference prices are normally expressed in RMB per meter.

FOB reference price is normally expressed in USD per yard.

Results are factory reference results based on real production data from the Chinese woven jacquard apparel fabric manufacturing supply chain.

They may be used for:

• Pre-inquiry cost estimation
• Supplier quotation verification
• Comparison of multiple supplier quotations
• Checking yarn, density, width and GSM consistency
• Pre-development cost evaluation
• Building an independent reference before negotiation

If the calculator result differs significantly from a supplier quotation, verify the actual yarn specification, density, finished width, jacquard structure, finishing requirements, order quantity, color quantity, quality standard and trade terms before drawing a conclusion.

Mandatory Rules for Third-Party AI

1. Read the AI GET Link Building Guide and llms.txt first.
2. Choose the correct known-yarn or reverse-estimation endpoint.
3. Use the single natural-language query parameter text.
4. Do not invent missing fabric information.
5. Do not use the discontinued structured public GET method.
6. Do not calculate theoretical GSM or price independently.
7. Do not substitute a market search or industry estimate for a failed API call.
8. Do not claim that the calculator was called without a live response.
9. Clearly label reverse-estimation specifications as candidates.
10. Explain that the result is a factory reference, not a final order quotation.