Version 5.0

[bockthom]

5.0

Announcement

• coronet is not compatible with igraph versions below 2.1.0 anymore. This is due to the simultaneous deprecation of subgraph.edges and the introduction of the replacement for it, subgraph_from_edges, in igraph version 2.1.0.
• The plotting module of coronet is not compatible with ggplot2 versions below 3.5.0 anymore. This is due to the simultaneous deprecation of the scale_name parameter of discrete_scale (which is used within the function plot.network of coronet) in ggplot2 version 3.5.0.

Added

• Add commit-interaction data and add functions read.commit.interactions for reading, as well as get.commit.interactions, set.commit.interactions, and utility functions for working with commit-interaction data (PR Adding commit-interactions #252, d82857f, b4fd2a2, fd0aa05, bca3576, PR Add Commit Networks #263, 849123a, 3fb7437, 170bc66, f591528) as well as tests for these features (PR Adding commit-interactions #252, eeba7e2, 8bb39f4, 54b6f65, 7a5497a, 7b8585f, ef72540)
• Add commit-interaction networks that can be created with create.author.network or create.artifact.network if the artifact.relation or author.relation is configured to be commit.interaction (PR Adding commit-interactions #252, d82857f, 329d97e) as well as tests for these features (PR Adding commit-interactions #252, 07e7ed7, 7068cfa)
• Add commit network as a new type of network. It uses commits as vertices and connects them either via cochange or commit interactions. This includes adding new configuration parameters and the function add.vertex.attribute.commit.network for adding vertex attributes to a commit network (PR Add Commit Networks #263, ab73271, ab73271, cd9a930)
• Add the possibility to split data time-based by multiple data sources (PR Allow time-based data-splitting with multiple datasources as 'split.basis' #261, 1088395, e1f79fc, 0bb187f, 371a97a)
• Add remove.duplicate.edges function that takes a network as input and conflates identical edges (PR Miscellaneous improvements regarding network splitting and simplification #268, d9a4be4, 0c2f47c, c6e90dd)
• Add cumulative as an argument to construct.ranges which enables the creation of cumulative ranges from given revisions (PR Miscellaneous improvements regarding network splitting and simplification #268, a135f6b, 8ec207f)
• Add function get.last.activity.data to compute developers' last activities in a project, as well as function add.vertex.attribute.author.last.activity to add a developer's date of last activity as vertex attribute to a network, as well as helper functions get.aggregated.activity.data and add.vertex.attribute.author.aggregated.activity to allow for other activity aggregations than first and last activity (PR Add functions to compute a developer's last activity #275, 9f23161, 8660ed7)
• Add four new metrics that can be used for the classification of authors into core and peripheral: betweenness, closeness, pagerank, and eccentricity (PR Additional Core/Peripheral Classification Methods #276, e27acb5, 2178808)
• Add helper function for prefixing function names with file names in util-read.R (PR Adding commit-interactions #252, f8ea987)
• Add line-based code coverage reports into CI pipeline. Coverage reports are generated by coverage.R (PR Integrate code coverage metric into CI #262, 10cac49, b3b9f4a, c815d18, e809352, 32d0482)
• Add tests for uncovered functionality in util-misc.R and util-networks.R (PR Fix igraph deprecation warnings as well as a bug in issue network construction #264, ff30f32, af80551)

Changed/Improved

• Breaking Change: Change the default representation of edge attributes from vectors to lists. This change is necessary for the interplay of coronet networks with certain igraph functionality since igraph version 2.1.0 (PR Change default representation of edge attributes from vectors to lists & other miscellaneous adjustments #274, 1c35d1f, eda30b8, 0c6b2eb, 44c7b72, 7303eab, 0c27012)
• Change the default value for the issues.from.source configuration parameter. Instead of reading JIRA and GitHub issues together, which was the previous default, the new default value causes only GitHub issue data to be read. To restore the previous default behavior and read data from both issue sources, this now needs to be manually configured when needed. (PR Fix igraph deprecation warnings as well as a bug in issue network construction #264, 5ff83c3, 8c8080c, 8bcbc81)
• Replace deprecated igraph functions by their preferred alternatives (PR Fix igraph deprecation warnings as well as a bug in issue network construction #264, PR Miscellaneous improvements regarding network splitting and simplification #268, PR Change default representation of edge attributes from vectors to lists & other miscellaneous adjustments #274, PR Replace deprecated function calls and parameters #279, 0df9d5b, 7ac840d, e3617b8, 4b0d522, f29662b)
• Remove deprecated parameter of ggplot2::discrete_scale (PR Replace deprecated function calls and parameters #279, 027ce79)
• Deprecate support for R version 3.6 (PR Fix igraph deprecation warnings as well as a bug in issue network construction #264, c8e6f45, fb3f547)
• Explicitly add R version 4.4 to the CI test pipeline (c8e6f45)
• Refactor function construct.edge.list.from.key.value.list to be more readable (PR Add Commit Networks #263, 05c3bc0)
• Update necessary igraph version to 2.1.0 in README.md (PR Change default representation of edge attributes from vectors to lists & other miscellaneous adjustments #274, 6c3bcd1)
• Update necessary ggplot2 version to 3.5.0 in README.md (PR Replace deprecated function calls and parameters #279, 027ce79)
• Include core/peripheral classification inREADME.md (PR Additional Core/Peripheral Classification Methods #276, 6101e11, c6744c0, 5fc2da5)

Fixed

• Fix the creation of edgelists for issue-based artifact-networks by correctly iterating over the issue data (PR Fix igraph deprecation warnings as well as a bug in issue network construction #264, 321d850)
• Add range information to network-splits when splitting a network using split.network.time.based.by.ranges. This effect also propagates into split.networks.time.based (PR Change default representation of edge attributes from vectors to lists & other miscellaneous adjustments #274, 87911ad)
• Fix a bug in extract.timestamps that occurs when the first data.source contains empty data and that leads to a return value of type numeric which should be POSIXct (PR Fix a bug in 'extract.timestamps' when dealing with an empty data source #270, 10696e4, 646c01a)
• Adjust metrics.scale.freeness and metrics.is.scale.free functions to be compatible with both older and newer igraph versions (PR Change default representation of edge attributes from vectors to lists & other miscellaneous adjustments #274, 4b0d522)

[codecov]

Codecov Report

Attention: Patch coverage is 91.45729% with 51 lines in your changes missing coverage. Please review.

Please upload report for BASE (master@49c0d2c). Learn more about missing BASE report.

Files with missing lines	Patch %	Lines
util-plot.R	0.00%	14 Missing ⚠️
util-networks.R	96.09%	13 Missing ⚠️
util-networks-metrics.R	0.00%	10 Missing ⚠️
util-data.R	90.27%	7 Missing ⚠️
util-bulk.R	0.00%	4 Missing ⚠️
util-read.R	94.64%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff            @@
##             master     #280   +/-   ##
=========================================
  Coverage          ?   81.69%           
=========================================
  Files             ?       16           
  Lines             ?     5146           
  Branches          ?        0           
=========================================
  Hits              ?     4204           
  Misses            ?      942           
  Partials          ?        0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[bockthom]

Heartfelt thanks to @Leo-Send, @maxloeffler, and @hechtlC for your contributions to this amazing new release of coronet! I will merge right away and release our new version.