apsimNGpy Documentation

apsimNGpy: The Next-Generation Agro-ecosystem Simulation Library

apsimNGpy is a cutting-edge, open-source framework designed for advanced agroecosystem modeling. Built on object-oriented principles, it provides:

• Fast batch file simulation

• Model prediction and evaluation

• Seamless APSIMX file editing

• Weather data retrieval

• Efficient soil profile development

Table of Contents

• Home
• Installation
• Quick guides
• Locating the APSIM Binaries
• Changing/setting the APSIM installation binaries path
  • 1. Manually configure the APSIM binary path. To do this:
  • 2. Change based os.environ module
  • 3. Use the apsimNGpy config module:
  • 4. Use command line interface
    • Now that the path is set, you can import any module attached to pythonnet.
• Examples
• Inspect Model
  • Model Types
  • Finding the Model Type
• Whole Model inspection
  • Note on Model Inspection:
• Command-Line Usage Guide
  • Usage
  • Options
  • Example Usage
  • Logging
  • Troubleshooting
• Quick and Simple Way to Run Factorial Experiments
  • Setting Up the Environment
  • Creating an Experiment
  • Adding Factors
  • Running the Experiment
  • Factorial Experiment with Cultivar Replacements
  • Conclusion
• apsimNGpy: API Reference
• ApsimModel
  • apsimNGpy.core.apsim.ApsimModel()
  • apsimNGpy.core.apsim.ApsimModel.adjust_dul()
  • apsimNGpy.core.apsim.ApsimModel.auto_gen_thickness_layers()
  • apsimNGpy.core.apsim.ApsimModel.get_initial_no3()
  • apsimNGpy.core.apsim.ApsimModel.replace_downloaded_soils()
  • apsimNGpy.core.apsim.ApsimModel.run_edited_file()
  • apsimNGpy.core.apsim.ApsimModel.spin_up()
• CoreModel
  • apsimNGpy.core.core.CoreModel()
  • apsimNGpy.core.core.CoreModel.add_crop_replacements()
  • apsimNGpy.core.core.CoreModel.add_factor()
  • apsimNGpy.core.core.CoreModel.add_model()
  • apsimNGpy.core.core.CoreModel.add_report_variable()
  • apsimNGpy.core.core.CoreModel.change_report()
  • apsimNGpy.core.core.CoreModel.change_simulation_dates()
  • apsimNGpy.core.core.CoreModel.change_som()
  • apsimNGpy.core.core.CoreModel.clean_up()
  • apsimNGpy.core.core.CoreModel.configs()
  • apsimNGpy.core.core.CoreModel.create_experiment()
  • apsimNGpy.core.core.CoreModel.edit_cultivar()
  • apsimNGpy.core.core.CoreModel.examine_management_info()
  • apsimNGpy.core.core.CoreModel.extract_any_soil_organic()
  • apsimNGpy.core.core.CoreModel.extract_any_soil_physical()
  • apsimNGpy.core.core.CoreModel.extract_crop_soil_water()
  • apsimNGpy.core.core.CoreModel.extract_soil_physical()
  • apsimNGpy.core.core.CoreModel.extract_soil_property_by_path()
  • apsimNGpy.core.core.CoreModel.extract_start_end_years()
  • apsimNGpy.core.core.CoreModel.extract_user_input()
  • apsimNGpy.core.core.CoreModel.find_model()
  • apsimNGpy.core.core.CoreModel.get_crop_replacement()
  • apsimNGpy.core.core.CoreModel.get_current_cultivar_name()
  • apsimNGpy.core.core.CoreModel.get_model_paths()
  • apsimNGpy.core.core.CoreModel.get_report()
  • apsimNGpy.core.core.CoreModel.inspect_file()
  • apsimNGpy.core.core.CoreModel.inspect_model()
  • apsimNGpy.core.core.CoreModel.move_model()
  • apsimNGpy.core.core.CoreModel.preview_simulation()
  • apsimNGpy.core.core.CoreModel.recompile_edited_model()
  • apsimNGpy.core.core.CoreModel.remove_model()
  • apsimNGpy.core.core.CoreModel.rename_model()
  • apsimNGpy.core.core.CoreModel.replace_soil_property_values()
  • apsimNGpy.core.core.CoreModel.replace_soils_values_by_path()
  • apsimNGpy.core.core.CoreModel.replicate_file()
  • apsimNGpy.core.core.CoreModel.restart_model()
  • apsimNGpy.core.core.CoreModel.run()
  • apsimNGpy.core.core.CoreModel.save()
  • apsimNGpy.core.core.CoreModel.save_edited_file()
  • apsimNGpy.core.core.CoreModel.set_categorical_factor()
  • apsimNGpy.core.core.CoreModel.set_continuous_factor()
  • apsimNGpy.core.core.CoreModel.show_met_file_in_simulation()
  • apsimNGpy.core.core.CoreModel.update_cultivar()
  • apsimNGpy.core.core.CoreModel.update_mgt()
  • apsimNGpy.core.core.CoreModel.update_mgt_by_path()
• apsimNGpy.core.base_data
  • apsimNGpy.core.config.get_apsim_bin_path()
  • apsimNGpy.core.base_data.load_default_sensitivity_model()
  • apsimNGpy.core.base_data.load_default_simulations()
  • apsimNGpy.core.apsimSoilModel
• apsimNGpy.core.load_model
• apsimNGpy.core.runner
  • apsimNGpy.core.runner.collect_csv_by_model_path()
  • apsimNGpy.core.runner.collect_csv_from_dir()
  • apsimNGpy.core.config.get_apsim_bin_path()
  • apsimNGpy.core.runner.get_apsim_version()
  • apsimNGpy.core.runner.run_from_dir()
  • apsimNGpy.core.runner.run_model_externally()
  • apsimNGpy.core.runner.upgrade_apsim_file()
• apsimNGpy.core.structure
  • apsimNGpy.core.structure.add_model()
  • apsimNGpy.core.structure.find_model()
  • apsimNGpy.core.base_data.load_default_simulations()
  • apsimNGpy.core.structure.remove_model()
  • apsimNGpy.core.apsimApsimModel
• apsimNGpy.manager.soilmanager
  • apsimNGpy.manager.soilmanager.DownloadsurgoSoiltables()
  • apsimNGpy.manager.soilmanager.set_depth()
• apsimNGpy.manager.weathermanager
  • apsimNGpy.manager.weathermanager.daterange()
  • apsimNGpy.manager.weathermanager.day_of_year_to_date()
  • apsimNGpy.manager.weathermanager.get_iem_by_station()
  • apsimNGpy.manager.weathermanager.get_met_from_day_met()
  • apsimNGpy.manager.weathermanager.get_weather()
  • apsimNGpy.manager.weathermanager.impute_data()
  • apsimNGpy.manager.weathermanager.merge_columns()
• apsimNGpy.validation.evaluator
  • apsimNGpy.validation.evaluatorMetrics
  • apsimNGpy.validation.evaluatorvalidate