From 6fb200ac9c34384ad8d3a83d02ec3ae627aa7740 Mon Sep 17 00:00:00 2001 From: andre_ramos Date: Wed, 28 Aug 2024 18:11:02 -0400 Subject: [PATCH] fix interpolation warning and change docs --- .github/workflows/TagBot.yml | 16 ++ .gitignore | 2 + LICENSE | 21 ++ Project.toml | 8 +- README.md | 81 +++--- datasets/inflows.csv | 301 +++++++++++++++++++++++ docs/figures/inflow_norta_simulation.png | Bin 0 -> 43862 bytes docs/figures/inflow_simulation.png | Bin 0 -> 39737 bytes src/NonParametricNORTA.jl | 11 +- src/transform_data.jl | 6 +- test/NonParametricNORTA.jl | 16 +- test/transform_data.jl | 6 +- 12 files changed, 410 insertions(+), 58 deletions(-) create mode 100644 .github/workflows/TagBot.yml create mode 100644 .gitignore create mode 100644 LICENSE create mode 100644 datasets/inflows.csv create mode 100644 docs/figures/inflow_norta_simulation.png create mode 100644 docs/figures/inflow_simulation.png diff --git a/.github/workflows/TagBot.yml b/.github/workflows/TagBot.yml new file mode 100644 index 0000000..53f572a --- /dev/null +++ b/.github/workflows/TagBot.yml @@ -0,0 +1,16 @@ +name: TagBot +on: + issue_comment: # THIS BIT IS NEW + types: + - created + workflow_dispatch: +jobs: + TagBot: + # THIS 'if' LINE IS NEW + if: github.event_name == 'workflow_dispatch' || github.actor == 'JuliaTagBot' + # NOTHING BELOW HAS CHANGED + runs-on: ubuntu-latest + steps: + - uses: JuliaRegistries/TagBot@v1 + with: + token: ${{ secrets.GITHUB_TOKEN }} \ No newline at end of file diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..bcee700 --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +.DS_Store +Manifest.toml \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..24358b3 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2018-2021: Raphael Saavedra, Guilherme Bodin, Mario Souto + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. \ No newline at end of file diff --git a/Project.toml b/Project.toml index 05353b9..2d85fbb 100644 --- a/Project.toml +++ b/Project.toml @@ -1,7 +1,7 @@ name = "NonParametricNORTA" uuid = "e97a57fc-2266-4ea9-80d8-a1f12fb1471b" authors = ["andreramosfc "] -version = "0.1.1" +version = "0.2.0" [deps] Distributions = "31c24e10-a181-5473-b8eb-7969acd0382f" @@ -10,3 +10,9 @@ KernelDensity = "5ab0869b-81aa-558d-bb23-cbf5423bbe9b" Statistics = "10745b16-79ce-11e8-11f9-7d13ad32a3b2" StatsBase = "2913bbd2-ae8a-5f71-8c99-4fb6c76f3a91" Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40" + +[compat] +julia = "1" +Distributions = "0.16, 0.17, 0.18, 0.19, 0.20, 0.21, 0.22, 0.23, 0.24, 0.25" +Interpolations = "0.14, 0.15" +KernelDensity = "0.5, 0.6" \ No newline at end of file diff --git a/README.md b/README.md index 7c45e89..365d6f1 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ using Plots using Distributions y = rand(1000, 3)*rand(3).*15 #generate y as a regression -y_norta, non_parametric_distribution = NonParametricNORTA.convertData(y) +y_norta, non_parametric_distribution = NonParametricNORTA.convert_data(y) ``` ### Transformation visualization @@ -26,7 +26,7 @@ This transformation involves obtaining the non-parametric distribution's cumulat ## Data reverse transformation ```julia -sc = NonParametricNORTA.reverseData(rand(Normal(0, 1), 100), non_parametric_distribution) +sc = NonParametricNORTA.reverse_data(rand(Normal(0, 1), 100), non_parametric_distribution) ``` ### Reverse transformation visualization @@ -36,54 +36,55 @@ Similar to the initial transformation but in reverse, this process involves reve In time series simulation processes within stationary contexts, maintaining scenarios that respect historical value bounds becomes crucial. Ensuring scenarios do not violate the maximum and minimum values can be achieved by modeling the transformed NORTA series and then performing the reverse transformation process. -### Regression + residual bootstraping example +### Simulation of Water Inflows -```julia -T = 1000 -train_idx = 1:900 -test_idx = 901:1000 -N_scenarios = 100 - -X = rand(T, 10) -X_train = X[train_idx, :] -X_test = X[test_idx, :] - -y = X*(rand(10).*10) + rand(T) -y_train = y[train_idx] -y_test = y[test_idx] +In this example we want to generate scenario paths for a water inflow time series. We will make two simulations using an Auto ARIMA (estimated vi StateSpaceModels.jl package). The first one will be the simple output of the model and the second one will be utilizing the NORTA transformation. -y_train_norta, np = NonParametricNORTA.convertData(y_train) +```julia +using StateSpaceModels, CSV, DataFrames, Plots +df = CSV.read("datasets/inflows.csv") -β = X_train\y_train_norta #Model the NORTA transformed data -residuals = y_train_norta - X_train*β +y = df[!, 2] +dates = df[!, 1] +forecast_dates = collect(Date(2015, 1, 1): Month(1): Date(2016, 12, 1)) +steps_ahead = 24 -NORTA_scenarios = zeros(length(y_test), N_scenarios) -for i in 1:N_scenarios - NORTA_scenarios[:, i] = X[T_train+1:T, :]*β + rand(residuals, length(y_test)) -end ``` -#### Transformed data results +#### Simulating Original Time Series ```julia -plot(y_train_norta, w=2, color = "black", lab = "NORTA transformed historic", legend=:outerbottom) -for i in 1:N_scenarios - plot!(vcat(ones(T_train).*NaN, NORTA_scenarios[:, i]), color = "red", alpha = 0.2, lab = "") -end -plot!([], color="red", lab = "NORTA transformed scenarios") +model = auto_arima(y; seasonal = 12) +fit!(model) +scenarios = simulate_scenarios(model, 24, 100)[:, 1, :] +expected_value = [i[1] for i in forecast(model, 24).expected_value] + +plt = plot(dates, y, label = "Historical Values", color = :black, w=2, legend=:outertop) +plot!(plt, forecast_dates, scenarios, label = "", color = "grey", width = 0.2) +plot!(forecast_dates, expected_value.*NaN, color = "grey", label="Scenarios") +plot!(forecast_dates, expected_value, lab = "Expected Value", color = :red) + ``` -![norta_simulation](./docs/figures/norta_sim.PNG) +![simulation](./docs/figures/inflow_simulation.PNG) -The modeled simulation, when visualized in the transformed scale, does not adhere to historical bounds. This is evident as the maximum and minimum of the simulation exceed historical boundaries. +The modeled simulation does not adhere to historical bounds. This is evident as, in this case, the minimum of the simulation is below historical boundaries. -#### Original scale data results +#### Simulating utilizing NORTA ```julia -scenarios = NonParametricNORTA.reverseData(NORTA_scenarios, np) +transformed_y, non_parametric_distribution = NonParametricNORTA.convert_data(y) + +model = auto_arima(transformed_y; seasonal = 12) +fit!(model) +scenarios = simulate_scenarios(model, 24, 100)[:, 1, :] +expected_value = [i[1] for i in forecast(model, 24).expected_value] + +scenarios = NonParametricNORTA.reverse_data(scenarios, non_parametric_distribution) +expected_value = NonParametricNORTA.reverse_data(expected_value, non_parametric_distribution) + +plt = plot(dates, y, label = "Historical Values", color = :black, w=2, legend=:outertop) +plot!(plt, forecast_dates, scenarios, label = "", color = "grey", width = 0.2) +plot!(forecast_dates, expected_value.*NaN, color = "grey", label="Scenarios") +plot!(forecast_dates, expected_value, lab = "Expected Value", color = :red) -plot(y_train, w=2, color = "black", lab = "Original Historic", legend=:outerbottom) -for i in 1:N_scenarios - plot!(vcat(ones(T_train).*NaN, scenarios[:, i]), color = "red", alpha = 0.2, lab = "") -end -plot!([], color="red", lab = "Scenarios") ``` -![simulation](./docs/figures/simulation.PNG) +![norta_simulation](./docs/figures/inflow_norta_simulation.PNG) -However, upon reverse transforming the scenarios, we observe that the simulation respects the historical boundaries. This demonstrates the utility of the reverse transformation process in maintaining data integrity within the historical context. +We can see that using the NORTA transformation the simulation respects the historical boundaries. diff --git a/datasets/inflows.csv b/datasets/inflows.csv new file mode 100644 index 0000000..3008f48 --- /dev/null +++ b/datasets/inflows.csv @@ -0,0 +1,301 @@ +Date,MW +1990-01-01,57492.0 +1990-02-01,60841.0 +1990-03-01,53980.0 +1990-04-01,36202.0 +1990-05-01,28100.0 +1990-06-01,23593.0 +1990-07-01,21316.0 +1990-08-01,25463.0 +1990-09-01,26246.0 +1990-10-01,20358.0 +1990-11-01,27336.0 +1990-12-01,62655.0 +1991-01-01,79711.0 +1991-02-01,41397.0 +1991-03-01,43143.0 +1991-04-01,34741.0 +1991-05-01,29663.0 +1991-06-01,23024.0 +1991-07-01,24399.0 +1991-08-01,22020.0 +1991-09-01,25830.0 +1991-10-01,26548.0 +1991-11-01,24366.0 +1991-12-01,25119.0 +1992-01-01,47675.0 +1992-02-01,64956.0 +1992-03-01,67589.0 +1992-04-01,68237.0 +1992-05-01,39812.0 +1992-06-01,29407.0 +1992-07-01,24668.0 +1992-08-01,19672.0 +1992-09-01,17125.0 +1992-10-01,26392.0 +1992-11-01,22818.0 +1992-12-01,35153.0 +1993-01-01,59939.0 +1993-02-01,85850.0 +1993-03-01,55549.0 +1993-04-01,50229.0 +1993-05-01,49954.0 +1993-06-01,34213.0 +1993-07-01,26046.0 +1993-08-01,22294.0 +1993-09-01,27881.0 +1993-10-01,33842.0 +1993-11-01,45942.0 +1993-12-01,53800.0 +1994-01-01,47618.0 +1994-02-01,68043.0 +1994-03-01,55607.0 +1994-04-01,46683.0 +1994-05-01,32297.0 +1994-06-01,31268.0 +1994-07-01,23083.0 +1994-08-01,20688.0 +1994-09-01,23187.0 +1994-10-01,29337.0 +1994-11-01,21151.0 +1994-12-01,35122.0 +1995-01-01,64242.0 +1995-02-01,51156.0 +1995-03-01,60587.0 +1995-04-01,43217.0 +1995-05-01,31965.0 +1995-06-01,28561.0 +1995-07-01,24260.0 +1995-08-01,18859.0 +1995-09-01,15101.0 +1995-10-01,15980.0 +1995-11-01,23728.0 +1995-12-01,36155.0 +1996-01-01,52033.0 +1996-02-01,83089.0 +1996-03-01,51899.0 +1996-04-01,46963.0 +1996-05-01,34553.0 +1996-06-01,24851.0 +1996-07-01,23659.0 +1996-08-01,16810.0 +1996-09-01,15453.0 +1996-10-01,25645.0 +1996-11-01,25113.0 +1996-12-01,33841.0 +1997-01-01,54705.0 +1997-02-01,40757.0 +1997-03-01,53675.0 +1997-04-01,36294.0 +1997-05-01,26398.0 +1997-06-01,20891.0 +1997-07-01,18138.0 +1997-08-01,15966.0 +1997-09-01,21040.0 +1997-10-01,21942.0 +1997-11-01,36214.0 +1997-12-01,45654.0 +1998-01-01,91733.0 +1998-02-01,72623.0 +1998-03-01,57340.0 +1998-04-01,44941.0 +1998-05-01,32515.0 +1998-06-01,39236.0 +1998-07-01,28081.0 +1998-08-01,21218.0 +1998-09-01,20253.0 +1998-10-01,24862.0 +1998-11-01,33307.0 +1998-12-01,50420.0 +1999-01-01,42917.0 +1999-02-01,53523.0 +1999-03-01,55192.0 +1999-04-01,45015.0 +1999-05-01,34691.0 +1999-06-01,26449.0 +1999-07-01,20732.0 +1999-08-01,22483.0 +1999-09-01,23157.0 +1999-10-01,33401.0 +1999-11-01,28656.0 +1999-12-01,39389.0 +2000-01-01,58172.0 +2000-02-01,50152.0 +2000-03-01,58904.0 +2000-04-01,33859.0 +2000-05-01,25772.0 +2000-06-01,24001.0 +2000-07-01,22141.0 +2000-08-01,15666.0 +2000-09-01,16599.0 +2000-10-01,13760.0 +2000-11-01,19991.0 +2000-12-01,30979.0 +2001-01-01,55086.0 +2001-02-01,67193.0 +2001-03-01,61750.0 +2001-04-01,37938.0 +2001-05-01,24808.0 +2001-06-01,21243.0 +2001-07-01,19637.0 +2001-08-01,18794.0 +2001-09-01,29810.0 +2001-10-01,18570.0 +2001-11-01,29025.0 +2001-12-01,44900.0 +2002-01-01,40408.0 +2002-02-01,40077.0 +2002-03-01,37906.0 +2002-04-01,28635.0 +2002-05-01,22673.0 +2002-06-01,20285.0 +2002-07-01,17172.0 +2002-08-01,14625.0 +2002-09-01,15492.0 +2002-10-01,21866.0 +2002-11-01,25856.0 +2002-12-01,40097.0 +2003-01-01,63205.0 +2003-02-01,70382.0 +2003-03-01,48800.0 +2003-04-01,31251.0 +2003-05-01,28539.0 +2003-06-01,20773.0 +2003-07-01,18110.0 +2003-08-01,16350.0 +2003-09-01,17336.0 +2003-10-01,13128.0 +2003-11-01,22553.0 +2003-12-01,34851.0 +2004-01-01,59676.0 +2004-02-01,61144.0 +2004-03-01,48336.0 +2004-04-01,42433.0 +2004-05-01,26791.0 +2004-06-01,22631.0 +2004-07-01,19317.0 +2004-08-01,15453.0 +2004-09-01,14901.0 +2004-10-01,15661.0 +2004-11-01,21409.0 +2004-12-01,33553.0 +2005-01-01,46920.0 +2005-02-01,70979.0 +2005-03-01,62252.0 +2005-04-01,48041.0 +2005-05-01,37449.0 +2005-06-01,33344.0 +2005-07-01,27521.0 +2005-08-01,19268.0 +2005-09-01,15114.0 +2005-10-01,21647.0 +2005-11-01,25949.0 +2005-12-01,40178.0 +2006-01-01,66456.0 +2006-02-01,58500.0 +2006-03-01,56761.0 +2006-04-01,37543.0 +2006-05-01,31017.0 +2006-06-01,27843.0 +2006-07-01,21228.0 +2006-08-01,16947.0 +2006-09-01,19565.0 +2006-10-01,23056.0 +2006-11-01,28733.0 +2006-12-01,56438.0 +2007-01-01,46497.0 +2007-02-01,48707.0 +2007-03-01,58816.0 +2007-04-01,50040.0 +2007-05-01,29101.0 +2007-06-01,23156.0 +2007-07-01,20355.0 +2007-08-01,17288.0 +2007-09-01,18415.0 +2007-10-01,25962.0 +2007-11-01,28972.0 +2007-12-01,56495.0 +2008-01-01,94605.0 +2008-02-01,90929.0 +2008-03-01,51458.0 +2008-04-01,35442.0 +2008-05-01,29123.0 +2008-06-01,24070.0 +2008-07-01,23365.0 +2008-08-01,18878.0 +2008-09-01,13222.0 +2008-10-01,13424.0 +2008-11-01,23682.0 +2008-12-01,29875.0 +2009-01-01,37972.0 +2009-02-01,63252.0 +2009-03-01,63738.0 +2009-04-01,52206.0 +2009-05-01,36211.0 +2009-06-01,28072.0 +2009-07-01,21178.0 +2009-08-01,22681.0 +2009-09-01,16272.0 +2009-10-01,20869.0 +2009-11-01,26112.0 +2009-12-01,38238.0 +2010-01-01,54583.0 +2010-02-01,65848.0 +2010-03-01,47528.0 +2010-04-01,48871.0 +2010-05-01,31401.0 +2010-06-01,25564.0 +2010-07-01,27969.0 +2010-08-01,24338.0 +2010-09-01,31695.0 +2010-10-01,36870.0 +2010-11-01,37511.0 +2010-12-01,61945.0 +2011-01-01,70653.0 +2011-02-01,59278.0 +2011-03-01,53828.0 +2011-04-01,45650.0 +2011-05-01,29402.0 +2011-06-01,23375.0 +2011-07-01,20568.0 +2011-08-01,15930.0 +2011-09-01,13799.0 +2011-10-01,21837.0 +2011-11-01,29116.0 +2011-12-01,44302.0 +2012-01-01,76036.0 +2012-02-01,49825.0 +2012-03-01,85999.0 +2012-04-01,54975.0 +2012-05-01,33691.0 +2012-06-01,27975.0 +2012-07-01,24232.0 +2012-08-01,23952.0 +2012-09-01,16530.0 +2012-10-01,24899.0 +2012-11-01,27107.0 +2012-12-01,44359.0 +2013-01-01,73094.0 +2013-02-01,49275.0 +2013-03-01,36886.0 +2013-04-01,32008.0 +2013-05-01,29755.0 +2013-06-01,38166.0 +2013-07-01,26257.0 +2013-08-01,17135.0 +2013-09-01,14598.0 +2013-10-01,14999.0 +2013-11-01,23056.0 +2013-12-01,27619.0 +2014-01-01,46596.0 +2014-02-01,56166.0 +2014-03-01,48967.0 +2014-04-01,51081.0 +2014-05-01,29018.0 +2014-06-01,38001.0 +2014-07-01,30589.0 +2014-08-01,18994.0 +2014-09-01,16897.0 +2014-10-01,23751.0 +2014-11-01,22610.0 +2014-12-01,39726.0 diff --git a/docs/figures/inflow_norta_simulation.png b/docs/figures/inflow_norta_simulation.png new file mode 100644 index 0000000000000000000000000000000000000000..cc911ff6eb4aad2a5eeae6e253337937f257c5a6 GIT binary patch literal 43862 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 literal 0 HcmV?d00001 diff --git a/docs/figures/inflow_simulation.png b/docs/figures/inflow_simulation.png new file mode 100644 index 0000000000000000000000000000000000000000..ecea53f5dca73119e9cbd6c4edf976cd07f5192e GIT binary patch literal 39737 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 h{|?UnJ=q9;LXjg&N+nzHYv~;L>1f isa(x, Int), observations) ? observations = convert(Vector{Float64}, observations) : nothing non_parametric_distribution = get_discretenonparametric_distribution(observations) return get_transformed_observations(non_parametric_distribution, observations), non_parametric_distribution end """ - reverseData(scenarios::Union{Vector{Fl}, Matrix{Fl}}, non_parametric_distribution::DiscreteNonParametric) where Fl + reverse_data(scenarios::Union{Vector{Fl}, Matrix{Fl}}, non_parametric_distribution::DiscreteNonParametric) where Fl Returns the reverse NORTA transformed scenarios. @@ -35,7 +38,7 @@ end # Returns - `reverse_data(interpolation, normal_cumulative_value, non_parametric_distribution)`: Scenarios data in the original scale. """ -function reverseData(scenarios::Union{Vector{Fl}, Matrix{Fl}}, non_parametric_distribution::DiscreteNonParametric) where Fl +function reverse_data(scenarios::Union{Vector{Fl}, Matrix{Fl}}, non_parametric_distribution::DiscreteNonParametric) where Fl normal_cumulative_value = get_normal_cdf(scenarios) interpolation = get_interpolation_function(normal_cumulative_value, non_parametric_distribution) return reverse_data(interpolation, normal_cumulative_value, non_parametric_distribution) diff --git a/src/transform_data.jl b/src/transform_data.jl index 3c04fa3..fdf8843 100644 --- a/src/transform_data.jl +++ b/src/transform_data.jl @@ -69,7 +69,7 @@ end - `non_parametric_distribution::DiscreteNonParametric`: Non parametric distribution of the observations. # Returns - - `LinearInterpolation(cdf_range, quantile_range) `: interpolation function of the normal cumulative distribution of the scenarios. + - `linear_interpolation(cdf_range, quantile_range) `: interpolation function of the normal cumulative distribution of the scenarios. """ function get_interpolation_function(normal_cumulative_value::Union{Vector{Fl}, Matrix{Fl}}, non_parametric_distribution::DiscreteNonParametric) where Fl @@ -78,7 +78,9 @@ function get_interpolation_function(normal_cumulative_value::Union{Vector{Fl}, M quantile_range = [quantile(non_parametric_distribution, t) for t in cdf_range] - return LinearInterpolation(cdf_range, quantile_range) + Interpolations.deduplicate_knots!(cdf_range) + Interpolations.deduplicate_knots!(quantile_range) + return linear_interpolation(cdf_range, quantile_range) end """ diff --git a/test/NonParametricNORTA.jl b/test/NonParametricNORTA.jl index 107c5e8..ac50365 100644 --- a/test/NonParametricNORTA.jl +++ b/test/NonParametricNORTA.jl @@ -1,25 +1,25 @@ -@testset "Function: convertData" begin +@testset "Function: convert_data" begin observations = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] - expected = NonParametricNORTA.convertData(observations) + expected = NonParametricNORTA.convert_data(observations) @test trunc.(expected[1], digits = 3) == [-1.281, -0.841, -0.524, -0.253, 0.0, 0.253, 0.524, 0.841, 1.281, 4.264] @test expected[2].support == observations @test expected[2].p == ones(10)./10 observations = [1, 1, 1, 1, 1, 3, 2, 2, 2, 2] - expected = NonParametricNORTA.convertData(observations) + expected = NonParametricNORTA.convert_data(observations) @test trunc.(expected[1], digits = 3) == [0, 0, 0, 0, 0, 4.264, 1.281, 1.281, 1.281, 1.281] @test expected[2].support == [1, 2, 3] @test expected[2].p == [0.5, 0.4, 0.1] end -@testset "Function: reverseData" begin +@testset "Function: reverse_data" begin observations = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] - transformed_y, non_parametric_distribution = NonParametricNORTA.convertData(observations) - expected = NonParametricNORTA.reverseData(transformed_y, non_parametric_distribution) + transformed_y, non_parametric_distribution = NonParametricNORTA.convert_data(observations) + expected = NonParametricNORTA.reverse_data(transformed_y, non_parametric_distribution) @test trunc.(expected, digits = 3) == observations observations = collect(-1000:100:1000) - transformed_y, non_parametric_distribution = NonParametricNORTA.convertData(observations) - expected = NonParametricNORTA.reverseData(transformed_y, non_parametric_distribution) + transformed_y, non_parametric_distribution = NonParametricNORTA.convert_data(observations) + expected = NonParametricNORTA.reverse_data(transformed_y, non_parametric_distribution) @test trunc.(expected, digits = 3) == observations end \ No newline at end of file diff --git a/test/transform_data.jl b/test/transform_data.jl index f26e283..6506f9c 100644 --- a/test/transform_data.jl +++ b/test/transform_data.jl @@ -29,14 +29,14 @@ end @testset "Function: get_interpolation_function" begin normal_cumulative_value = NonParametricNORTA.get_normal_cdf([-1.281, -0.841, -0.524, -0.253, 0.0, 0.253, 0.524, 0.841, 1.281, 5.612]) - observations = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] + observations = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10.0] non_parametric_distribution = NonParametricNORTA.get_discretenonparametric_distribution(observations) expected = NonParametricNORTA.get_interpolation_function(normal_cumulative_value, non_parametric_distribution) @test isa(expected, NonParametricNORTA.Interpolations.Extrapolation) end @testset "Function: reverse_data" begin - observations = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] + observations = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10.0] non_parametric_distribution = NonParametricNORTA.get_discretenonparametric_distribution(observations) transformed_obs = NonParametricNORTA.get_transformed_observations(non_parametric_distribution, observations) normal_cumulative_value = round.(NonParametricNORTA.get_normal_cdf(transformed_obs), digits = 8) @@ -44,7 +44,7 @@ end expected = NonParametricNORTA.reverse_data(interpolation, normal_cumulative_value, non_parametric_distribution) @test trunc.(expected, digits = 3) == observations - observations = [1, 1, 1, 1, 1, 3, 2, 2, 2, 2] + observations = [1, 1, 1, 1, 1, 3, 2, 2, 2, 2.0] non_parametric_distribution = NonParametricNORTA.get_discretenonparametric_distribution(observations) transformed_obs = NonParametricNORTA.get_transformed_observations(non_parametric_distribution, observations) normal_cumulative_value = round.(NonParametricNORTA.get_normal_cdf(transformed_obs), digits = 8)