{"id":22886342,"url":"https://github.com/zelosleone/finncorr","last_synced_at":"2026-02-09T19:38:34.593Z","repository":{"id":266362921,"uuid":"898146235","full_name":"zelosleone/FinnCorr","owner":"zelosleone","description":"A .NET Core financial analysis tool/API for calculating correlations between time series data with interactive visualizations powered by ML.NET and Plotly.js.","archived":false,"fork":false,"pushed_at":"2024-12-03T21:59:14.000Z","size":20,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-14T23:07:57.416Z","etag":null,"topics":["aspnet-core","correlation-analysis","csv-parser","data-analysis","dotnet","financial-analysis","machine-learning","ml-net","plotly","rest-api","statistical-analysis","swagger","time-series","visualization"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zelosleone.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-03T21:46:29.000Z","updated_at":"2024-12-04T18:50:18.000Z","dependencies_parsed_at":"2024-12-03T22:29:44.302Z","dependency_job_id":"8e6384ee-4d63-42a2-8c6c-a1d43a261327","html_url":"https://github.com/zelosleone/FinnCorr","commit_stats":null,"previous_names":["zelosleone/finncorr"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zelosleone%2FFinnCorr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zelosleone%2FFinnCorr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zelosleone%2FFinnCorr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zelosleone%2FFinnCorr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zelosleone","download_url":"https://codeload.github.com/zelosleone/FinnCorr/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248975316,"owners_count":21192209,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aspnet-core","correlation-analysis","csv-parser","data-analysis","dotnet","financial-analysis","machine-learning","ml-net","plotly","rest-api","statistical-analysis","swagger","time-series","visualization"],"created_at":"2024-12-13T20:17:49.858Z","updated_at":"2026-02-09T19:38:34.563Z","avatar_url":"https://github.com/zelosleone.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FinnCorr - Financial Data Correlation Analysis Engine\n\n## Overview\nA REST API and web-based analysis tool for financial time series correlation analysis, featuring automated data processing and visualization capabilities.\n\n## Features\n\n### Data Processing\n- CSV and JSON file support\n- Automated price data detection\n- Multiple data format handling\n- Time series data support\n\n### Analysis Capabilities\n- Percentage change correlation calculations\n- Pearson correlation coefficient analysis\n- Correlation classification:\n  - Strong positive (\u003e 70%)\n  - Moderate positive (30-70%)\n  - Little/no correlation (-30% to 30%)\n  - Moderate negative (-30% to -70%)\n  - Strong negative (\u003c -70%)\n\n### Visualization\n- Interactive Plotly charts\n- Dual-axis correlation visualization\n- HTML-based output\n\n## Technical Stack\n- ASP.NET Core REST API\n- ML.NET for data processing\n- SoftCircuits.CsvParser\n- System.Text.Json\n- Plotly.js\n\n## API Reference\n\n### Upload Endpoint\n```http\nPOST /api/upload\nContent-Type: multipart/form-data\n```\n\n### Response Structure\n```typescript\ninterface AnalysisResult {\n    insights: string;\n    graphUrl: string;\n    totalCorrelations: number;\n    strongPositive: number;\n    moderatePositive: number;\n    moderateNegative: number;\n    strongNegative: number;\n    noCorrelation: number;\n    positivePercentage: number;\n    negativePercentage: number;\n}\n```\n\n## Implementation Details\n\n### Core Components\n- `DataAnalysisService`: Analysis logic\n- `UploadController`: API handling\n- `FileUploadDto`: Upload model\n- `AnalysisResult`: Output model\n- `AnalysisConfiguration`: Settings model\n\n### Mathematical Foundation\n\n#### Percentage Change\n```\nΔ% = ((pₙ - pₙ₋₁) / pₙ₋₁) × 100\n```\n\n#### Pearson Correlation\n```\nr = Σ((x - μₓ)(y - μᵧ)) / √(Σ(x - μₓ)² × Σ(y - μᵧ)²)\n```\n\n#### Quality Scoring\n```\nQ = (C × 10) + V + R + S\n```\n\n## Setup\n1. Install .NET runtime\n2. Clone repository\n3. Run `dotnet restore`\n4. Execute `dotnet run`\n5. Access Swagger UI at root URL\n\n## Documentation\nFull API documentation available via Swagger UI\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzelosleone%2Ffinncorr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzelosleone%2Ffinncorr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzelosleone%2Ffinncorr/lists"}