Add tsam to datapackage

[nailend]

Description

Tsam option is now available for tabular reading module, but only for multi-period approach.
Parameters need to be provided by two separate csvs.

• tsa_paramters (period, timesteps_per_period, order)

• add example

• adjust timeseries data of example

Fixes #138

Type of change

Please tick or delete options that are not relevant.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

Checklist:

Please tick or delete options that are not relevant.

• New and adjusted code is formatted using the pre-commit hooks
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• I have added new features/fixes to the CHANGELOG

[henhuy]

Structure in datapackage looks good to me!

But I have failing tests on my side:

• test_example_datapackage_readability
• test_scripting_examples
• test_examples_datapackages_scripts_infer

Do the tests also fail on your side?

[henhuy]

Why did yo mark it as "breaking change"? IMO, this should not interfere with older tabular versions?!

[nailend]

Why did yo mark it as "breaking change"? IMO, this should not interfere with older tabular versions?!

I guess, I slipped...

Do the tests also fail on your side?

yes, I still have to adjust the component timeseries.

[henhuy]

When looking into TSAm parameters of example datapackage "dispatch_multi_period_tsam", I found that third period has an invalid order (containing 3 different typical periods, which would sum up to 6 timesteps in third period, but only 4 are given) which must normally lead to an error when building energysystem. Thus, I wondered why no error is thrown - on my side, this was due to wrong oemof.solph version (one which does not include TSAM parameters - so that they are neglected when building ES ergo no error is thrown). Updating oemof.solph, pointing to branch feature/integrate_tsam unfortunately lead to dependency issues as oemof.networkand oemof.tools versions are not correctly pinned in oemof.solph. After manually fixing those versions, I finally could see the error resulting from invalid TSAM parameters - but unfurtunately, now I can see multiple other errors in other tests (regarding wrong LP-files and stuff).
I think, in order to finalize this PR, we should do following:

• fix dependencies in oemof.solph
• fix TSAM parameters in example
• look into errors from other tests and check if they belong into this PR or have to be adapted in other PR (as bringing oemof.tabular in line with latest oemof.solph version)

[FelixMau]

Regarding changed LP files please see #155

[nailend]

This will only be merged after tsam-branch in solph is merged.