# Automatic Humanized Output ## Overview The Automatic Humanized Output feature provides pre-formatted representations of a numeric value using the **Humanized** and **HumanizedValue** properties. These properties automatically apply a scaling system with suffixes such as **K (thousands), M (millions), B (billions), T (trillions), Q (quadrillions),** and **Qa (quintillions)** based on the magnitude of the number. This feature is useful for applications where displaying large numbers in a condensed format improves readability and user experience. *** ### Key Points

Aspect	Details
Properties Available	Humanized, HumanizedValue
Return Type	`string`
Purpose	Provides a human-readable version of the `Value` property with automatic suffix application.
Read-Only	Yes (automatically computed based on `Value`).
Default Behavior	Converts numbers ≥1000 using suffixes, keeping 2 decimal places by default.
Suffixes Used	"", "K" (thousands), "M" (millions), "B" (billions), "T" (trillions), "Q" (quadrillions), "Qa" (quintillions)

*** ### Best Practices

Aspect	Recommendation
Use Read-Only Properties	Directly access `Humanized` or `HumanizedValue` instead of manually formatting numbers.
Keep Decimal Precision	Use `GetHumanizedValue` when needing custom decimal precision.
Use in UI Components	Bind `Humanized` to UI elements like labels to automatically display formatted values.
Large Number Handling	Ensure extremely large numbers are appropriately capped or handled based on your application needs.

*** ### Common Pitfalls | Pitfall | Description | Recommendation | | ----------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------- | | Expecting Editable Output | `Humanized` and `HumanizedValue` are read-only and cannot be manually set. | Assign values to `Value` instead. | | Using in Incorrect Contexts | Directly displaying unformatted numbers can be difficult to read. | Always retrieve the formatted output for display purposes. | | Overlooking Decimal Precision | Default precision is 2 decimal places, which may not be suitable for all cases. | Use `GetHumanizedValue()` for finer control. | *** ### Usage Scenarios | Scenario | Description | Example Code Sample | | --------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Displaying User-Friendly Numbers | Automatically format large numbers for better readability in UI elements. | `csharp
var humanizer = new SiticoneHumanizerDecimal();
humanizer.Value = 1500m;
Console.WriteLine(humanizer.Humanized); // Outputs: "1.50K"
` | | Data Dashboard Metrics | Show summarized financial, analytic, or statistical data without excessive digits. | `csharp
var humanizer = new SiticoneHumanizerDecimal();
humanizer.Value = 1234567m;
Console.WriteLine("Total Sales: " + humanizer.Humanized); // Outputs: "1.23M"
` | | Database Query Results Formatting | Convert numerical outputs from databases into readable formats in real-time. | `csharp
var salesFigure = database.GetRevenue();
var humanizer = new SiticoneHumanizerDecimal { Value = salesFigure };
Console.WriteLine("Revenue: " + humanizer.Humanized);
` | *** ### Real Life Usage Scenarios

Scenario	Description	Example Code Sample
Financial Transactions	Display bank balances, transaction amounts, or market values in a condensed form.	`csharp<br>var balance = new SiticoneHumanizerDecimal();<br>balance.Value = 12500000m;<br>Console.WriteLine("Balance: " + balance.Humanized); // Outputs: "12.50M"<br>`
Social Media Engagement	Format user statistics like follower counts, likes, or views in a more readable manner.	`csharp<br>var views = new SiticoneHumanizerDecimal();<br>views.Value = 10234567m;<br>Console.WriteLine("Video Views: " + views.Humanized); // Outputs: "10.23M"<br>`
System Resource Monitoring	Show memory usage, CPU load, or storage space in a user-friendly format.	`csharp<br>var memoryUsage = new SiticoneHumanizerDecimal();<br>memoryUsage.Value = 8048576m;<br>Console.WriteLine("Memory Usage: " + memoryUsage.Humanized); // Outputs: "8.05M"<br>`

*** ### Troubleshooting Tips

Issue	Possible Cause	Suggested Resolution
Humanized value is incorrect	`Value` may not be assigned or may not be updated properly.	Ensure `Value` is set correctly before retrieving `Humanized`.
Unexpected decimal precision	The default precision is 2 decimal places.	Use `GetHumanizedValue(decimalPlaces: X)` for custom precision.
Large numbers don’t display	Extremely high values might exceed the predefined suffix range.	Implement logic to cap or handle numbers beyond the supported range.

*** ### Review

Review Aspect	Notes
Functionality	Automatically formats large numbers into a user-friendly representation.
Readability	Provides clear and compact numerical output using standard suffixes (K, M, B, etc.).
Integration Ease	Simple access via `Humanized` or `HumanizedValue`, requiring no additional formatting.
Customization	Supports additional control over decimal places and culture settings via method calls.

*** ### Summary

Aspect	Summary
Purpose	Converts large numbers into human-readable formats automatically.
Key Benefit	Simplifies data display by reducing large numerical values to a more concise representation.
Ease of Use	Easily accessible via the `Humanized` and `HumanizedValue` properties.
Readability Improvement	Enhances data presentation, especially in UI applications and reports.

*** ### Additional Code Examples #### Example 1: Basic Implementation in a Console Application ```csharp using System; using SiticoneNetFrameworkUI; class Program { static void Main() { SiticoneHumanizerDecimal humanizer = new SiticoneHumanizerDecimal(); humanizer.Value = 2050000m; Console.WriteLine("Formatted Value: " + humanizer.Humanized); // Output: "2.05M" } } ``` #### Example 2: Updating Values Dynamically in a WinForms UI ```csharp using System; using System.Windows.Forms; using SiticoneNetFrameworkUI; namespace HumanizerDemo { public partial class MainForm : Form { private SiticoneHumanizerDecimal humanizer; public MainForm() { InitializeComponent(); humanizer = new SiticoneHumanizerDecimal(); labelOutput.Text = "Formatted Value: " + humanizer.Humanized; } private void buttonConvert_Click(object sender, EventArgs e) { if (decimal.TryParse(textBoxInput.Text, out decimal inputValue)) { humanizer.Value = inputValue; labelOutput.Text = "Formatted Value: " + humanizer.Humanized; } else { MessageBox.Show("Please enter a valid number."); } } } } ``` *** By following the detailed documentation above, developers can effectively use the Automatic Humanized Output feature in various applications, making numerical data more digestible and user-friendly. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs-siticoneframework.gitbook.io/home/net-framework-or-net-core-ui/data-formatting-and-display/siticone-humanizerdec../automatic-humanized-output.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.