From 7847a5a0e54ce4b2f37c86e76def91d8f4afe674 Mon Sep 17 00:00:00 2001 From: Maya Mutic <62064527+mmutic@users.noreply.github.com> Date: Mon, 17 Jun 2024 11:33:27 -0400 Subject: [PATCH] Tutorial fixes #698 Fix formatting and rendering of images in tutorials 3, 5, 6, and 8 to address issue #697. --- CHANGELOG.md | 3 +++ Project.toml | 2 +- .../Tutorial_3_K-means_time_domain_reduction.md | 8 +++++--- docs/src/Tutorials/Tutorial_5_solve_model.md | 4 +--- .../src/Tutorials/Tutorial_6_solver_settings.md | 8 ++++---- docs/src/Tutorials/Tutorial_8_outputs.md | 5 ----- docs/src/Tutorials/files/t3_recon.png | Bin 0 -> 77105 bytes docs/src/Tutorials/files/t3_recon.svg | 1 - docs/src/Tutorials/files/t6_tols.svg | 1 + 9 files changed, 15 insertions(+), 17 deletions(-) create mode 100644 docs/src/Tutorials/files/t3_recon.png delete mode 100644 docs/src/Tutorials/files/t3_recon.svg create mode 100644 docs/src/Tutorials/files/t6_tols.svg diff --git a/CHANGELOG.md b/CHANGELOG.md index 8b4478add3..e52c4d68ef 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## Unreleased +### Fixed +- Fix formatting and images in tutorials 3, 5, 6, and 8 to address issue #697 (#698) + ### Added - Add objective scaler for addressing problem ill-conditioning (#667) diff --git a/Project.toml b/Project.toml index 6a092d4996..c31b96b9d5 100644 --- a/Project.toml +++ b/Project.toml @@ -1,7 +1,7 @@ name = "GenX" uuid = "5d317b1e-30ec-4ed6-a8ce-8d2d88d7cfac" authors = ["Bonaldo, Luca", "Chakrabarti, Sambuddha", "Cheng, Fangwei", "Ding, Yifu", "Jenkins, Jesse D.", "Luo, Qian", "Macdonald, Ruaridh", "Mallapragada, Dharik", "Manocha, Aneesha", "Mantegna, Gabe ", "Morris, Jack", "Patankar, Neha", "Pecci, Filippo", "Schwartz, Aaron", "Schwartz, Jacob", "Schivley, Greg", "Sepulveda, Nestor", "Xu, Qingyu", "Zhou, Justin"] -version = "0.4.0" +version = "0.4.0-dev.1" [deps] CSV = "336ed68f-0bac-5ca0-87d4-7b16caf5d00b" diff --git a/docs/src/Tutorials/Tutorial_3_K-means_time_domain_reduction.md b/docs/src/Tutorials/Tutorial_3_K-means_time_domain_reduction.md index 5648c1eadc..38ea75deb2 100644 --- a/docs/src/Tutorials/Tutorial_3_K-means_time_domain_reduction.md +++ b/docs/src/Tutorials/Tutorial_3_K-means_time_domain_reduction.md @@ -29,6 +29,7 @@ using Plots using Clustering using ScikitLearn @sk_import datasets: (make_blobs) +``` ```julia case = joinpath("example_systems/1_three_zones"); @@ -448,7 +449,7 @@ G2 = Plots.plot(recon[!,:hour], recon[!,:MW], linewidth=1.7, Plots.plot(G1,G2,layout=(2,1)) ``` -![svg](./files/t3_recon.svg) +![png](./files/t3_recon.png) Each color represents one of the representative weeks. @@ -624,7 +625,7 @@ scatter!(twinx(),obj_val_plot[:,1],times,color=:red,markeralpha=.5,label=:"Time" ygrid!(:on, :dashdot, 0.1) ``` -![svg](./files/t3_obj_val.svg) +![svg](./files/t3_obj_vals.svg) Here, we can see that while having very few representative periods produces an objective value that differs greatly from the orignal, once we reach around 12 representative periods the difference begins to taper out. Therefore, the original choice of 11 maximum periods in `1_three_zones` decreases the run time of GenX significantly while while maintaining an objective value close to the original. @@ -658,4 +659,5 @@ for folder in folders if length(folder) >= 7 && folder[1:7] == "results" rm("example_systems/1_three_zones/" * folder,recursive=true) end -end``` +end +``` diff --git a/docs/src/Tutorials/Tutorial_5_solve_model.md b/docs/src/Tutorials/Tutorial_5_solve_model.md index 8a4ab67147..d1a8327604 100644 --- a/docs/src/Tutorials/Tutorial_5_solve_model.md +++ b/docs/src/Tutorials/Tutorial_5_solve_model.md @@ -4,9 +4,7 @@ In Tutorial 4, we went over how the model is generated when GenX is run using `Run.jl`. In the function `run_genx_case_simple` (or multistage), after `generate_model` is called, `solve_model` is called to solve the EP. -```@raw html - -``` +![png](./files/runcase.png) In this tutorial, we go over how to use JuMP to solve a model, what it looks like to solve GenX, and how to edit the solver settings. diff --git a/docs/src/Tutorials/Tutorial_6_solver_settings.md b/docs/src/Tutorials/Tutorial_6_solver_settings.md index 17e9b8f5fd..a50f4b048b 100644 --- a/docs/src/Tutorials/Tutorial_6_solver_settings.md +++ b/docs/src/Tutorials/Tutorial_6_solver_settings.md @@ -59,7 +59,7 @@ inputs = GenX.load_inputs(setup, case) ### The HiGHS Solver -In the example files, the solver [HiGHS](https://highs.dev). HiGHS is freely available for all to use. Other solvers, such as [Gurobi](https://www.gurobi.com), are available for free for academics. For the purpose of this tutorial, we will be focusing on HiGHS. +In the example files, the solver is [HiGHS](https://highs.dev). HiGHS is freely available for all to use. Other solvers, such as [Gurobi](https://www.gurobi.com), are available for free for academics. For the purpose of this tutorial, we will be focusing on HiGHS. To set the solver preferences, go into the settings folder of your case and select the YAML file of the solver you're using. @@ -93,9 +93,7 @@ highs_settings = YAML.load(open(joinpath(case,"Settings/highs_settings.yml"))) The function `configure_highs` in `src/configure_solver` contains a list of default settings for the HiGHS solver -```@raw html - -``` +![png](./files/highs_defaults.png) There are about 80, so we'll only focus on a few for now. In most cases, you can leave the other settings on default. @@ -158,6 +156,8 @@ Plots.scatter(tols[2:end], abs.(OV[2:end] .- OV[1]),legend=:topleft, ygrid!(:on, :dashdot, 0.1) ``` +![svg](./files/t6_tols.svg) + ### PreSolve In optimization, presolve is a stage at the beginning of the solver in which the problem is simplified to remove redunant constraints and otherwise simplify the problem before the optimization itself begins. The default for presolve in GenX is "choose", allowing the solver to use presolve only if it will reduce computation time. diff --git a/docs/src/Tutorials/Tutorial_8_outputs.md b/docs/src/Tutorials/Tutorial_8_outputs.md index c1b6f8ee19..addbc39471 100644 --- a/docs/src/Tutorials/Tutorial_8_outputs.md +++ b/docs/src/Tutorials/Tutorial_8_outputs.md @@ -868,8 +868,3 @@ Finally, set the CO2 Cap back to 2: genx_settings_TZ["CO2Cap"] = 2 YAML.write_file((joinpath(case,"settings/genx_settings.yml")), genx_settings_TZ) ``` - - -```julia - -``` diff --git a/docs/src/Tutorials/files/t3_recon.png b/docs/src/Tutorials/files/t3_recon.png new file mode 100644 index 0000000000000000000000000000000000000000..69889d67895c6993be5d954a711e283e00d53e51 GIT binary patch literal 77105 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 cN}_QQA1lT^(T<)vq52Js(}9eshlcto6_2 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 literal 0 HcmV?d00001 diff --git a/docs/src/Tutorials/files/t3_recon.svg b/docs/src/Tutorials/files/t3_recon.svg deleted file mode 100644 index 3293cdb9bc..0000000000 --- a/docs/src/Tutorials/files/t3_recon.svg +++ /dev/null @@ -1 +0,0 @@ -0500100015002000250030003500400045005000550060006500700075008000850002000400060008000100001200014000160001800005001000150020002500300035004000450050005500600065007000750080008500020004000600080001000012000140001600018000Time Step (Hours)Demand (MW)Demand (MW)Reconstruction, Extreme Periods OffReconstruction, Extreme Periods On \ No newline at end of file diff --git a/docs/src/Tutorials/files/t6_tols.svg b/docs/src/Tutorials/files/t6_tols.svg new file mode 100644 index 0000000000..949a3bee6d --- /dev/null +++ b/docs/src/Tutorials/files/t6_tols.svg @@ -0,0 +1 @@ +0.0000.0250.0500.0750.10005.00×10⁻¹²1.00×10⁻¹¹1.50×10⁻¹¹2.00×10⁻¹¹2.50×10⁻¹¹ErrorToleranceErrorTolerance of Solver vs Error \ No newline at end of file