Daylight | Cloud | 2020-12-19



Enhancements

Fixes

Deprecations


Single sidebar: Tabs move to top of sidebar

With this release, we move the sidebar tabs to the top of the sidebar to maximize real estate in the app. We also exchanged the order of the Configure visualization and Filter documents tabs.


Single sidebar: Improved layout for Configure visualization tab

With this release, we add some layout changes to the Configure visualization tab that help make it easier to use, both on its own, and in relation to the rest of Daylight. Now, the tab:

  • Displays the Number of concepts dropdown to the right of the label.

  • Always displays the Number of concepts value.

  • Includes a link to the Active concepts tab below the Active Concepts selector.

  • Includes a link to the Filter documents tab below the Unique to this filter selector.


Settings: Settings page now accessible only from the upper right corner

With this release, the Settings page is now only accessible from the upper right corner, under your username. This also means that the “Project” hyperlink with a downward facing arrow was removed.

Now, open the Projects page by clicking the Luminoso icon in the top ribbon.


Highlights: Updated locations for project management buttons

With this release, we remove the Project details card from Highlights, and change some of the actions you could take there into new buttons for:

  • Upgrade science (only available when your science is not up-to-date)

  • Upload more

  • Copy project

  • Delete project


Settings: Updated organization of sidebar

Now, the Settings page navigation is organized into Personal settings, Team settings, and Support sections to help you navigate more easily.

We also added more documentation links to the Support section.


Account management: SAML users no longer have issues accepting invitations to Daylight

SAML users were having problems accepting invitations, due to a problem on the backend. This bug is fixed.


Project management: Displays more accurate message when a filter is too small

We replaced an error message that appeared when a filter was too small to display any concepts with a new one that’s more accurate. The new message reads:

  • "The documents in the current filter don't have enough concepts to display. Try changing or clearing the filter."


API: All v4 endpoints are now marked as deprecated

With this release, all v4 API endpoints are marked as deprecated. The deprecation date for cloud users is planned for 2021-06-19. As of this release, all v4 functionality is duplicated in the v5 API, with the exception of:

  • "Log in" and "Log out". These endpoints do not have v5 equivalents, since the Luminoso API Client allows you to log in for long enough to get a permanent API token. After you get a permanent API token, you don’t need to log in again.

We recommend transitioning any v4 use to the equivalent v5 endpoints. Read about any remaining v4 functionality and how you can replicate it in v5 in the v4 API documentation.

Explore the v5 API functionality in the API documentation.


API: exact_only removed from API 2020-12-19

With this release, we remove the exact_only parameter from the API. It was initially marked for deprecation a year ago.



Daylight | Cloud | 2020-12-05


Enhancements

  • Search: Advanced Concept Search becomes universal default

  • Single sidebar: Streamlined shared concept list layout

  • Single sidebar: Improvements to Configure visualization tab

  • Single sidebar: Search details tab now sorts concepts by prevalence

  • API: v4 Endpoints removed

  • API: Updates to Shared concept list endpoints

  • API: Formatting improvements for concept list names

  • Drivers: Removed concept-by-concept selection for visible drivers

  • Project management: Improved messaging around project build completion


Fixes

  • Sentiment: The read more toggle no longer turns off if you scroll down or move your mouse away

  • API: 500 error bug resolved


Search: Advanced Concept Search becomes universal default

We released Advanced Concept Search in June 2020 as a user-selectable option to enhance the Daylight search experience.

With this release, Advanced Concept Search is the default search option. Any User who had previously set a preference on the Setting page will be unaffected and continue to see their selected search option. This change affects customers in one of two ways:

  • If at least one user in an organization used the Advanced Concept Search toggle to make a selection, then any user who did not make a selection defaults to Advanced Concept Search. All users in the organization have access to the toggle.

  • If no users in the organization made an Advanced Concept Search selection, all users now default to Advanced Concept Search, and do not have access to the toggle.

If you have questions about this change, please contact support@luminoso.com or your Luminoso CSM.

For organizations with access to the toggle, users can set a search preference by opening Settings from the dropdown next to Projects in the top ribbon, using the toggle at the bottom of the User profile tab, and clicking Save changes.


Single sidebar: Streamlined shared concept list management


With this release, we streamline the UI for shared concept list management.

  • All shared concept list management tools are now grouped under the same expandable section

  • Now, to rename a list, you must click the rename pencil button next to the list name before you can enter any text

  • The delete button is now located next to next to the rename button:


  • All shared concept list management tools are now grouped under the same expandable section

  • Now, to rename a list, you must click the rename pencil button next to the list name before you can enter any text

  • The delete button is now located next to next to the rename button:


API: v4 Endpoints removed

With this, the v4 API endpoints that had a sunset date of 2020-12-05 are now removed.


API: Updates to Shared concept list endpoints


We made some updates to the Shared concept list API endpoints.

Now, you can use "overwrite" as a parameter for the "Create shared concept list" endpoint. Read more in the Create shared concept list section of the API documentation.

You can also add "name" as an option for concept_list selector. You can read more about this option in the Concept selector section of the API documentation.


API: Formatting improvements for concept list names

With this release, we add an improvement that strips white space from concept list names. Additionally, blank concept list names are no longer permitted in the API.


Drivers: Updated viewable drivers selection process

With this release, we change the way you select which drivers you see in the Drivers scatterplot. Previously, you could use the selection options and eye icons in the Concepts tab of Drivers to select which drivers displayed in the scatterplot.

Now, use the Configure visualization and Active concept tabs to determine which concepts you’ll see in Drivers.


If you’re using Autosuggest, you can select 10, 20, or 50 AI-identified drivers to view. Otherwise, select Active concepts to use your list of active concepts or a copy of a shared concept list. When you add or remove concepts in your active concept list, the change is immediately reflected in Drivers.


Project management: Completed build opens project immediately

In response to client feedback, we’ve updated the project build page to take you directly to a new project once it’s done building.


Sentiment: The read more toggle no longer turns off if you scroll down or move your mouse away

Now, the Read more toggle in Sentiment no longer turns off if you scroll down or move your mouse away.


API: 500 error bug resolved

The API was returning a 500 error when it encountered a concept_list concept selector that had a bad ID.

Now, it instead returns a 400 INVALID_PARAM, the standard error when an invalid parameter is supplied to the API.




Daylight | Cloud | 2020-11-21


Enhancements


Fixes


Single sidebar: Updates to concept lists

After receiving some user feedback, we’re introducing a few changes to concept lists. Additional adjustments to the sidebar that will help maximize space in the app are targeted for future releases.

With this release, we updated some language to clarify that when you open a shared concept list, you are opening a copy of it into your Active concepts area, and changes you make to that copy are not saved until you click Share active concepts.

The Update concepts for all users button in the list name section now reads Update [list name] with active concepts. This change makes the outcome you’ll see after clicking the button clearer.


Additionally, this section’s title now reads “Copy of: [list name]”, to help make it clearer that your active concepts are a copy of the list, and any edits you make to your active concepts only affect the list once they are shared.

The Update [list name] with active concepts button is now also available in the Share active concepts section.


We also removed the Delete active concepts modal that appeared every time a user deleted a concept from their Active concepts space. Now, when you delete an active concept, it is simply removed from your Active concepts space. Select the concept and click + next to its nameor + Add to active concepts to add it back to the Active concepts list.


API: New endpoints for shared concept lists

With this release, we add new API endpoints to match the shared concept list functionality in the UI. Read the details in the Shared concept lists section of the API documentation.

The new endpoints are:

  • List shared concept lists

  • Get shared concept list details

  • Create shared concept list

  • Edit shared concept list details

  • Delete shared concept list

  • Add concepts to a list

  • Delete concepts from a list

  • Reorder concepts in a list

  • Modify selected concepts within a list

You can use these new endpoints to create, edit, delete, and retrieve shared concept lists. This new set of endpoints replicates the functionality that the Saved concept endpoints provided, except that concepts are returned as an array of concepts in the "concepts" field instead of a simple array.

You can use these endpoints before a project is built, since they don’t interact with a project’s science.

Finally, each concept in a shared list has a unique concept ID. Even if a concept’s name, texts, and color are identical to another concept in another list, the two concepts will have unique IDs.


API: Saved concept endpoint deprecations

With this release, we announce the deprecation of all Saved concept endpoints and “saved” as a type selector in all Concept endpoints. This deprecation is targeted for 2021-06-19.

The endpoints being deprecated are:

  • Get saved concepts

  • Create saved concepts

  • Modify saved concept order

  • Delete saved concepts

  • Update saved concepts

These endpoints will continue to function until their sunset date in June 2021, but we recommend beginning to transition your use to the new shared concept endpoints.

Though Luminoso strives to maintain backward compatibility at all times, the changes to this endpoint as part of shared concept lists, released on November 7, 2020, may create a possible breaking change if your organization uses the API and UI simultaneously.

Saved concept endpoints no longer point to the concept list previously displayed in the Saved concepts tab of the UI. Now, they point to a specific shared concept list named “Saved Concepts” (capitalization-insensitive) instead. See the Shared concept lists section of the API documentation for details.




Daylight | Cloud | 2020-11-07


New features


Enhancements


Collaborative concept lists

Luminoso is excited to announce Collaborative Concept Lists, the most recent set of usability improvements to Daylight. This change helps improve how users save and organize concepts in Daylight. It combines two changes – active concepts and shared concept lists – that work together to improve concept management and exploration.

Before this release:

  • You could save only one set of concepts per project, for all users.

  • When one user changed the saved concept list, it updated for all users.

  • You could use saved concepts to populate visualizations.

  • You interacted with saved concepts in the Select concepts tab

After this release:

  • Your existing saved concepts (if any) are converted to a shared concept list named with the date that the list was converted on. For most users, this date will be 2020-11-07, the date of the cloud release.

  • Anywhere that Daylight previously used “saved concepts,” you’ll now see “active concepts.'

  • Active concepts are applied for a single user.

  • You can save your active concepts as a shared concept list to come back to or share with other users.

  • Any user can save as many shared concept lists as they want.

  • Shared concept lists are accessible by any user who has access to the project.

  • You interact with active concepts in the Active concepts tab, in the same location as the Select concepts tab.


Active concepts and shared concept lists

Using active concepts is easy and is very similar to how you used saved concepts before. Add any concept to your active concept list by selecting a concept from a feature or the search bar, or by opening and editing an existing shared concept list. Then, save and share any group of active concepts you’d like to keep.


Active concepts:

  • Allow users to experiment with concepts in a private scratch space.

  • Encourage exploration of Daylight without fear of losing concepts or making permanent changes.

  • Let view-only users load shared concept lists and manipulate their own active concepts.

  • Are persistent after logging out and returning to a project.


Shared concept lists:

  • Provide better organization of concepts with Shared Concept lists.

  • Allow exploration of a single project using different lenses, such as service or emotion.

  • Enhance in-project collaboration for projects with multiple users.

  • Separate interesting dataset subsets without needing to create multiple Daylight projects.

Concepts remain in your active concepts list until you delete them or load a different shared concept list. You can add the same concept to multiple shared concept lists. For instance, if “smell” was relevant to two users’ lists, they could both add that concept to their lists. Concepts with the same name that are in multiple lists don’t update universally.

Changes that you make in your active concept space are not visible to other users until you save them to a shared concept list. When you select Active concepts in the Configure visualization tab, your current active concepts populate the information in Daylight’s analysis features, like saved concepts did previously.

Active concepts are persistent across features. Additionally, whatever active concepts you had loaded when you log out of Daylight are now present when you log back in.


Once you have one or more shared concept lists set up, you can copy one into your active concepts list to use its concepts in visualizations or to make edits to its contents.

You can create as many shared concept lists as you need in a project. Naming shared concept lists is flexible to meet your analysis and team needs.


To create a shared concept list with active concepts

Use Shared Concept Lists to create a better organization system for your concepts in Daylight and to improve your collaboration with other Daylight users. It’s easy to start using Active Concepts:

  1. Click Add to active concepts in the Active concepts tab to start a new set of active concepts.

  2. Add concepts to your Active Concept List until you have a list you want to save and share to other users. These Active Concepts aren’t visible to other users yet, but will stay in your Active Concept List until you delete them or load a different list. Note: An Active Concept List with unshared changes displays Unshared changes in italics in the concept list row.


To share and save your active concepts

  1. Open the Share active concepts dropdown, enter a name for your new list, and click Share. The list is saved to the project, and other users can now also work with it. The section that previously read Unshared changes now displays the name of your new shared concept list.

  2. Save a concept to as many concept lists as you want to. When you save a concept to a Shared Concept List, Daylight generates a new concept ID for it, so you can update that concept separately within the Shared Concept List.


To open a shared concept list

  1. Click Open shared concept list and select the name of the shared concept list you want to open from the menu.

  2. Click Open. A success banner appears and the concepts from that shared concept list appear in your Active concepts space.


To edit a shared concept list

  1. Open the Shared Concept List you want to edit

  2. Open the dropdown under the concept list’s name.

  3. Use this section to delete, rename, or update the list with any changes you’ve made to the concepts in it. Note: You can save

  4. After opening a list into your Active concepts and editing it, click Update concepts for all users to save an updated version of the list.


Shared concept lists in the API

This release does not include any changes to how you get concept lists from the API, but we want to clarify the interaction between multiple concept lists and the API.

For now, you can still access only one shared concept list from the API, which you can do through the existing interface for saved concepts .

If your project predates this release and contains a shared concept list that was previously the single saved concept list, the API returns that list. If you deleted the single saved concept list after multiple concepts were introduced, or if your project was created after this release, you create a new saved concept list through the API as you normally would for a project with no saved concepts.

Read more the API documentation on the Concepts endpoint and applying Concept Selectors in API documentation.

Later, we’ll update how you can create and access multiple lists of shared concepts through the API.


Science: Data updates may affect prevalence in Daylight

The data Daylight uses to determine prevalence have been expanded and updated, and may affect the prevalence rankings you see in Daylight. Prevalence is Luminoso’s term for how frequently a word appears in a specific dataset versus how frequently the word appears in a language as a whole.

As a result of the data expansion, prevalence numbers in Daylight now more accurately reflect a word’s use in a given language.

Since this is a change to Luminoso’s science, it will only affect projects that are created after the change went into effect, or projects that are rebuilt or updated after that date. This change will be included in Luminoso’s next science version.


Science: Data updates may affect prevalence in Daylight

The data Daylight uses to determine prevalence have been expanded and updated, and may affect the prevalence rankings you see in Daylight. Prevalence is Luminoso’s term for how frequently a word appears in a specific dataset versus how frequently the word appears in a language as a whole.

As a result of the data expansion, prevalence numbers in Daylight now more accurately reflect a word’s use in a given language.

Since this is a change to Luminoso’s science, it will only affect projects that are created after the change went into effect, or projects that are rebuilt or updated after that date. This change will be included in Luminoso’s next science version.



Highlights: Updated card order

With this release, we update the ordering of the cards on the Highlights feature. Now, feature summary cards are at the top of the page. This change helps orient you to the insights in your project first.


API: Saved concepts in branched and copied projects use the same concept ID

With this release, if you branch or copy a project in Daylight, saved concepts retain the concept ID that they had in the original project.




Daylight | Cloud | 2020-10-24



Enhancements

  • Sidebar: Export & share renamed to Export & link

  • API: v4 deprecation notice

  • Change password

  • Modify user

  • Get user

  • Modify user

  • Modify account info


Sidebar: Export & share renamed to Export & link

The former Export & share tab in the sidebar is now renamed to Export & link. The new title is more descriptive of the actions you can complete in this tab.


API: v4 deprecation notice

With this release, we are announcing the deprecation of the following endpoints at the end of November, 2020.

These endpoints have equivalents in the v5 API:

  • Change password (PUT /api/v4/user/password/)

  • Modify user (self) (PUT /api/v4/user/profile/)

  • Modify account info (PUT /api/v4/accounts/<account>/)

These endpoints are not replicated in the v5 API:

  • Get user (GET /api/v4/accounts/<account>/users/<path:email>/profile/)

  • Modify user (PUT /api/v4/accounts/<account>/users/<path:email>/profile/)

After conducting an internal audit, Luminoso saw that these endpoints were unused for the past 180 days. Another deprecation notice will be provided before the deprecation.




Daylight | Cloud | 2020-10-10


Enhancements

  • API: New v5 endpoints now available for profile, user, organizations, and workspaces functionality

  • API: Use a password to retrieve a new API token through the API

  • API: v4 deprecation notice

  • List tokens (GET /api/v4/user/tokens/)

  • Delete token (DELETE /api/v4/user/tokens/<token>/)

  • Create token (POST /api/v4/user/tokens/)

  • Get token (GET /api/v4/user/tokens/<token>/)


Fixes

  • Project management: Added scroll bar to Configure visualization tab


API: v5 endpoints now available for profile, user, organizations, and workspaces functionality

With this release, all endpoints related to the profile, user, workspaces, and organizations are available to users in the v5 API. Previously, this functionality was available in the v4 API. Now, you can do all of your user, workspace, and organization management through the v5 API. We recommend that you access this functionality through the v5 API as we transition towards deprecating the entire v4 API.

The new endpoints are listed below. Click the link in each section to read more about each endpoint and its functionality in the API documentation:


Profile

  • Get user profile (GET /api/v5/profile/)

  • Modify user profile (PUT /api/v5/profile/)

  • Change password (PUT /api/v5/profile/password/)

Users

  • Delete users (POST /api/v5/users/delete/)

Organizations

  • Get organization info (GET /api/v5/organizations/<organization_id>/)

  • Get usage for an organization (GET /api/v5/organizations/<organization_id>/usage/)

  • Update organization details (PUT /api/v5/organizations/<organization_id>/)

  • Edit users’ roles in organization (PUT /api/v5/organizations/<organization_id>/users/)

Workspaces

  • Create workspace (POST /api/v5/workspaces/)

  • Get workspace info (GET /api/v5/workspaces/<workspace_id>/)

  • Delete workspace (DELETE /api/v5/workspaces/<workspace_id>/)

  • Update workspace details (PUT /api/v5/workspaces/<workspace_id>/)

  • Remove users from a workspace (POST /api/v5/workspaces/<workspace_id>/users/remove/)

  • Edit users’ roles in workspace (PUT /api/v5/workspaces/<workspace_id>/users/)


API: Use a password to retrieve a new API token through the API client

With the newly-released version 2.1.0 of the Luminoso API Client, you can obtain and save a long-lived token directly through the client. Previously, you could only do this through the Settings page in the UI.

With this release, we introduce a new command-line tool, lumi-save-token, with the same behavior as the existing interactive client method LuminosoClient.save_token(). Using either method, you can specify and save a token that you obtained through the UI. If instead you do not specify a token to save, you will be prompted for your username and password, and the API client will obtain and save a long-lived token for you. The token is persistent, and you don’t need to update it.


API: v4 deprecation notice

With this release, we begin the deprecation of the following v4 API endpoints:

  • List tokens (GET /api/v4/user/tokens/)

  • Delete token (DELETE /api/v4/user/tokens/<token>/)

  • Create token (POST /api/v4/user/tokens/)

  • Get token (GET /api/v4/user/tokens/<token>/)

These endpoints continue to be available until December 2020, when they will be deleted. For all token management needs, we recommend using the password method described in the previous section or the Settings page in the UI.


Project management: Added scroll bar to Configure visualization tab

If a user’s window was too small to view all information in the Configure visualization tab, there was no scrolling option to allow the user to access the options that were cut off. Now, the tab includes a scroll bar.

How helpful was this article?

Thank you for your feedback!