Assetalyze — Portfolio Optimizer User Manual
Detailed operating manual and specification reference — Microsoft Store version 1.0.55.0 x64
English edition: October 27, 2026
Product specification baseline: accepted Source commit a949523095fb2a24dca2784fef42e164feb86984
This manual describes features accessible through the normal interface of version 1.0.55.0. Bold interface labels follow the app’s English resources and the code that applies them. Explanations are written in English; they are not alternative names for the controls. Available controls and their enabled state depend on the selected data, conditions, and window size.
Some related screens use different English names. The main navigation item is Results. Its chart tab is Asset path. The separate Graph details window uses Asset growth as a display mode. Custom allocation has its own numbered tab, 3 Growth. These differences reflect the product interface.
This is an operating manual, not investment, tax, or legal advice. It does not guarantee profits, preservation of principal, or calculation outcomes. Read the documents available under Legal information as well.
Where to start: Read Chapters 1–8 for setup, Chapters 10–14 for input data and analysis conditions, and Chapters 16–22 for results. Read Chapters 21, 24, and 29 before deleting results, backing up data, or uninstalling. Source references, English-label verification, and unresolved external matters are recorded in the accompanying Source_Research_and_Verification_1.0.55.0_EN.md.
Contents
- Introduction
- System requirements
- Installation
- Trial and Purchased access
- Screens and navigation
- First setup
- Compute environment
- Basic settings
- Advanced settings
- Asset data
- Downloading public market data
- Registering CSV assets
- Analysis conditions
- Optimization conditions
- Running an analysis
- Results
- Asset path
- Detailed data
- Allocation comparison
- Saving results and reports
- Deleting results
- Custom allocation
- Language, currency, and appearance
- Data storage and backup
- Microsoft Store licensing
- Privacy
- Cautions and disclaimer
- Troubleshooting
- Uninstalling
- Glossary
1. Introduction
1.1 What Assetalyze does
Assetalyze compares portfolios using historical asset prices and assumptions about contributions, allocation, rebalancing, trading costs, and taxes.
- Automatic optimization: Evaluates allocation candidates for 1–10 selected assets. At each specified volatility limit, it selects a candidate that maximizes mean or median final value.
- Custom allocation: Saves allocations you specify and compares several sets using shared evaluation years.
- Results: Displays final value, XIRR, volatility, maximum drawdown, asset paths, and allocations.
- Exports: Provides table CSVs, asset-path CSVs, HTML overview reports, and PNG images from graph-detail windows.
Assetalyze does not place orders in a brokerage account. “Optimal” means best under the selected inputs, candidate set, objective, and constraints. It does not mean best for future investment decisions.
1.2 Three important distinctions
| Distinction | Meaning |
|---|---|
| Demo versus real data | The built-in demo uses fictional data. It is separate from downloaded market data and your CSVs. |
| Current settings versus saved results | Changing an input does not recalculate a previously saved result. |
| Registered assets versus selected assets | The asset library can contain more than 10 assets. Standard optimization uses the 1–10 assets checked in Basic settings. Custom allocation uses the weights in each set independently. |
2. System requirements
2.1 Supported package environment
The 1.0.55.0 package targets x64 Windows Desktop. Its declared Windows minimum version is 10.0.26200.0. This manual does not claim support for earlier builds. Check the Windows version on your PC and the installation eligibility displayed by Microsoft Store.
CPU computation is available. A compatible NVIDIA GPU can accelerate candidate search when the required driver and runtime are available. Use Compute environment to check the actual machine. The presence of an NVIDIA GPU alone does not establish runtime readiness.
The Store package includes its product runtime. Normal use does not require creating a development Python environment or changing packages with pip.
2.2 Workload, memory, and disk space
Time, memory, and disk requirements depend on asset count, history length, allocation step, rolling periods, and output settings. Finer allocation steps can increase the search dramatically: 10 assets with a 5% step produce 10,015,005 candidate allocations.
No fixed minimum RAM amount, universal GPU model list, or guaranteed completion time is specified here. Consult the app’s diagnostics and recommendations for the current PC.
The interface supports resizing and maximizing. At Windows scaling of 100%, 125%, and 150%, use available scrolling and table-column paging when the screen is small.
3. Installation
3.1 Installing from Microsoft Store
- Open Assetalyze — Portfolio Optimizer in Microsoft Store. The product ID is
9NDJXCCWG6D2. - Review the price, availability, and terms displayed by Store, then install the app.
- Launch Assetalyze from the Windows Start menu.
- Complete the language/currency and legal-document steps described in Chapter 6.
Purchases and payments take place through Microsoft Store. This manual does not establish a price, refund policy, or regional availability.
3.2 Identifying the version
This manual applies to Store package version 1.0.55.0. An internal release label such as RC1.275 is a separate identifier.
For technical identification, the Package Identity Name is YuInvestudy.AssetalyzePortfolioOptimizer. The Package Family Name (PFN) is YuInvestudy.AssetalyzePortfolioOptimizer_v52yw7agrk5ve. Users do not need to edit these values.
3.3 Updating versus reinstalling
A normal update within the same package family is different from uninstalling and reinstalling. Back up settings and registration information as well as results if they must be retained. Do not start troubleshooting by uninstalling or clearing all data; see Chapters 24 and 29 first.
4. Trial and Purchased access
4.1 Available operations
| Operation | Unlimited Trial/free access | Valid Purchased access |
|---|---|---|
| Analyze the genuine built-in fictional demo | Available | Available |
| View, export, and resume genuine demo results | Available | Available |
| Inspect a personal CSV for compatibility | Inspection only | Available |
| Register a personal CSV in the asset library | Purchase required | Available |
| Analyze or recalculate real data | Purchase required | Available |
| Use saved real-data results, resume them, or use their calculation cache | Purchase required | Available |
| Download public market data | Purchase required | Available |
Only data the product recognizes as its genuine demo qualifies as demo data. Renaming a personal CSV or changing its settings to say “demo” does not make real-data analysis part of the free demo.
4.2 Starting from Home
- Try the built-in demo starts the fictional-data workflow.
- Free CSV compatibility check inspects readability, columns, dates, and numeric values. A successful check does not register an asset.
- Buy in Store opens the Microsoft Store purchase workflow.
The Assetalyze — Unlimited Trial heading describes the trial offer. Read the separate License: Purchased, Trial (no time limit), or other license-state display to determine the current entitlement.
4.3 Limits of the free CSV check
Readable means the selected CSV passed the relevant readability checks. It does not guarantee sufficient history, overlapping dates with other assets, complete FX data, or success with every analysis condition. The inspection-only operation does not change or upload the original CSV, register an asset, optimize real data, or calculate its investment performance.
Other compatibility outcomes include Review required and Cannot read. Follow the preview and format guidance in Chapter 12.
5. Screens and navigation
5.1 Main screens
| English interface label | Purpose |
|---|---|
| Home | Workflow, demo, CSV compatibility check, and license status. |
| Compute environment | CPU/GPU readiness, performance settings, and diagnostics. |
| Basic settings | Assets, input data, cash flows, optimization, constraints, and costs. |
| Advanced | Output, language/currency, appearance, and maintenance. |
| Run | Start, stop, resume, and monitor an analysis. |
| Results | Select completed results and inspect charts, metrics, and tables. |
| Custom allocation | Evaluate and compare saved fixed-allocation sets. |
| Legal information | Disclaimer, privacy, license documents, third-party notices, and consent. |
| Run log | Processing messages and error details. |
The How to use / Guide actions open bundled help documents. A ? control opens help for the associated feature. For wide tables, use scrolling, column paging, or the full-row detail view.
5.2 Tabs and nested views
| Screen | Tabs or view choices |
|---|---|
| Basic settings | Assets & Data; Simulation 1 — Investment & optimization; Simulation 2 — Constraints & costs |
| Advanced | Output; Language & currency; Maintenance |
| Results | Dashboard; Asset path; Detailed data |
| Results → Detailed data | Details by Vol; Statistics by period; Allocation comparison, selected through Display item |
| Custom allocation | 1 Allocation; 2 Run; 3 Growth; 4 Details |
Allocation comparison is a view within Detailed data, not a separate fourth Results tab. The custom-allocation 4 Details tab is separate from the normal Results Detailed data tab.
6. First setup
6.1 Initial sequence
- In Assetalyze — First setup, choose Display language and Valuation currency.
- Select Start with these settings.
- In Review legal documents, read the EULA, Privacy, Disclaimer, and Third-party notices. Select Agree and continue if you agree. Exit without agreeing ends the process without acceptance.
- Open Compute environment if the environment has not been confirmed.
- Use Set up and verify automatically.
- Select Continue to Basic settings →, then prepare assets and conditions.
- Review Advanced → Output, then proceed to Run.
Language and currency can be changed later under Advanced → Language & currency. The normal startup flow does not require the retired guided-setup wizard retained in older source definitions.
6.2 Trying fictional data first
Use Try the built-in demo on Home or Apply demo settings in Basic settings. Check the fictional/demo-data indication before interpreting results.
Return to real data uses the supported path for returning from demo settings. After returning, verify the selected assets, amounts, valuation currency, and periods before running a real-data analysis. Do not assume the demo inputs describe your actual portfolio.
7. Compute environment
7.1 Automatic setup
Open: Main navigation → Compute environment.
- Under Compute method, select Automatic (recommended).
- Click Set up and verify automatically.
- Review the CPU, RAM, GPU, runtime, and recommended-method information.
- Once confirmed, click Continue to Basic settings →.
If GPU operation is unavailable, CPU computation remains an available path. If GPU was selected explicitly and verification fails, follow the displayed diagnostic result and review the selected compute method. A material hardware/runtime change can require confirmation again.
7.2 Compute methods
| Choice | Meaning |
|---|---|
| Automatic (recommended) | Chooses an available method using the environment diagnosis. |
| GPU | Uses a supported NVIDIA GPU for candidate search. Winning candidates are rechecked through CPU exact evaluation. |
| CPU | Computes on the CPU without requiring the GPU execution environment. |
GPU search is an acceleration path, not a setting that omits final numerical verification. Custom allocation evaluates fixed portfolios using CPU exact and does not perform the standard GPU candidate search.
7.3 Performance controls
The Mode choices are Power saving, Standard (recommended), High performance, Maximum performance, and Manual. They adjust processing batches, working memory, parallelism, and checkpoint frequency. They do not change the optimization objective or remove final CPU exact checks.
| Control | Meaning and caution |
|---|---|
| CPU batch / GPU batch | Number of candidates processed together. Larger batches can require more working memory. |
| CPU workers | Limit on CPU-side parallel workers. |
| CPU working memory / GPU working memory | Working-memory limits, particularly relevant to median calculations. These are not the PC’s total RAM/VRAM. Values are in MiB. |
| checkpoint | Candidate-count interval for saving resumable progress. |
| GPU device ID | Identifies the GPU to use. Match it to the environment diagnosis. |
| Measure performance | Measures the current PC to obtain recommended settings; it uses CPU/GPU resources while running. |
| Copy standard recommended values | Applies the displayed standard recommendations to performance inputs. Despite “Copy,” this is not a text-copy-to-clipboard operation. |
Use automatic setup and a preset mode first if you are unsure about manual values.
7.4 Individual diagnostics
Expand Details / troubleshooting when needed.
| Action | Purpose |
|---|---|
| Run diagnostics only | Checks current runtime readiness separately from performance measurement. |
| Recheck MSIX runtime | Checks the runtime included with the Store package. It does not replace it with a development Python installation. |
| Recheck GPU runtime | Checks GPU/runtime readiness and reports the detected state. |
Diagnostics and measurements can save associated information. Opening a screen and actively running a diagnostic are different operations.
8. Basic settings
8.1 Assets & Data
Open: Basic settings → Assets & Data.
Check the assets to include in standard optimization. The limit is 1–10 checked assets, independently of the number registered in the library.
| Action | Purpose |
|---|---|
| Select all / Clear all | Changes the analysis checkboxes together. The 10-asset run limit still applies. |
| Auto-download market data | Opens supported public-data acquisition and registration. |
| Add cash asset | Adds cash in another supported currency. |
| Add CSV asset | Reviews and registers a price CSV. |
| Create leveraged asset | Generates a synthetic leveraged series from daily input data. |
| Edit selected asset | Reviews or changes editable asset metadata and data status. |
| Delete selected asset | Removes an asset registration; this is separate from deleting an analysis result. |
| Configure dividends/distributions | Defines price interpretation and dividend inputs. |
| Manage reference data | Manages FX and interest-rate data. |
| Export selected asset CSV | Exports input asset data rather than analysis statistics. |
Review each asset’s period, dividend interpretation, and source. Combining assets with different histories can shorten the usable overlapping period.
8.2 Data modes
| Choice | Behavior |
|---|---|
| Hybrid (recommended) | Uses registered local data and the corresponding supported official source when data is missing. |
| Local only | Does not fetch calculation data over the network. Required prices, FX, and rates must already be available. |
| Auto-download only | Uses supported downloadable data. It is not an arbitrary ticker-download service. |
| Demo | Uses a separate fictional-data mode. |
Local only does not disable Microsoft Store license communication. Calculation-data access and entitlement checks are separate.
8.3 Moving to conditions
Use Simulation 1 — Investment & optimization for amounts, periods, and search settings. Use Simulation 2 — Constraints & costs for volatility limits, costs, taxes, rebalancing, and dates. Valid input changes are normally saved automatically. An invalid value or save-error message means you must resolve the issue rather than assume the change was saved.
9. Advanced settings
9.1 Output
Open: Advanced → Output.
| Output level | Effect |
|---|---|
| Standard (recommended) | Keeps normal result viewing/basic outputs and limits additional per-window output. |
| Detailed | Adds per-period summary CSV output. |
| All | Enables per-period summaries, asset-path CSVs, charts, and 100% asset comparisons. |
| Custom | Lets you choose output types and the range of windows to export. |
| Do not output | Suppresses automatic user-facing CSV/HTML/PNG output. Internal files needed for result viewing and replay still exist. |
For custom output, Per-period choices include Do not output, Best / median / worst, Best 5 / worst 5, and All periods. Output types include Period summary CSV, Asset path CSV, Per-period charts, and 100% asset comparison. The last compares portfolios with 100% invested in a single asset.
All periods can produce thousands of files. Output settings change saved artifacts, not the candidate-search objective or winning allocation.
9.2 Language & currency
This tab controls display language, valuation currency, theme, and highlight color. Chapter 23 explains the consequences of currency changes. Appearance settings do not change calculations.
9.3 Maintenance
| Action | Scope and caution |
|---|---|
| Open user data | Opens the actual input/results storage location. Use it to locate data before backup. |
| Reset app state | Resets settings, diagnostics, performance measurements, and caches. It preserves input files and results in the user-data area, but registration/settings information still needs backup. |
| Permanently delete all data | Deletes current application state and application-managed user data after two confirmation stages. This is not the single-result Recycle Bin operation. |
Do not use reset or permanent deletion as the first response to an ordinary error. Permanent deletion has no in-app undo and may leave a partially deleted state if an error occurs. Original CSVs, older storage locations, and backups outside the current managed roots are not all deleted by this action.
10. Asset data
10.1 Prices and currencies
Price CSVs provide dates and prices. Normal analysis uses monthly series; daily-data input paths use the last observed value within each month. Confirm whether the input contains ordinary closing prices or adjusted/total-return prices.
Specify the currency explicitly. Display language, file names, and currency symbols are not substitutes for selecting the correct currency. Assets in another currency need suitable historical FX data.
10.2 Cash assets
Cash for the valuation currency is shown in the asset list. Use Add cash asset for other supported currencies.
A cash series represents one unit of its own currency with a nominal 0% return in that currency. Foreign cash is converted using the required FX series. It is not a simulation of the interest, fees, or terms of a particular bank deposit.
10.3 Editing and removing assets
- Select an asset row and click Edit selected asset.
- Review its source, period, currency, analysis inclusion, and managed-CSV status.
- Change editable fields and click Save.
CSV asset names are fixed to preserve their relationship with settings and results. Downloaded/generated assets can also have fixed source or currency fields because these belong to their generation conditions.
If a managed CSV changes after registration, analysis may stop for safety. Use Approve CSV change only after reviewing the actual change. Removing an asset registration is different from unchecking it for the next run. Keep the original input CSV separately from the managed copy.
10.4 Dividends and distributions
Open: Basic settings → Assets & Data, select an asset, then Configure dividends/distributions.
| Choice | Meaning |
|---|---|
| Price / Close (dividends entered separately) | Treats prices as excluding separately supplied dividends. |
| Adjusted / Total Return (dividends included) | Treats the price series as including dividends. Avoid adding them again. |
| No dividends | Adds no separate dividend input. |
| Separate CSV (date + dividend) | Uses a reviewed CSV of dividend dates and amounts. |
| Annual dividend yield | Uses an annual-yield assumption rather than an actual payment history. |
| Dividend column in price CSV (legacy) | Uses a specified dividend column in the price file. |
Check currency, per-share/per-unit amounts, units, ex-dividend dates, and split adjustments. Dividend tax and payment handling are separate settings in Simulation 2. Holding dividends as cash requires unadjusted prices.
10.5 Synthetic leveraged assets
Open: Basic settings → Assets & Data → Create leveraged asset.
- Select the underlying daily price CSV and verify dates, prices, and currency.
- Choose a preset and a name for the generated asset.
- Review the model, leverage, expenses, and funding assumptions.
- Click Create and check the registered series.
Presets include custom and generic 2x/3x models, TQQQ dedicated (calibrated model), and QLD dedicated (calibrated model).
| Input | Interpretation |
|---|---|
| Leverage multiple | Multiplier applied to daily underlying changes, not simply to the total-period return. |
| Expense ratio (% p.a.) and other drag | Annualized expense assumptions used by the daily model. |
| Funding | Fixed-rate funding or funding based on DFF. |
| Fixed funding rate (% p.a.) and funding spread | Assumptions about financing costs. |
| Underlying dividend yield | Assumed dividend return for the underlying series. |
| Calibrated funding multiplier, Calibrated net carry (% p.a.), Calibration reference expense (% p.a.) | Model-specific calibration inputs. Some calibrated-preset values are fixed. |
The result is a daily-reset synthetic series, not actual ETF NAV or market-price history. The dedicated presets do not turn arbitrary inputs into a reconstruction of TQQQ or QLD. Their expected underlying USD daily data and funding inputs matter.
11. Downloading public market data
11.1 Supported catalog
Open: Basic settings → Assets & Data → Auto-download market data.
The catalog includes World Bank Gold, Silver, Brent, WTI, Copper, Natural Gas (US), Aluminum, and Platinum. It also includes a US 10-year Treasury series derived from Federal Reserve DGS10. Review the source, currency, usage information, and registration status for each row.
The Treasury series is an approximate total-return index derived from yields, not the actual price history of a particular ETF or bond holding. This catalog is not a general search for S&P 500, NASDAQ-100, individual stocks, or arbitrary ETFs.
11.2 Adding and refreshing data
- Confirm that the license display is Purchased.
- Select a catalog item and review its source, currency, and terms.
- Click Add selected.
- After acquisition finishes, check the asset’s name, period, and source in Basic settings.
- Check it in the asset list if it should participate in standard analysis.
Downloaded data is stored in local caches and managed copies. Use Refresh selected for a registered catalog item or Refresh market data in the asset editor to update it. These are data-writing operations; back up an input version first if you need to reproduce an earlier run exactly.
Downloads can fail because of connectivity, provider changes, or insufficient history. Supported acquisition does not guarantee uninterrupted external service. Resolve a license error before diagnosing the market-data provider.
11.3 FX and interest-rate reference data
Use Manage reference data for FX pairs and interest rates. Federal Reserve H.10 supplies the supported standard-currency FX data. DFF provides an interest-rate reference.
| Action | Use |
|---|---|
| Add FX data | Specifies BASE and QUOTE currencies and registers a CSV. |
| Register / replace CSV | Creates or updates the managed data for a series. |
| Export CSV | Saves the selected data to an external file. |
| Remove registration | Removes the reference-data registration. |
| Return to automatic download | Returns a supported series to automatic acquisition. |
| Refresh | Reloads the displayed state. |
An FX value is QUOTE units per 1 BASE unit. For example, USD/JPY = 150 means 1 USD = 150 JPY. Check the direction during registration. Conversion can resolve inverse or multi-pair routes, but this does not correct wrongly interpreted CSV values.
Depending on the series, use automatic acquisition, CSV-only handling, or hybrid handling with CSV preference and automatic completion. For an annual percentage rate, 5 means 5% per year; 0.05 is not automatically interpreted as 5%. DGS10 and DFF are different rate series.
12. Registering CSV assets
12.1 Preparing the file
Provide a date column and a price column. A clear interchange format uses ISO dates (YYYY-MM-DD), a decimal point, and no thousands separators. If conversion is necessary, prepare a separate copy and preserve the original.
Date,Price
2024-01-31,100.00
2024-02-29,101.25
2024-03-31,99.80
This short example illustrates format only; it does not provide enough history for a multi-year analysis. Choose the currency in the registration dialog.
Supported read paths also include CSV.GZ/GZ and a safely structured ZIP containing exactly one CSV/TXT member. This is not an Excel-workbook importer.
12.2 Registration steps
- Select Basic settings → Assets & Data → Add CSV asset.
- Choose the original CSV.
- In Review CSV import, check Asset name, Currency, Date column, and Price column.
- Click Load and preview.
- Compare the preview with the original. Check dates, prices, period, row count, invalid rows, and duplicates.
- Complete the confirmations for dates/period and prices/decimal format/currency/price units/notices.
- Click Register reviewed data.
- Check the asset in the library and configure dividends if necessary.
The file and review conditions are checked again before registration. Changing an import choice after preview requires another preview and confirmation.
12.3 Import controls
| Control | Meaning |
|---|---|
| Asset name | Library identifier. Avoid conflicts with existing assets. |
| Currency | JPY, USD, EUR, GBP, AUD, CAD, SGD, or CNY. It is not inferred automatically. |
| Date column / Price column | Two distinct columns providing dates and prices. |
| Encoding | Automatic detection or supported encodings such as UTF-8, UTF-16 with BOM, CP932, Windows-1252/1250, GB18030, Big5, and CP949. |
| Delimiter | Automatic detection, comma, semicolon, or tab. |
| Records to skip at start / Records to skip at end | Excludes introductory records or trailing notes. |
| Date order | Review automatic detection or the appropriate year/month/day, day/month/year, month/day/year, or supported ROC-year format. |
| Decimal separator | Automatic detection, point, or comma. Do not confuse decimals with digit-grouping separators. |
| Security | Selects one security from a supported multi-security CSV. |
Open Advanced in the import dialog for the less frequently used controls. Empty/duplicate column names, mixed formats, unequal row lengths, or ambiguous dates/numbers require review. Do not put currency symbols or a percent sign that does not represent a price into the price column.
12.4 Managed copies and change detection
Registration uses a reviewed managed copy and metadata, rather than continuously treating the original CSV as an editable live input. The current review workflow creates a normalized CSV and a review record. Registration information is kept in custom_assets.json; managed files are stored under locations such as input\custom_assets.
Keep the original CSV. Editing the managed CSV externally can cause a hash mismatch. Use the supported review, replacement, or approval workflow for an intended change. A .review.json record documents import choices and user confirmation; it does not certify the economic correctness of the data.
13. Analysis conditions
13.1 Cash flows and evaluation periods
Open: Basic settings → Simulation 1 — Investment & optimization.
| Input | Meaning and validation |
|---|---|
| Initial investment | Amount invested once in the first observed month of each evaluation window. Must be zero or greater. The label shows the valuation-currency unit. |
| Monthly contribution | Amount invested every month, including the first observed month. Must be zero or greater. |
| Rolling periods (up to 3) | Up to three different periods of 1–100 years. Data must cover the selected periods. |
Initial investment and monthly contribution cannot both be zero. Zero initial investment means contribution-only investing; zero monthly contribution means a lump sum without later regular contributions. Amounts use the selected valuation currency.
A 10-year rolling period evaluates many 10-year windows with different start months. It does not refer to just one selected decade.
13.2 Constraints and costs
Open: Basic settings → Simulation 2 — Constraints & costs.
| Input or option | Meaning and caution |
|---|---|
| Vol limit start (%), Vol limit end (%), Vol step (%) | Range of risk constraints to evaluate. Start and step must be positive; end must not be below start. |
| Trading cost (% / one way) | One-way transaction-cost assumption used by the simulation. |
| Capital-gains tax rate (%) | Model tax on realized gains; not a substitute for actual tax accounting. |
| Dividend/distribution tax rate (%) | Tax assumption for dividend/distribution receipts. |
| Dividend payment handling | Reinvest after receipt, Hold as cash (do not reallocate), or Hold as cash; allocate at scheduled rebalance. |
| Rebalance | Compare (none / periodic), No rebalancing, or Periodic rebalancing. |
| Rebalancing interval (months) | Number of months between scheduled rebalances; at least 1. |
| Start date (YYYY-MM-DD / blank) / End date (YYYY-MM-DD / blank) | Restricts historical input dates. Blank means no additional restriction from that field. |
| Rolling start-step (months) | Months by which the next evaluation window’s start advances. |
| Offset realized gains and realized losses within the same rebalance | Offsets modeled realized gains/losses within one rebalance. It does not reproduce every tax rule for a real account. |
Vol is a measure of return variability. A Vol limit constrains the optimization; it is not a guarantee of the maximum future loss. See Chapter 30 for definitions.
13.3 How fees and taxes affect metrics
Final value and XIRR include deductions for rebalancing transaction costs and realized-gains tax. TWR, Vol, and maximum DD use monthly returns measured before the current contribution and rebalancing. They therefore exclude the direct deduction of that month’s rebalancing costs and tax.
Earlier costs and taxes can still affect subsequent balances. Do not interpret Vol or maximum DD alone as a complete measure of after-tax, after-cost profit. Read them together with final value and XIRR.
14. Optimization conditions
14.1 Allocation step
In Simulation 1 — Investment & optimization, choose an Allocation step of 5%, 10%, 20%, 25%, or 50%. Candidate weights total 100%.
A finer grid means more candidates and often substantially more work. It does not guarantee better future performance.
14.2 Optimization metric
| Choice | Candidate selected |
|---|---|
| Maximize mean final value | Maximizes the arithmetic mean of final values across rolling windows. Extreme windows can influence the mean. |
| Maximize median final value | Maximizes the median final value across rolling windows. With an even number of windows, the median is the average of the two middle values. |
Both operate under the Vol constraint. Neither is a direct “maximize XIRR” objective. Median search can require more working memory and time than mean search.
14.3 Standalone and robust optimization
- Optimize each period separately selects an allocation for each chosen period independently.
- Robust multi-period optimization combines periods using scores normalized against each period’s best value. The primary ranking uses mean score; the secondary ranking uses the minimum period score.
Both can be enabled. A standalone 10-year allocation and a robust allocation combining 10, 20, and 30 years answer different questions. Their allocations can differ at the same Vol limit. Robust scores are relative scores, not returns or probabilities.
14.4 Testing a fixed allocation
Use Custom allocation when you want to test specific weights. See Chapter 22. The hidden fixed-allocation controls retained in older normal-settings code are not an additional user workflow in this manual.
15. Running an analysis
15.1 Starting a new run
- Confirm the Compute environment.
- In Basic settings, review assets, input data, currency, contributions, periods, and optimization conditions.
- Review Advanced → Output.
- Open Run and click Start simulation.
- Enter a run name when prompted, or leave it blank. The name is appended to the result-folder name.
- Monitor processing stages, progress, elapsed time, and estimated remaining time.
- When complete, open Results, or use Go to Results → where shown.
A new run creates a new result folder. It does not overwrite a selected previous result merely because the conditions are similar. Remaining-time estimates are progress indicators, not guaranteed completion times.
15.2 Stopping and resuming
| Action | Behavior |
|---|---|
| Stop | Requests a stop. The engine saves resumable state when it can do so. |
| Resume | Continues paused data when the current settings match the saved stop-point settings. |
| Restore stopped-run settings | Restores the stopped run’s settings into the current inputs; this changes the inputs you are editing. |
| Clear paused data | Removes resume data. It is not the Recycle Bin operation for one completed result. |
After requesting a stop, wait for the save/stop status instead of immediately terminating the process. Resume may recompute some work; it is not a guarantee of continuation from the very next instruction after the saved point.
If settings differ, read the reason resume is unavailable. The supported workflow warns about editing settings while paused data exists. Recovery guidance may also appear after an abnormal interruption. Check the selected record and location; do not edit internal state JSON to force it to become resumable.
15.3 Run log and normal exit
Read Run log and the displayed message when an operation fails. Logs can contain asset names and local paths; inspect them before sharing.
Close the app using the normal window-close operation. If a task is running, follow the prompt about stopping and exiting. Avoid forced termination while files are being saved.
16. Results
16.1 Selecting a completed result
Open: Main navigation → Results.
- Select a completed run in the Result dropdown.
- Check the result ID, run name, and conditions.
- Switch among Dashboard, Asset path, and Detailed data.
Refresh reloads the result list. It does not run a new analysis or refresh market prices. After choosing another result, also review period, rebalancing, and Vol selections.
16.2 Result toolbar
| Action | Effect |
|---|---|
| Refresh | Reloads available results. |
| Delete selected result | Moves the selected completed result folder to Windows Recycle Bin. See Chapter 21. |
| Overview report | Opens the selected result’s existing HTML analysis overview. |
| Result folder | Opens that result’s folder. |
| Save CSV | Exports the table selected in Detailed data. Asset-path CSV has a separate button inside Asset path. |
16.3 Dashboard metrics
Choose Displayed Vol, Period, and Rebalance to compare a consistent set of conditions.
| Display | Meaning |
|---|---|
| Selected volatility limit | Constraint used when selecting the allocation, distinct from realized Vol. |
| Mean final value | Mean ending value across the applicable rolling windows. |
| Mean XIRR (annualized) | Aggregation of annualized returns that account for cash-flow timing. |
| Mean realized volatility | Mean historical variability measured for the evaluation windows. |
| Mean max DD | Mean of the individual windows’ maximum drawdowns. |
| Worst max DD | Most severe maximum drawdown among the applicable windows. |
| BEST / MEDIAN / WORST | Representative windows selected by final value, not forecasts of future best/typical/worst outcomes. |
Click a point on the risk/return chart to change the displayed Vol limit. The allocation display and metric cards should be read with their selected conditions. An all-conditions view can include more points than an individual-condition view.
16.4 Scatter-plot Graph details
Click Graph details on Dashboard to open the XIRR versus mean-Vol scatter plot in its own window. Hover near a point to inspect the associated Vol limit, Realized Vol, and XIRR. Resize or maximize the window and use Save PNG if needed.
This opens a Scatter plot. It is not the three-mode asset-growth/drawdown viewer described in Chapter 17.
16.5 No results
No completed runs, including after deletion of the last result, is a supported No results state. Results tabs do not retain an old result ID, KPI, graph, or detailed row as if it were current. Actions requiring a result are disabled or provide a safe no-result message.
After a new analysis completes, its result appears in the list and the views become available. Do not invent a folder reference in latest.json to fill an empty state.
17. Asset path
17.1 Choosing conditions and dates
Open: Results → Asset path.
- Select the completed Result to inspect.
- Review Rebalance, Vol limit, Allocation to use, and Years.
- Choose Latest, BEST, MEDIAN, WORST, or Custom for the period.
- For Custom, select Start and End, then click Display.
- Inspect the asset value, cumulative principal, drawdown, and metric cards.
| Period choice | Interpretation |
|---|---|
| Latest | An evaluation period at the latest end of the available history. |
| BEST | A representative period with the best final value for the selected allocation/evaluation conditions. |
| MEDIAN | A representative period near the median final value. |
| WORST | A representative period with the worst final value. |
| Custom | The start/end year-month range you specify. |
This is an ex-post simulation applying an already selected fixed allocation to the chosen period. It does not imply that the allocation could have been known at that period’s start. Changing this display is different from running optimization again.
17.2 Reading the chart
- Portfolio value is the evaluated asset value at that time.
- Cumulative principal is the initial investment plus contributions made so far.
- Gain / loss is the difference between value and contributed principal.
- Drawdown expresses a fall from a preceding peak.
- XIRR, realized Vol, and maximum DD should be read with the cost/tax distinctions in Chapter 13.
Hover over a graph to inspect dates and values. Amounts use the saved result’s valuation currency. Changing the current settings currency does not recalculate the old result in another currency.
17.3 The independent Graph details window
- Click Graph details.
- In Display, choose Asset growth, Drawdown, or Stacked.
- In Stacked, drag the divider to change the relative heights. The initial target is approximately 75% asset growth and 25% drawdown, subject to minimum panel heights.
- Resize, maximize, or restore the window for a suitable viewing area.
- Use the vertical guide and hover values to inspect Portfolio value, Cumulative principal, and drawdown.
- Click Save PNG and choose a destination to export the image.
The graph redraws for its display size. If the same detail window is already open, opening it again reuses it, updates it with the evaluated data available at that moment, and brings it forward. Switching modes, resizing, or saving a PNG does not rerun optimization.
PNG output matches the chosen mode. Stacked output reflects the current divider ratio. Export CSV when you need reusable numerical values.
18. Detailed data
18.1 Choosing a table
Open: Results → Detailed data.
Select Period and Rebalance, then choose Display item.
| Choice | Purpose |
|---|---|
| Details by Vol | Selected candidates and performance for each Vol limit. |
| Statistics by period | Statistics for the allocation at each rolling horizon. Robust results can show CPU exact statistics by year count for the same fixed allocation. |
| Allocation comparison | Asset weights across Vol limits under the same period and rebalancing conditions. |
18.2 Columns, full-row details, and copying
Use horizontal scrolling or Previous columns / Next columns when the table is wider than the window. A column outside the current page still exists.
Use All fields of selected row to inspect a complete row. Supported tables also open the detail dialog by double-clicking a row or pressing Enter. The full-row dialog includes fields outside the current column page and allows row navigation. Copy all fields copies the full detail representation. Cells can also be selected and copied with Ctrl+C.
The Results toolbar’s Save CSV exports the selected table. It is different from the CSV of dated asset values produced inside Asset path.
18.3 Understanding aggregates
Means, medians, and worst values summarize data differently. Mean max DD averages the maximum drawdown calculated separately for each window. It is not the maximum drawdown of one long concatenated history. A robust score is a relative selection score, not a return or probability of profit.
19. Allocation comparison
Open: Results → Detailed data → Display item → Allocation comparison.
- Select a completed result.
- Match the period and rebalancing method you want to inspect.
- Choose Allocation comparison.
- Compare each asset’s weight across the Vol-limit columns.
- Use column paging/scrolling for wide data, or Save CSV to export it.
This table compares allocations selected at different Vol limits within the same run. It does not make results from unrelated conditions directly comparable or provide a future investment recommendation.
For comparison of several allocations you design yourself, use Custom allocation.
20. Saving results and reports
20.1 Automatically saved results
Normal analysis saves run state, settings, and display/replay data in a result folder for each run. Depending on output settings, it also saves CSV, HTML, and image outputs. Use Result folder to locate the selected run.
Do not output suppresses automatic user-facing exports; it does not remove every internal file needed to view results.
20.2 Export controls
| Location | Exported content |
|---|---|
| Results toolbar → Save CSV | The Details by Vol, Statistics by period, or Allocation comparison table currently selected in Detailed data. |
| Results → Asset path → Save CSV | The displayed period/allocation’s dated values, principal, drawdown, and asset-level values. |
| Custom allocation → 3 Growth → Save CSV | Evaluated paths for comparison sets, including the amounts actually used. |
| Custom allocation → 4 Details → Save CSV | The selected Metric comparison or Rolling statistics table. |
| Graph details → Save PNG | Image for the current display mode, including the current divider ratio for Stacked. |
| Basic settings → Export selected asset CSV | Input asset data rather than result statistics. |
Check the file name and destination in the normal save dialog. Confirm before replacing an existing export. Result-table CSV export is not limited to whichever columns happen to fit on the current screen page.
20.3 Overview report
Overview report opens the selected run’s existing 分析概要レポート.html. The on-disk filename remains this literal name; the English button is Overview report.
The HTML summarizes calculated statistics. It does not perform a new optimization or forecast. If the chosen output settings did not create the HTML, the app displays guidance instead.
A highlighted condition such as the highest mean XIRR is a comparison within that run’s results, not a trading recommendation. The report is structured without external scripts, CDNs, web fonts, or analytics tags.
20.4 Sharing exports
Run names, asset names, CSVs, and logs can contain personal information. Review them before sharing. The data provider’s attribution/usage terms and your rights to imported CSVs still apply.
21. Deleting results
21.1 What is moved
Open: Results toolbar → Delete selected result.
The operation moves the entire selected individual completed-result folder to Windows Recycle Bin. It includes that run’s CSV, JSON, HTML, graphs, and replay data.
It does not delete the whole results root, the shared results\system area, other result folders, original input CSVs, managed asset CSVs, market data, settings, or custom-allocation sets.
21.2 Procedure
- Select the target in the Result dropdown.
- Check the result ID, run name, and whether needed exports have been saved elsewhere.
- Click Delete selected result.
- In Delete analysis result, review the target ID, folder, and scope.
- Choose Move to Recycle Bin only if the target is correct. Choose Cancel to leave it unchanged.
- Review the refreshed list and the result now displayed.
Deletion is unavailable during relevant processing, when no valid target is selected, or when folder safety cannot be established. It is separate from stopping/resuming an incomplete run.
21.3 Recycle Bin and safety
This uses the standard Windows Recycle Bin. If recycling fails, the app does not fall back to permanent deletion. Read the failure message and check the target/storage state.
Unsafe targets are rejected, including a parent root, the shared system area, paths outside the result root, traversal attempts, and paths with unsafe reparse points such as links/junctions. Do not edit folders or internal JSON to bypass these checks.
Windows may allow restoration while the item remains in Recycle Bin. Assetalyze has no dedicated undo-result-deletion button. Restoration depends on Windows retaining the item. After restoring through Windows, use Refresh and select the result explicitly. The previous latest selection is not guaranteed to be restored automatically.
21.4 Latest selection and the last result
If the removed result was referenced by latest management information, the app selects another remaining completed result. After the last result is removed, it does not leave a latest/backup reference to the deleted folder.
The resulting no-result state supports Dashboard, Asset path, Detailed data, and Allocation comparison navigation, normal exit, and restart. Related actions are disabled or provide safe no-result guidance. Old KPIs, graphs, details, and result IDs are cleared.
22. Custom allocation
22.1 Purpose
Open: Main navigation → Custom allocation.
This evaluates saved fixed allocations with CPU exact calculations. It does not search for optimal weights. It uses the current asset library independently of the standard-analysis checkboxes. A set can contain at most 10 assets with weights greater than 0%.
22.2 Creating and editing sets in 1 Allocation
- In Create allocation (assets added in Basic settings), enter the weights for assets you want to use.
- Leave unused assets at 0% and make the total exactly 100%.
- Enter Initial investment and Monthly contribution. Each set can have different amounts, but both cannot be zero.
- Set rebalancing and its month interval.
- Specify a set name and click Add for comparison.
- In Comparison allocation sets, check Compare for the sets to evaluate.
- Click Next: Run.
| Action | Effect |
|---|---|
| Load optimal allocation | Loads the currently selected winning allocation from Results into the editor. Requires a suitable result. |
| Clear | Clears the allocation inputs, not the entire saved-set list. |
| Allocation details | Opens the selected set’s asset names and weights. |
| Edit | Loads the selected set’s weights, amounts, rebalancing, interval, and name into the editor. |
| Save changes | Updates that same set. |
| Cancel | Discards the edit and returns to new-set entry. |
| Duplicate | Creates a separate set from the selected one. |
| ↑ Up / ↓ Down | Changes set order. |
| Delete | Removes the selected allocation set; it does not recycle a normal analysis-result folder. |
Selecting a row alone does not overwrite the editor; use Edit. Set changes are saved persistently. Saving identical content avoids unnecessary writes and backup rotation. Merely starting an evaluation does not rotate the saved-set backup.
22.3 Evaluating in 2 Run
- Check that the intended comparison sets are listed as evaluation targets.
- Choose the shared Years.
- Enable Calculate rolling stats if needed.
- Select Latest, BEST, MEDIAN, WORST, or Custom for the display period.
- For Custom only, specify start/end year-month values.
- Click Run evaluation. Completion opens 3 Growth automatically.
The shared years apply to all comparison sets, paths, rolling statistics, and representative periods. They are independent of the rolling-period selection in Basic settings. If available data causes an adjustment, check the years actually used in the results.
Prices, valuation currency, trading costs, capital-gains tax, and loss-offset conditions use the relevant current shared settings. Distinguish these from each set’s own amounts, weights, and rebalancing settings.
Changing a period or input does not overwrite an existing evaluation. Read the changed-condition guidance and click Run evaluation to apply the new conditions. There is no separate apply-display-period button in this workflow.
22.4 3 Growth
The tab displays each evaluated set’s asset path and drawdown, with the upper growth chart given more space. Hover to inspect set names, dates, and values.
Save CSV exports the evaluated series and each set’s actual initial investment/monthly contribution. Graph details provides Asset growth, Drawdown, and Stacked modes, divider adjustment, resizing, and PNG export.
22.5 4 Details
Use Result to display to choose a table.
| Choice | Content |
|---|---|
| Metric comparison | Actual amounts, evaluation period, rebalancing, final value, gain/loss, XIRR, maximum DD, realized Vol, trading costs, taxes, and related fields by set. |
| Rolling statistics | Window counts, mean/median final values, best/worst periods, mean XIRR/Vol/maximum DD, and related rolling aggregates. |
Save CSV follows the selected table. If rolling statistics were not calculated, the app explains that you must enable them in 2 Run and evaluate again; rolling CSV export is disabled.
Double-click a row or press Enter to see all its fields, including columns outside the current page. This custom-allocation view does not have the same persistent All fields of selected row button used by normal Results.
22.6 Saved sets versus evaluated snapshots
Sets persist in free_allocation_sets.json and reload after restart. The current format is schema 5, with a read/migration path for missing fields in older formats. An explicitly saved zero amount is distinct from an absent field. Do not edit the schema number manually.
The evaluated Custom allocation result itself cannot be reopened unchanged after exiting the app. Save needed tables as CSV and graphs as PNG. Saving a set is not the same as persistently saving its evaluation screen.
After an evaluation, tables, exports, and graph details use the conditions actually evaluated. Editing inputs does not retroactively change that snapshot. Evaluate again to compare new conditions.
23. Language, currency, and appearance
23.1 Display language
Open: Advanced → Language & currency.
| Language choice | Code |
|---|---|
| 日本語 | ja-JP |
| English | en-US |
| Deutsch | de-DE |
| Français | fr-FR |
| Español | es-ES |
| Italiano | it-IT |
| 简体中文 | zh-CN |
| 繁體中文 | zh-TW |
Changing the display language updates interface headings, choices, and messages. It does not translate user-defined asset/run names or the contents and column names of external CSVs.
23.2 Valuation currency
Supported choices are JPY, USD, EUR, GBP, AUD, CAD, SGD, and CNY. Language and valuation currency are separate choices.
Entered amounts are not automatically converted when you change currency. For example, leaving 100,000 in a field while changing JPY to USD changes its unit to USD. Review the intended amounts again.
Cross-currency assets use available FX conversion routes. Saved results retain their original valuation currency; they are not automatically recalculated using the current setting.
23.3 Appearance
Under Appearance, Theme offers Use Windows setting, Basic (light), and Dark. Highlight color can be chosen from presets or More colors…; the Base color (HEX) field and Apply provide the supported custom-color path.
Appearance changes are saved. Colors may be adjusted for readability; they do not change calculation conditions or the meaning of warnings/errors. Windows High Contrast takes priority when enabled and can temporarily disable color selection.
24. Data storage and backup
24.1 Two storage areas
| Area | Normal location | Contents |
|---|---|---|
| User-data area | PortfolioOptimizer under the Windows Documents folder |
Managed inputs/reference data under input; analysis runs under results. |
| Package private state | %LOCALAPPDATA%\Packages\YuInvestudy.AssetalyzePortfolioOptimizer_v52yw7agrk5ve\LocalCache\Local\PortfolioOptimizer\v1_0 |
Settings, asset registrations, custom-allocation sets, consent, diagnostics, and caches. |
If Documents is redirected/synchronized, or the usual location cannot be used safely, the actual location can differ. A supported fallback is %USERPROFILE%\PortfolioOptimizer. Use Advanced → Maintenance → Open user data to inspect the actual user-data root. The internal folder name remains PortfolioOptimizer even though the product is named Assetalyze.
24.2 Important files
| File or folder | Role |
|---|---|
Private state: settings\user_settings.json / .bak |
Screen, analysis, language, currency, and related settings. |
Private state: settings\custom_assets.json |
Asset registrations, currencies, managed-copy references, and provenance. |
Private state: settings\free_allocation_sets.json / .bak |
Saved custom-allocation sets. |
Other reference/dividend/consent information under settings |
Input interpretation, reference series, and document acceptance. |
User data: input\custom_assets |
Managed registered/generated CSVs and review records. |
User data: input\reference_data |
Managed FX and interest-rate inputs. |
User data: results\<individual result folder> |
Run-specific CSV/JSON/HTML/images/replay data. |
results\<individual result folder>\system |
State, settings, and internal result information belonging to that run. |
results\system\latest.json / .bak |
Shared management information pointing to the latest completed result. |
Private state: data\cache, data\metadata, and related locations |
Download/calculation caches and input/diagnostic metadata. |
Private state: t |
Session-owned temporary working data. |
Compatibility paths read older result/latest layouts. Do not manually combine old and current structures. Backup-file behavior varies by file; .bak is not a complete version-history system.
24.3 What latest means
latest.json points to a completed result; it is not the result itself. Backing up that file alone does not preserve charts, tables, or replay prices.
Completing a run or deleting the latest result can update these references. After deleting the last result, there should be no dangling reference to its folder. An empty result list is valid and does not require manual repair by creating a dummy folder.
24.4 Automatic settings saves
Valid changes are saved automatically. Read any save-error notice. Environment diagnostics and performance recommendations can also save related information.
Current editing conditions, a saved run’s execution conditions, and a custom-allocation set serve different purposes. To analyze changed conditions, run a new analysis rather than editing an old result’s internal files.
24.5 Backup procedure
- Wait for current work to finish and exit the app normally.
- Copy the entire actual user-data root to a new backup location, including each result’s
systemsubfolder. - If settings and registrations are needed, back up the current package-family private state separately.
- Include original CSVs stored outside the managed locations.
- Compare file counts, sizes, and important SHA-256 hashes. Preserve results and latest references from the same point in time.
- Record the app version, backup date, source locations, and valuation currency.
Copying private state to another PC/user does not guarantee restoration of every state or consent condition. Store entitlement is managed separately by Microsoft. Before restoration, preserve the current data too; stop the app and check target paths and compatibility. Do not blindly overwrite current files with an old backup.
24.6 Caches
Caches avoid repeated downloads/computation. Downloaded data can be refreshed according to cache expiry. A cache does not guarantee permanent offline operation or permanent provider availability.
Managed CSVs, completed results, and registration metadata are not all disposable cache. GPU JIT cache and temporary files are managed within the ownership boundaries the app can establish.
25. Microsoft Store licensing
25.1 Display states
| English state | Meaning |
|---|---|
| Purchased | The Store API confirmed a valid non-trial entitlement. |
| Trial (no time limit) | The trial entitlement and feature scope described in Chapter 4. |
| Invalid license | Returned validity/expiry information does not establish an active entitlement. |
| License could not be verified | The request is incomplete, failed, or needs updating. This is not a definitive statement that no purchase exists. |
The product uses Windows Store APIs for the current package. There is no user-entered product-license-key mechanism.
25.2 Purchase and refresh
- Read the license state on Home.
- Use Buy in Store if you want to purchase.
- After purchase, wait for the product to confirm Purchased access.
- If needed, use Refresh license in the license dialog.
Canceling the Store flow does not complete a purchase. A failed request is not guessed to mean Purchased; saved data remains intact while guidance is shown. The genuine demo and CSV compatibility check provide supported inspection paths when purchase verification is unavailable.
25.3 Network and cached state
Windows manages Store’s durable/offline entitlement cache. The app’s own verification snapshot is short-lived process state. A temporary unverified display immediately after startup should be distinguished from the subsequent completed request.
Permanent offline operation after purchase is not guaranteed for every Windows/Store state. Do not modify settings to fabricate Purchased, change authentication code, or copy license state from another environment.
26. Privacy
26.1 Information processed locally
The product processes selected CSVs, assets, analysis conditions, results, logs, settings, consent records, and environment information on the PC. Diagnostics can record CPU, RAM, NVIDIA GPU/VRAM, and driver information so that recommendations can be reused on that PC.
The implementation does not provide an app-specific account-registration service, advertising identifiers, usage analytics, or automatic crash-report uploading. User-defined names, filenames, and logs may still contain personal information.
26.2 External communication
- Public-data acquisition contacts supported official World Bank/Federal Reserve hosts.
- Entitlement queries and purchases use Microsoft Store mechanisms.
- Local only concerns calculation-data acquisition, not Store licensing communication.
- The market-data acquisition paths do not upload your analysis CSV contents, investment settings, or calculation results to data providers.
Providers receive normal connection information such as IP addresses and HTTP request information. Microsoft and provider handling is governed by their respective terms. Documents synchronization through OneDrive or another service also depends on OS/service settings.
26.3 Protecting and sharing files
The app does not encrypt every CSV or result. Protect the Windows account, storage, and backups appropriately. Review local paths, names, and file contents before sending logs or evidence to support.
Read Legal information → Privacy for the bundled privacy document. This manual does not add a new privacy contract or guarantee another service’s behavior.
27. Cautions and disclaimer
27.1 Analytical limits
- A historically optimal allocation may not remain effective in the future.
- Rolling analysis and grid searches can overfit past data.
- Taxes, costs, dividends, and leverage are modeled assumptions, not a complete reproduction of account rules, execution, or legislation.
- Indices, approximate Treasury series, and synthetic leveraged histories need not represent tradable instruments.
- Demo data is fictional, not actual performance or a forecast.
- “Optimal,” BEST, and robust scores are conditional on the chosen inputs and selection rules.
Assetalyze does not recommend acquiring, holding, or selling financial instruments and does not provide investment, tax, or legal advice. It does not guarantee future profit, principal, safety, or complete/accurate results. Verify the input data and its permitted use. Consult an appropriately qualified professional when needed.
27.2 Legal information screen
| Action | Content |
|---|---|
| Disclaimer | Product disclaimer. |
| Privacy | Data-handling document. |
| License agreement / EULA | Bundled software license agreement. |
| Third-party licenses | Notices for third-party components. |
| View accepted terms | Recorded document acceptance details. |
| Withdraw consent | Withdraws consent and exits; normal use requires agreement again. |
Withdrawal alone does not delete inputs, results, settings, or caches. Do not remove third-party notices when redistributing materials. This manual does not replace the bundled documents or establish new sales/refund terms.
28. Troubleshooting
28.1 Record the context first
Record the package version, screen, preceding action, exact message, selected result ID, currency, and period. Read Run log if needed. Locate and back up data before destructive troubleshooting.
| Symptom | Checks and safe response |
|---|---|
| Purchased app does not allow real-data operations | Check the displayed License state, purchase account, and connectivity. Use Refresh license. Do not delete settings or bypass licensing. |
fetch:real_or_unverified_data |
Indicates a license gate for real/unverified data acquisition. Confirm entitlement before assuming a provider outage. |
analyze:real_or_unverified_data or similar |
Real-data permission has not been established. Distinguish genuine demo data from personal inputs and check the license. |
| Cannot detect the CSV price column | Specify Date column and Price column after reviewing the source. Choose ordinary or adjusted close according to its meaning. |
| Ambiguous date order or decimals | Review Advanced import controls. If needed, prepare a separate ISO-date/decimal-point copy without digit grouping. |
| Multiple securities in a CSV | Select the intended Security and preview again. |
| CSV is readable but analysis fails | Check shared history, requested years, FX/rates, asset count, and entitlement. |
| Managed CSV changed after registration | Review the change and use the supported approval/replacement path. Do not edit the recorded hash manually. |
| Missing FX/conversion route | Check asset and valuation currencies, required pairs, quote direction, and dates in reference data. |
| Public-data download fails | Check connectivity, data mode, supported catalog, and provider guidance. Supply CSV data for unsupported instruments. |
| GPU unavailable | Recheck Compute environment and diagnostics. Explicitly review the compute method if using CPU instead. |
| Slow run or insufficient memory | Review asset count, allocation step, periods, median objective, and output volume. Use diagnostic recommendations; changed analytical conditions define a different analysis. |
| Resume unavailable | Check the stop-state record and exact settings compatibility. Restore stopped-run settings changes current inputs. |
| Empty result list | Check the actual storage location and Refresh. No results after deleting the last run is normal. |
| Overview report unavailable | Check whether that run contains the HTML. Do not output does not create the automatic HTML overview. |
| Asset-path CSV cannot be saved | Display a valid path first. Check destination permissions, free space, and file use by another program. |
| Rolling statistics empty | Enable Calculate rolling stats in Custom allocation → 2 Run, then Run evaluation. |
| Graph unchanged after editing inputs | It may show the evaluated snapshot. Re-evaluate Custom allocation, or distinguish a new normal analysis from changing a saved result’s display period. |
| Recycle Bin operation fails | Read the folder-use/storage/safety message. Do not substitute permanent deletion. |
| Table/graph is cramped | Maximize, scroll, page columns, open row details, or use Graph details. |
| Startup document-validation/initialization error | Preserve the exact message and current data. Check the official distribution/support information before resetting anything. |
28.2 Empty results versus an exception
With no results, the absence of graphs and KPIs is normal. An unhandled exception, Assetalyze startup error, or PowerShell launcher failed is not a normal empty-state indication. Record it and preserve the data for investigation.
28.3 Do not rush to forced termination or reset
If calculation is running, request Stop and wait for saved-stop feedback first. Do not manually remove result/settings files to hide an error. Reset app state and Permanently delete all data are destructive maintenance actions, not routine screen-navigation fixes.
29. Uninstalling
29.1 Back up first
- Locate needed result CSV/HTML/PNG exports.
- Exit the app normally.
- Back up user data, required private state, and original CSVs as described in Chapter 24.
- Uninstall Assetalyze through Windows’ installed-app management.
29.2 What remains and what is removed
| Location | Normal MSIX uninstall behavior |
|---|---|
| Installed product and bundled runtime | Removed. |
| Current package-family private state | Normally removed, including settings, registrations, and caches. |
| Inputs/results in Documents or the fallback user-data root | Outside package private state; not deleted by ordinary app uninstall. |
| Original CSVs, exports, or backups placed elsewhere by the user | Not collectively removed by the app uninstall. |
Managed CSVs remaining in Documents do not by themselves restore the asset library. The registrations connecting them to the app may have been in private state. Preserve settings/registration information as well as input files.
Store entitlement is separate from local data. Restoring a backup does not create a purchase license.
29.3 Intentionally deleting managed data
Advanced → Maintenance → Permanently delete all data is the explicit operation for deleting currently managed data. Review its scope before uninstalling. Unlike deleting a single result, it does not use the reversible single-result Recycle Bin workflow and has no in-app undo. Original CSVs, old alternate locations, and backups outside its targets must be reviewed separately.
30. Glossary
| Term | Explanation |
|---|---|
| Allocation / portfolio | The combination of assets and the percentage assigned to each. |
| Optimization | Selecting the best-scoring candidate under defined inputs, objectives, and constraints; not a guarantee of future superiority. |
| Allocation grid | The set of candidate weights formed with a fixed step, such as 5%. |
| Risk / return | The relationship between variability or decline and performance. Here it refers to historical/model statistics. |
| Volatility / Vol | Variability of returns. A larger value means greater variation, not a direct loss amount. |
| Vol limit | An optimization constraint, distinct from the measured realized Vol. |
| Realized Vol | Variability measured over the evaluated history/windows, not a future forecast. |
| Drawdown / DD | A percentage decline from a preceding peak. |
| Maximum drawdown / max DD / MDD | The largest drawdown within an evaluation period. It is not a cap on future losses. |
| XIRR | An annualized internal rate of return that accounts for cash-flow dates and amounts. It is useful with contributions at different times and is not simply total profit divided by years. |
| TWR | Time-weighted return: links period returns while separating the influence of external cash flows. Its purpose differs from XIRR. |
| Cumulative principal | Initial investment plus all contributions made up to that time. |
| Final value | Portfolio value at the end of the evaluated period, not profit alone. |
| Gain / loss | Difference between portfolio value and contributed principal. |
| Mean | Sum of values divided by their count; sensitive to extreme values. |
| Median | Middle value after sorting; the mean of the two middle values for an even count. |
| Rolling window | A fixed-length evaluation interval whose start moves through history. |
| Windows | Number of usable rolling evaluation intervals. |
| BEST / MEDIAN / WORST | Representative periods selected by final value, not probabilities of future scenarios. |
| Rebalancing | Trading to bring portfolio weights toward target weights. Costs and tax assumptions affect its result. |
| Total return | Return incorporating price changes and dividends/distributions. Verify what the input already includes. |
| CPU exact | The product’s CPU float64 evaluation/verification path. “Exact” does not mean a perfect reproduction of reality. |
| GPU search | GPU-accelerated candidate evaluation/selection followed by the relevant CPU verification. |
| Batch | A group of candidates processed together. |
| Snapshot | Data preserving settings or evaluation values at a particular time, separate from subsequent edits. |
| Cache | Saved acquisition/computation data for reuse; not a synonym for all results and registrations. |
| Checkpoint | A saved calculation-progress point for resume, in this user workflow. |
| Latest | Management information pointing to a completed result, not the result itself. |
| Result ID | Identifier used to distinguish runs, including before deletion or in support requests. |
| Schema | Version of a stored data structure. Normally managed by the app. |
| SHA-256 | A content hash used for copy identity or change detection. It does not prove data is economically correct. |
| MSIX / PFN | Windows package format / package-family identifier, relevant to updates and private storage. |
| Purchased / Trial / Unknown / Invalid | Store entitlement states; see Chapter 25. |
Scope: This English edition describes the accepted 1.0.55.0 Source and its reachable normal interface. It does not present the retired wizard, hidden validation pages, developer commands, or test controls as user features. It does not guarantee future external-service availability, performance on every PC, or features in another version. The source/label audit accompanying this manual distinguishes verified product behavior from matters the Source alone cannot establish.