{"id":1252,"date":"2023-12-10T04:09:23","date_gmt":"2023-12-10T09:09:23","guid":{"rendered":"https:\/\/pressbooks.bccampus.ca\/eweguide\/?post_type=chapter&p=1252"},"modified":"2024-05-23T16:55:18","modified_gmt":"2024-05-23T20:55:18","slug":"results-extractor","status":"publish","type":"chapter","link":"https:\/\/pressbooks.bccampus.ca\/eweguide\/chapter\/results-extractor\/","title":{"raw":"Results Extractor","rendered":"Results Extractor"},"content":{"raw":"

Introduction<\/h1>\r\nThe Results Extractor<\/em> was developed in response to the need users have, to easily retrieve data and\u00a0 parameter values from within EwE6. This chapter will explain how to use the Results Extractor<\/em> to\u00a0 do this.\r\n\r\nIn most cases the language used for titles of options is explained in this EwE User Guide. Only\u00a0 where the language and functionality is new will an explanation be given here.\r\n

Starting the Results Extractor<\/h1>\r\nThe Results Extractor can only be started after Ecosim has been run. After Ecosim has been run, it can be started by selecting Menu > <\/em>Tools > Results Extractor<\/em>. After the Results Extractor<\/em> has been started, you will be presented with a window of checkboxes.\r\n\r\n[caption id=\"attachment_1253\" align=\"aligncenter\" width=\"645\"]\"\" Figure 1<\/b> - Results Extractor start-up interface for settings.[\/caption]\r\n\r\nSimply check all boxes for the data and parameter values that you would like to retrieve from within EwE.\r\n

Selection Windows<\/h2>\r\nFor some checkboxes a selection window will be opened. Figure 2 shows the selection window that opens when you click on Biomass<\/em>.\r\n\r\nThese selection windows are how you select which functional groups and fleets you want the data\u00a0 and parameter values for. Simply double click on a group or use the arrows at the bottom to move\u00a0 the groups you want output for.\r\n\r\n[caption id=\"attachment_1265\" align=\"aligncenter\" width=\"530\"]\"\" Figure 2<\/b> - Selection window, here anchovy has been selected.[\/caption]\r\n\r\nSome selection windows have three columns like this window that opens when you click on Consumption<\/em> as you need to select both predators and prey. So, when you are getting output for Consumption, you first select which predators you are interested, and then for each predator you\u00a0 have selected, you select which prey you want consumption values for.\r\n

Option Groupings<\/h1>\r\nThe checkboxes have been visually grouped together in a box. An example is the Functional groups only<\/em> top left section in Figure 1. When the checkboxes that are grouped together in a box that has a Change Selection<\/em> button, it\u00a0 means that whatever selection is made in the selection window, will apply to all other checked\u00a0 options within that group. Selections can also be modified for that group by clicking on the Change\u00a0 Selection<\/em>\u00a0button to re-open the selection window.\r\n

Biomass Integrated Checkbox<\/h1>\r\nBiomass integrated<\/em> has been introduced as a quantity that can be used to compare two different\u00a0 management strategies. It works by subtracting the initial biomass from the biomass at each time\u00a0 step to give the change from initial biomass. The area under the time series for change from initial\u00a0 biomass is then calculated.\r\n\r\nThis is helpful because it indicates not just what the difference is between the initial and final\u00a0 biomass but also incorporates what the biomass has been throughout the time series. The benefit of\u00a0 this can best be seen by imagining two different biomass time series, A and B, each being the result\u00a0 of a different management strategy. Each time series starts and finishes at the same point, but time series A spends most of the time above the initial biomass, whilst time series B spends most of the time below the initial biomass. If we just compared the two management strategies by comparing\u00a0 the final biomass values or initial\/final biomass the indicator calculated would suggest no preference between the two strategies, whilst the integrated method would suggest that strategy A would be the preferable strategy as it leads to a higher biomass on average over the time period.\r\n

Consumption<\/h2>\r\nThe Consumption<\/em> option retrieves the values required to calculate the rate of consumption of a\u00a0 predator on a prey and outputs the calculated result. Consumption is given as an absolute rate of consumption not a relative rate of consumption. The equation used for calculation is,\r\n

[latex]Q_{ji} = B_j \\ (Q\/B)_j \\ DC_{ji} \\tag{1}[\/latex]<\/p>\r\nWhere Qji<\/sub><\/em> is consumption rate of predator j<\/em> on prey i<\/em>, Bj<\/sub><\/em> the biomass of predator j<\/em>, (Q\/B<\/em>)j<\/em><\/sub> is the consumption\/biomass ratio for predator j<\/em>, \u00a0and DCji<\/sub><\/em> \u00a0is the percentage of predator j<\/em>\u2019s diet\u00a0 that is prey i<\/em>.\r\n

Fitting Statistics<\/h1>\r\nThe first option is the residual option. As the name suggests this produces output for the time series\u00a0 of residuals for each functional group. This can be helpful in identifying where in a time series the\u00a0 model differs most from the data.\r\n\r\nThe second option is the SS<\/em> or sum of squares option. This gives output of the sum of squares for all\u00a0 function groups as well as an overall SS value for the whole model.\r\n

Yearly<\/h1>\r\nWhen you select this option the Results Extractor<\/em> will calculate and output the values for each year\u00a0 rather than each month for all time series outputs. This is done by calculating the mean over the\u00a0 year.\r\n

All Options<\/h1>\r\nYou can click on this option if you want the Results Extractor<\/em> to retrieve everything (i.e. tick all\u00a0 boxes). After you have clicked on it, you will be taken through all the selection windows required to\u00a0 select all options. When this process is complete, all options will be checked.\r\n

References<\/h1>\r\nThe Results Extractor was developed by CEFAS","rendered":"

Introduction<\/h1>\n

The Results Extractor<\/em> was developed in response to the need users have, to easily retrieve data and\u00a0 parameter values from within EwE6. This chapter will explain how to use the Results Extractor<\/em> to\u00a0 do this.<\/p>\n

In most cases the language used for titles of options is explained in this EwE User Guide. Only\u00a0 where the language and functionality is new will an explanation be given here.<\/p>\n

Starting the Results Extractor<\/h1>\n

The Results Extractor can only be started after Ecosim has been run. After Ecosim has been run, it can be started by selecting Menu > <\/em>Tools > Results Extractor<\/em>. After the Results Extractor<\/em> has been started, you will be presented with a window of checkboxes.<\/p>\n

\"\"
Figure 1<\/b> – Results Extractor start-up interface for settings.<\/figcaption><\/figure>\n

Simply check all boxes for the data and parameter values that you would like to retrieve from within EwE.<\/p>\n

Selection Windows<\/h2>\n

For some checkboxes a selection window will be opened. Figure 2 shows the selection window that opens when you click on Biomass<\/em>.<\/p>\n

These selection windows are how you select which functional groups and fleets you want the data\u00a0 and parameter values for. Simply double click on a group or use the arrows at the bottom to move\u00a0 the groups you want output for.<\/p>\n

\"\"
Figure 2<\/b> – Selection window, here anchovy has been selected.<\/figcaption><\/figure>\n

Some selection windows have three columns like this window that opens when you click on Consumption<\/em> as you need to select both predators and prey. So, when you are getting output for Consumption, you first select which predators you are interested, and then for each predator you\u00a0 have selected, you select which prey you want consumption values for.<\/p>\n

Option Groupings<\/h1>\n

The checkboxes have been visually grouped together in a box. An example is the Functional groups only<\/em> top left section in Figure 1. When the checkboxes that are grouped together in a box that has a Change Selection<\/em> button, it\u00a0 means that whatever selection is made in the selection window, will apply to all other checked\u00a0 options within that group. Selections can also be modified for that group by clicking on the Change\u00a0 Selection<\/em>\u00a0button to re-open the selection window.<\/p>\n

Biomass Integrated Checkbox<\/h1>\n

Biomass integrated<\/em> has been introduced as a quantity that can be used to compare two different\u00a0 management strategies. It works by subtracting the initial biomass from the biomass at each time\u00a0 step to give the change from initial biomass. The area under the time series for change from initial\u00a0 biomass is then calculated.<\/p>\n

This is helpful because it indicates not just what the difference is between the initial and final\u00a0 biomass but also incorporates what the biomass has been throughout the time series. The benefit of\u00a0 this can best be seen by imagining two different biomass time series, A and B, each being the result\u00a0 of a different management strategy. Each time series starts and finishes at the same point, but time series A spends most of the time above the initial biomass, whilst time series B spends most of the time below the initial biomass. If we just compared the two management strategies by comparing\u00a0 the final biomass values or initial\/final biomass the indicator calculated would suggest no preference between the two strategies, whilst the integrated method would suggest that strategy A would be the preferable strategy as it leads to a higher biomass on average over the time period.<\/p>\n

Consumption<\/h2>\n

The Consumption<\/em> option retrieves the values required to calculate the rate of consumption of a\u00a0 predator on a prey and outputs the calculated result. Consumption is given as an absolute rate of consumption not a relative rate of consumption. The equation used for calculation is,<\/p>\n

[latex]Q_{ji} = B_j \\ (Q\/B)_j \\ DC_{ji} \\tag{1}[\/latex]<\/p>\n

Where Qji<\/sub><\/em> is consumption rate of predator j<\/em> on prey i<\/em>, Bj<\/sub><\/em> the biomass of predator j<\/em>, (Q\/B<\/em>)j<\/em><\/sub> is the consumption\/biomass ratio for predator j<\/em>, \u00a0and DCji<\/sub><\/em> \u00a0is the percentage of predator j<\/em>\u2019s diet\u00a0 that is prey i<\/em>.<\/p>\n

Fitting Statistics<\/h1>\n

The first option is the residual option. As the name suggests this produces output for the time series\u00a0 of residuals for each functional group. This can be helpful in identifying where in a time series the\u00a0 model differs most from the data.<\/p>\n

The second option is the SS<\/em> or sum of squares option. This gives output of the sum of squares for all\u00a0 function groups as well as an overall SS value for the whole model.<\/p>\n

Yearly<\/h1>\n

When you select this option the Results Extractor<\/em> will calculate and output the values for each year\u00a0 rather than each month for all time series outputs. This is done by calculating the mean over the\u00a0 year.<\/p>\n

All Options<\/h1>\n

You can click on this option if you want the Results Extractor<\/em> to retrieve everything (i.e. tick all\u00a0 boxes). After you have clicked on it, you will be taken through all the selection windows required to\u00a0 select all options. When this process is complete, all options will be checked.<\/p>\n

References<\/h1>\n

The Results Extractor was developed by CEFAS<\/p>\n","protected":false},"author":1909,"menu_order":21,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"chapter-type":[],"contributor":[],"license":[],"class_list":["post-1252","chapter","type-chapter","status-publish","hentry"],"part":441,"_links":{"self":[{"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/pressbooks\/v2\/chapters\/1252","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/wp\/v2\/users\/1909"}],"version-history":[{"count":14,"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/pressbooks\/v2\/chapters\/1252\/revisions"}],"predecessor-version":[{"id":1745,"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/pressbooks\/v2\/chapters\/1252\/revisions\/1745"}],"part":[{"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/pressbooks\/v2\/parts\/441"}],"metadata":[{"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/pressbooks\/v2\/chapters\/1252\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/wp\/v2\/media?parent=1252"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/pressbooks\/v2\/chapter-type?post=1252"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/wp\/v2\/contributor?post=1252"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/eweguide\/wp-json\/wp\/v2\/license?post=1252"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}